Skip to content
  • There are no suggestions because the search field is empty.

How to Configure Attribute Mapping Manually for Microsoft Entra ID User Provisioning (SCIM)

This article explains how to manually configure the SCIM attribute mapping between Microsoft Entra ID (former Azure AD) and AskCody, as an alternative to the automatic method.

When you set up automatic user management with Microsoft Entra ID (former Azure AD), you need to map the attributes that hold user and group data in Entra ID to the matching user attributes in AskCody. This makes sure that user and group information is created and updated correctly in AskCody.

There are two ways to configure this mapping, and you only need to use one of them: automatically, by pasting a ready-made schema (recommended for most organizations), or manually, by editing each attribute yourself. This article covers the manual method.

Note: Use this article only if you are configuring the attribute mapping manually. If you would rather use the faster automatic method, follow the Configure Attribute Mapping section in the main guide instead: Set Up a SCIM-based Automatic User Management and Synchronization with Microsoft Entra ID. Do not run both methods, as that leads to duplicated or conflicting configuration.

This article picks up from the Attribute mapping page of your Enterprise Application in Entra ID. If you have not created and connected the Enterprise Application yet, start with the main setup guide and return here when you reach the attribute mapping step.

How editing works in the new attribute mapping experience

  • Each mapping row has a pencil icon to edit it and a trash icon to delete it.
  • In the edit panel, Match objects using this attribute is a checkbox. Checked means Yes.
  • Click on Apply (when editing) or Add (when adding) at the bottom of the panel to keep your change.
  • Your changes are not stored in Entra ID until you click on Save at the bottom of the Attribute mapping page.
Configure attribute mapping manually

Set up mapping for groups

1. On the Attribute mapping page, click on the Groups tab:

02-attribute-mapping-groups-tab


2. Click on the pencil icon on the row with objectId as the source attribute and externalId as the target attribute:

06-groups-edit-objectid

3. Check the Match objects using this attributebox, and set Matching precedence to 2. Click on Apply:

08-edit-attribute-mapping-panel

4. Click on the pencil icon on the displayName row:

07-groups-edit-displayname

5. Uncheck the Match objects using this attribute box and click on Apply.

6. Click on the pencil icon on the objectId row again. Set Matching precedence to 1 and click on Apply.

7. Click on Save at the bottom of the page:

12-attribute-mapping-save

Your group mapping should now look like this:

14-groups-final-mapping

Set up mapping for users

1. Click on the Users tab at the top of the Attribute mapping page:

03-attribute-mapping-users-tab

2. Entra ID adds several attributes by default. Click on the trash icon to delete all of them, except for:

  • mail

  • userPrincipalName

  • givenName

  • surname

3. Click on Add attribute mapping in the toolbar at the top:

10-add-attribute-mapping-button

4. In the Add Attribute Mapping panel, make sure the Users tab is selected, then:

    1. In Source attribute (Microsoft Entra ID), select objectId.

    2. In Target attribute (customappsso), select externalId.

    3. Check the Match objects using this attribute box.

    4. In Matching precedence, make sure there is a value. If it is empty, type 2.

    5. Click on Add at the bottom.

11-add-attribute-mapping-panel

5. Click on the pencil icon on the userName row. Uncheck the Match objects using this attributebox and click on Apply.

6. Click on the pencil icon on the externalId row. Set Matching precedence to 1 and click on Apply.

7. To update users that were created manually in AskCody before you enabled the sync, add mail as a second match. Click on the pencil icon on the mail row, check the Match objects using this attribute box, and make sure Matching precedence is 2. Click on Apply.

8. To sync whether a user account is enabled or disabled in Entra ID, click on Add attribute mapping again. Set Source attribute to accountEnabled and Target attribute to active. Leave the rest as default and click on Add.

9. Click on Save at the bottom of the page.

Your user mapping should now look like this. The order of the rows does not matter, as long as the rows and settings are the same:

13-users-final-mapping

 

Optional: Sync Cost Centers from Entra ID to AskCody

If your organization stores cost center information in Microsoft Entra ID (for example in an extension attribute), you can sync it into AskCody through SCIM. Add a user attribute mapping from your Entra ID extension attribute to:

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter

This ensures employees are automatically linked to the correct cost centers in AskCody and see a read-only cost center when placing service requests.

Follow the steps here: Sync Cost Centers from Microsoft Entra ID to AskCody (SCIM)

Next step: Your manual attribute mapping is complete. Return to the main guide and continue with the Adding Groups step to finish setting up your Entra ID integration.