Skip to main content


Customize an Active Directory mapping set

For more information, see Active Directory mapping set.

  1. Go to Directory > Mapping Sets.

  2. For the relevant AD mapping set, click Edit.

    For this example, we'll edit our mapping set.

  3. Click Change Attributes for Active Directory User to go to the Change Attributes (AD mapping) screen, where you define the attributes that HelloID will pull out of the AD user schema.

  4. Choose one of the following:

    1. To edit an existing attribute, click Edit.

    2. To add a new attribute, click Add Attribute.


      For this example, we'll add a Mobilephone attribute.

    3. Click Add Attribute to confirm.

      The new attribute is added to the claim set.

    4. Click Close.

    Display Name

    Not used.

    Variable Name

    The intermediary name of the attribute, which will be shown in the User column of the Change Mappings screen, in the next step. Typically should be the same as the Source Field.

    Source Field

    The name of the attribute to pull from the AD user or group schema.

    Data Type

    The data type of the attribute.



  5. Click Change Mappings for Active Directory User to go to the Change Mappings (AD mapping) screen.

    In the User column, you specify attributes pulled from AD, using their Variable Name. In the HelloID User column, you specify which attribute in the HelloID user schema to map the AD attribute on to.



    In autocomplete, you have access to attributes defined on the Change Attributes (AD mapping) screen, as well as Custom variables.

    1. To remap an existing mapping, delete the text in the User field, and then type {{ to activate autocomplete. Select the new mapping.

    2. To add a new mapping, click Add Mapping. Select an attribute in the HelloID User column, and then type {{ in the User field to activate autocomplete.


      For this example, we'll select the user.attributes.[new-entry] option, and change it to This will create a new custom attribute in the HelloID user schema (see Custom user attributes).

      Then we'll map the {{}} attribute onto it (where mobile is the Variable Name we defined on the Change Attributes screen).

    3. Click Close.

  6. Repeat steps (3) - (5) for Active Directory Group, to specify how AD groups will be mapped onto HelloID Groups.

  7. Click Save.

The mapping set has been saved, and will now be used for the associated AD configuration.