• HelloID-Conn-Prov-Target-Paxton-Net2
  • Table of contents
  • Introduction
  • Getting started
    • Provisioning PowerShell V2 connector
      • Correlation configuration
    • Connection settings
    • Prerequisites
    • Remarks
  • Getting help
  • HelloID docs

HelloID-Conn-Prov-Target-Paxton-Net2 is a target connector. Paxton-Net2 provides a set of REST API's that allow you to programmatically interact with its data.

The following lifecycle actions are available:

The correlation configuration is used to specify which properties will be used to match an existing account within Paxton-Net2 to a person in HelloID.

To properly setup the correlation:

1. Open the Correlation tab.

2. Specify the following configuration:

   Setting	Value
   Enable correlation	True
   Person correlation field	Person.ExternalId
   Account correlation field	PersonnelNumber.Value

ℹ️ For more information on correlation, please refer to our correlation documentation pages.

The following settings are required to connect to the API.

• The client ID can be found in the license file.
• The 'Department' field in the field mapping is mandatory. If it is not filled correctly, it will result in errors in the account cycle scripts.
  • The Department ID cannot be found in the UI. However, the list of departments is ordered, and the ID follows this order as well, starting with 0 for the None department. So, the first department in the list will be assigned an ID of 1, and so on. The order may vary if Net2 departments have been deleted in the past. To ensure accuracy, you could perform an API call to retrieve all the departments. {{BaseURL}}/api/v1/departments
• The connector uses a CSV file to handle the department mapping.
• The connector relies on the CSV headers. So normally, these cannot be changed without code adjustments.
• The API utilizes custom fields to populate specific data in Net2. The connector is designed to only populate the email and personnel number fields. Each custom field has a corresponding ID, which can be located in the Net2 UI under 'Options' and then 'Field Names'. By default, the IDs for email and personnel numbers are 9 and 14, respectively.
• If you want to populate more custom fields in net2 via this connector, be aware that changes to the code are also necessary. Because it is not necessary to use these other fields there isn't a generic solution for this.
• The connector is based on Net2 Pro. The main difference between Pro and Lite is that the Pro version handles multiple authorizations, whereas the Lite version only supports one authorization. While the connector can be tested on a Lite version, it may not fully integrate with HelloId. This is because you cannot enforce that only one entitlement is granted with the business rules. There is a commented-out code snippet in the grant script, which can be used for this purpose.
• The disable script in the connector assigns the user to the 'uitdienst' department.
• If the user is disabled and therefore assigned to the department 'uitdienst,' and then later gets enabled, the user is removed from the 'uitdienst' department. The correct user will then be assigned to the correct department when the update script runs.

ℹ️ For more information on how to configure a HelloID PowerShell connector, please refer to our documentation pages.

ℹ️ If you need help, feel free to ask questions on our forum.

The official HelloID documentation can be found at: https://docs.helloid.com/