SCIM Provisioning with Microsoft Entra ID

The short version

After this setup, assigning a person to the Delivr app in Microsoft Entra ID gives them Delivr access, and unassigning them removes it. You need the SCIM URL and token from Delivr. See SCIM Provisioning for how to get them and for the prerequisites.

When you choose Microsoft Entra ID as the identity provider, the SCIM URL ends with ?aadOptscim062020. Paste the whole URL. This flag makes Microsoft Entra ID send SCIM-compliant update requests. Microsoft states that the flag does not work with Provision on-demand.

Steps in Microsoft Entra ID

  1. Sign in to the Microsoft Entra admin center as at least an Application Administrator.
  2. Open Entra ID > Enterprise apps. Open the app that you use for Delivr sign-in. To make a new app, select New application > Create your own application. Choose the option to integrate any other application, then select Add.
  3. Open Provisioning in the left panel. Select New configuration.
  4. In Tenant URL, paste the SCIM URL from Delivr, including ?aadOptscim062020.
  5. In Secret Token, paste the Delivr token.
  6. Select Test Connection. If it fails, check the URL and the token.
  7. Select Create.

Check the attribute mapping

Delivr finds a person by the email address, and it looks a person up by userName. Set userName to the person's email address. Microsoft Entra ID usually maps userPrincipalName to userName. If a person's user principal name is not their email address, map mail to userName instead.

  1. Open Attribute mapping in the left panel and select the user mapping.
  2. Select the pencil icon on the userName row. Set the source attribute to mail.
  3. Save the mapping.

Every person in scope needs a value for mail, because Microsoft Entra ID matches people on the mapped attribute.

Only addresses in your verified domain are provisioned.

Assign people and groups

  1. Open Users and groups. Assign the people or groups that need Delivr.
  2. If you use group rules in Delivr, keep the group mapping enabled in Attribute mapping.
  3. Open Overview and select Start provisioning.

Microsoft Entra ID provisions only the people and groups that you assign, when the scope is Sync only assigned users and groups. To test with one person, assign only that person and wait for a sync. Provision on-demand does not apply the aadOptscim062020 flag.

Check the result

Microsoft Entra ID syncs about every 40 minutes. In Delivr, open Settings > Security, then Manage provisioning. Check that Last used has a time and that the people show as Active.

Troubleshooting

  • No one gets access: the panel needs at least one rule. See Choose who gets access.
  • A person shows Ignored, outside the domain: their email address is not in the verified domain of the SSO connection. Check the userName mapping.
  • Test Connection fails with an authorization error: the token is wrong or replaced. Select Replace token in Delivr and paste the new one in Secret Token.

Vendor documentation


Did this page help you?