Skip to main content

HelloID

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 t4edemo.com mapping set.

    2022-10-05_9-36-18.jpg
  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.

    2022-10-06_11-43-50.jpg
    2022-10-06_11-44-53.jpg
  4. Choose one of the following:

    1. To edit an existing attribute, click Edit.

      2022-10-06_11-51-40.jpg
    2. To add a new attribute, click Add Attribute.

      2022-10-06_11-52-18.jpg

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

      2022-10-06_11-55-32.jpg
    3. Click Add Attribute to confirm.

      The new attribute is added to the claim set.

      2022-10-06_11-56-07.jpg
    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.

    Required

     

  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.

    2022-10-06_11-57-43.jpg

    Tip

    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.

      2022-10-06_12-05-31.jpg
    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.

      2022-10-06_12-13-47.jpg

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

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

      2022-10-06_12-15-39.jpg
      2022-10-06_12-16-38.jpg
    3. Click Close.

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

    2022-10-06_12-20-54.jpg
  7. Click Save.

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