Welcome
Guest
FAQ Forum Developers Sign In

Customizing the Provisioning attribute mappings

Last updated:

To customize the Provisioning attribute mappings that will be used by the Provisioning Agent when synchronizing the Provisioning entries with Circuit, perform the following steps:

Prerequisites:
  • Connect to the targeted system (i.e. computer where the Provisioning Agent is installed) to access the Provisioning Agent interface.

  • Stop the Provisioning Agent before modifying any attribute mappings.

  1. Navigate to the directory where the Provisioning Agent has been installed and find the mapping.properties file.
  2. Open the mapping.properties file and modify the existing entries by adding the corresponding Provisioning attribute(s).

    The following entries are provided:

    circuit.directoryUserId=

    circuit.firstName=

    circuit.lastName=

    circuit.company=

    circuit.department=

    circuit.jobTitle=

    circuit.locale=

    circuit.emailAddress=

    circuit.emailSecondaryAddress=

    circuit.workPhoneNumber=

    circuit.workSecondaryPhoneNumber=

    circuit.mobilePhoneNumber=

    circuit.countryCode=

    Note:

    If the provisioning source is a CSV file, there are no default values.

    For example, to set the job title (i.e. circuit.jobTitle) to be synchronized with the attribute called position, modify the particular line as follows:

    circuit.jobTitle=position

    Note:

    In case you have not modified the mapping.properties file, the following fields will get the default values: directoryUserId, firstName, lastName and email. These default values depend on the provisioning source variant that is being used, i.e.

    - for LDAP Active Directory the default mapping will be:

    circuit.directoryUserId=objectGUID

    circuit.firstName=givenName

    circuit.lastName=sn

    circuit.email=mail

    - for LDAP ApacheDS the default mapping will be:

    circuit.directoryUserId=entryUUID

    circuit.firstName=givenName

    circuit.lastName=sn

    circuit.email=mail

    - for LDAP DirX the default mapping will be:

    circuit.directoryUserId=single-sign-on

    circuit.firstName=givenName

    circuit.lastName=sn

    circuit.email=rfc822Mailbox

     

    So, for example if an LDAP Active Directory server is used, the directoryUserId will be mapped to the objectGUID attribute. You can still override this default mapping by providing different attribute field (e.g. internalIdentifier): circuit.directoryUserId=internalIdentifier

  3. Once modifications are completed, save the mapping.properties file and start the Provisioning Agent.
    Note:

    It is not mandatory to change any of the default attribute mappings. However, all Circuit users created or modified after the update of the attribute mappings, shall inherit latest provided values of the corresponding attributes. For more information see “On-demand Provisioning Synchronization”.

0 people found this useful.
Me too / Not at all