GitHubContribute in GitHub: Open doc issue|Edit online

Active Directory Change Detection Connector

You can know more about Active Directory Change Detection Connector through the information provided here.

The migration from the AD Changelog EventHandler to the Active Directory Change Detection Connector is straight forward in the most aspects since the EventHandler itself has incorporated the older version this connector - Active Directory Changelog Connector in order to obtain changes from the AD.

Similar to the EventHandler the corresponding Connector can also be interrupted any time during the synchronization process, in that case it will store its state in the User Property Store. Both the EventHandler and the Connector rely on the uSNChanged mechanism in this process, by storing the USN number in the property store. They also offer sn API for retrieving the current USN synchronization values. The difference is that the EventHandler getUSNvalues method returns an Entry with Attributes:

START_USN
END_USN 
CURRENT_USN_CREATED 
CURRENT_USN_CHANGEDT

whereas the Connector returns the current synchronization value as long.

Another difference is that the AD EventHandler initializes internally an LDAP Connector in order to block and receive change notifications. This behavior can also be simulated in the ADCD Connector by enabling the useNotifications parameter.

The following steps should be performed in order to migrate from an EventHandler-based solution to Connector-based one:

  1. 1. Create a new AssemblyLine with an instance of an Active Directory Change Detection Connector in Iterator mode.
  2. Set the ldapUrl, ldapUsername, ldapPassword and ldapAuthenticationMethod to the values these connection parameters have in the EventHandler configuration.
  3. Specify whether SSL connection is used according to the value in the old configuration.
  4. Copy the content of the ldapSearchBase EH parameter to the same in the Connector configuration
  5. Copy the content of the persistentParameterName EH parameter to the persistentStateKey Connector parameter.
  6. Set the parameter useNotifications to true.
  7. Set the startAt parameter according to the value in EH.
  8. Leave the other Connector parameters as they are.
  9. Transfer any logic in the Action Map section of the EventHandler to be invoked from the new AL.