Skip to main content

Microsoft SCIM: Add User Attribute Mappings

Dianmarie
  • Updated

How to add additional user attribute mappings with SCIM through Microsoft Azure AD, now renamed to Microsoft Entra ID.

Microsoft Azure/Entra allows users to map additional user object attributes to Lattice through custom attribute mappings. Custom attributes in Lattice can be populated with data through the Micorosft Entra ID user provisioning cycles that are regularly processed. 

Before you start

  • Ensure these attributes exist in Microsoft Entra as a part of the user object and are available to map to Lattice employee records through the custom app attribute mapping. These are defined as source attributes.
  • Ensure a custom attribute exists or has been created in Lattice of the same data type (multiple-choice, number, relationship) as the attribute you plan to map from the Microsoft Entra user object records. If that data type does not exist in Lattice, this will not be a compatible field to map to Lattice.
  • Ensure that the custom attribute that was created in Lattice has also been created as an available target attribute for the Lattice custom SCIM app attribute mapping. Learn how to create a target attribute below. 

Add custom user attribute mappings

  1. Navigate back into your custom Lattice app > go to Provisioning. 
  2. Under Provisioning, click Attribute mapping (Preview). 
  3. Click Provision Microsoft Entra ID Users. 
  4. Click Edit attribute list for customappsso. 
  5. Add a new target attribute by entering the appropriate text into the blank input text box at the bottom of the list. The variable name and external name should match the name given to the attribute in Lattice, converted to camelCase.

    • For example: If your Lattice account has a custom attribute for "Office Location", enter the field with the syntax Lattice requires for SCIM custom extension fields.

      The field will be entered as: urn:ietf:params:scim:schemas:extension:lattice:attributes:1.0:User:officeLocation

  6. Click on the dropdown next to the target attribute name to match the attribute type with the attribute type in Lattice. Ex: String matches Multiple Choice type in Lattice and Integer matches the Number type in Lattice. Screenshot 2024-02-02 at 4.56.19 PM.png
  7. Click Save. 
  8. Return to the Attribute Mapping page. 
  9. Click Add new mapping at the bottom of the table.
  10. Choose the field in Entra that will map to the Lattice app's user attribute. E.g. In the example below the source attribute physicalDeliveryOfficeName will map to the Lattice target attribute Office Location. Screenshot 2024-02-02 at 4.59.12 PM.png
  11. Once all custom target attributes for Lattice attributes have been created and mapped to Microsoft Entra attributes, click Save. 

 

Next, continue to turn on provisioning in Microsoft.

Related articles