Skip to main content

Syncing Microsoft Entra user attributes to Omni with SCIM

Custom user attributes can be synced from Microsoft Entra (formerly Active Directory / Azure AD) to Omni, allowing you to fully centralize your user management in Microsoft Entra.

In this guide, we'll demonstrate how to sync a user attribute named blob_entity from Microsoft Entra to Omni.

Requirements

To follow the steps in this guide, you'll need:

  • To set up SCIM provisioning with Entra. Refer to the Omni setup guide for more information.
  • Organization Admin permissions in Omni
  • Permissions in Microsoft Entra that allow you to:
    • Access the admin panel
    • Create user profile attributes
    • Modify applications

1. Create an Omni user attribute

In Omni, navigate to Settings > Attributes and create a new attribute.

Our example attribute, blob_entity, has the following settings:

  • Name - Blob Entity
  • Reference - blob_entity
  • Type - string

2. Create an Entra user attribute

  1. Log in to your Entra admin panel.
  2. Navigate to Entra ID > Enterprise apps.
  3. Click the Omni application.
  4. In the side navigation, click Provisioning under the Manage heading.
  5. Open the Mappings section.
  6. In this section, select the user you want to add an attribute to.
  7. At the bottom of the page, select Show advanced options.
  8. Select Edit attribute list for customappsso.
  9. Enter the following for the attribute:
    • Name - Enter the reference of the attribute you created in Omni in step 1, prefixed with the following:
      urn:omni:params:1.0:UserAttribute:
      For example, for the blob_entity attribute, you'd urn:omni:params:1.0:UserAttribute:blob_entity.
    • Type - Select the type of the attribute you created in Omni: string or integer
    • Multi-value? - Select this option if the Omni attribute is configured to support multiple values.
  10. Configure the remaining fields as needed.
  11. Save the changes.

3. Create attribute mapping

  1. A message should display after you click Save - click Yes.
  2. In the Attribute Mapping page that opens, click Add New Mapping.
  3. In the Target attribute dropdown, select the attribute you created in step 2.
  4. Configure the remaining fields to map the appropriate value to the attribute.
  5. Click OK, then Save.

What's next?

The Omni application should be set to automatically provision users and groups - see the Entra SCIM guide - meaning that the next time the app syncs, the attributes should be created as user attributes in Omni.