SCIM provisioning

SCIM (System for Cross-domain Identity Management) stands as a robust protocol designed to streamline the synchronisation of users and groups between two systems.

This article is tailored for organisations grappling with the challenges of managing a sizable workforce and aiming to minimise manual efforts during the implementation of new software. Specifically, for those seeking to ease the administration of the UMA solution for companies with numerous users, we advocate for the adoption of automatic user (de-) provisioning through SCIM.

Essentially, SCIM empowers you to maintain synchronisation between your users in UMA and their associated data.

Key Advantages of SCIM Implementation

  1. Automatic User Provisioning: Initiate user provisioning directly from your active directory.

  2. Real-time User Data Updates: Ensure instant updates of user data in alignment with the active directory (e.g., changes in internal departments).

  3. Automatic User Deprovisioning: Streamline the process of deprovisioning users who exit your company.

How It operates

SCIM comprises of two integral components: a provider and a client. UMA serves as the SCIM client.

Once provisioning is active between Microsoft Entra ID and UMA, the SCIM provider queries UMA for users earmarked for provisioning.

  • If a user is absent, UMA generates the corresponding resource.

  • If a user exists but varies in certain aspects, it undergoes an update.

Required permissions

Due to the push-principle inherent in SCIM, UMA never requires direct retrieval of information from Microsoft Entra ID. Consequently, no permissions are needed, solidifying the secure and efficient nature of the SCIM protocol.

For more information on Microsoft Entra ID SCIM, check out this guide from Microsoft below:


  1. Log into UMA, navigate to the integrations page and click to activate SCIM provisioning.

  1. Copy the tenant URL and token and save for later.

  2. Log into Microsoft Entra ID and create a new enterprise application.

  3. Navigate to provisioning and select automatic. Enter the tenant URL and token and test the connection.

  4. Click on mappings and disable Microsoft Entra ID Groups.

  5. Click on Microsoft Entra ID Users. As a minimum, UMA requires the below:

UMA AttributeMicrosoft Entra ID Attribute




Switch([IsSoftDeleted], , "False", "True", "True", "False")





Please ensure to change Microsoft Entra's attribute for externalId to objectId

  1. Click manage, select users and groups and add the users and groups you want to provision with UMA.

  2. Click on provisioning and click on the start provisioning button.

The initial Microsoft Entra ID sync is triggered immediately after you enable provisioning. Subsequent syncs are triggered every 20-40 minutes, depending on the number of users and groups in the application. See Provisioning summary report in the Microsoft Entra ID documentation.

Additional information

  • Once SCIM provisioning is activated, user accounts added manually to UMA operate independently from those added through SCIM. To synchronise manually added users with SCIM, you must subsequently include these users in your SCIM application.

  • Please note that users provisioned through SCIM cannot be edited or deleted through UMA. You are only able to update their permissions.

  • When a user is removed from the SCIM application in Entra ID, they are automatically marked as inactive in UMA.

  • When a user is de-activated in Microsoft Entra ID, they are automatically marked as inactive in UMA.

  • When a user is deleted from Microsoft Entra ID, they will be removed from UMA.

Last updated