Set up SCIM with Microsoft Entra ID

Use Microsoft Entra ID to provision users and groups into Mistral through SCIM. Entra manages their lifecycle and group membership; Mistral manages the permissions and Workspace access that groups grant.

Before you start

Before you start

Complete the SCIM prerequisites: verify your domains, configure SAML SSO, and require SSO for the domains you intend to provision. You also need access to your enterprise application's provisioning settings in Entra.

Warning

Enabling SCIM changes how new users join

Once SCIM is enabled in Mistral, new SSO users must be provisioned before they can join your Organization. Prepare the Entra configuration and assign users first, then enable SCIM in Mistral and start provisioning immediately. Existing members keep their access and role.

Find your enterprise application

Find your enterprise application

In the Microsoft Entra admin center, open Enterprise applications and select the application used for your Mistral SSO connection. If you have not configured it yet, follow the SAML SSO guide first.

Assign the users and groups who need access to Mistral to the application. Decide whether to provision users only or both users and groups.

Configure provisioning

Configure provisioning

  1. In the enterprise application, open Provisioning and create a provisioning configuration.
  2. Enable SCIM in Mistral, then copy its SCIM URL and bearer token.
  3. In Entra, set Tenant URL to the SCIM URL shown in Mistral.
  4. Set Secret Token to the bearer token generated by Mistral.
  5. Check the attribute mappings described below, configure accidental deletion prevention, and save the configuration.
  6. Start provisioning.

If you no longer have the bearer token, rotate it in Mistral on Admin > Access, next to SCIM bearer token, and enter the new token in Entra. Rotation invalidates the previous token immediately.

Check attribute mappings

Check attribute mappings

Check the mappings for:

  • userName: must be the user's email address.
  • Primary email: the first emails entry marked primary: true is used; otherwise Mistral uses userName.
  • name.givenName and name.familyName: the user's first and last name.
  • active: whether the user is enabled.

Keep Entra's default active mapping based on IsSoftDeleted. Without it, Entra does not tell Mistral when a user is unassigned or disabled, so the user keeps their access. A new user sent without active is treated as active; an update without active leaves their status unchanged.

If you provision groups, also review displayName and members. For the full mapping, see SCIM attributes.

Prevent accidental deactivations and deletions

Prevent accidental deactivations and deletions

In the application's Provisioning settings:

  1. Turn on Prevent accidental deletions.
  2. Set a threshold appropriate for your Organization.
  3. Add a notification email.

Entra counts disabled users as well as deleted users. If a provisioning cycle exceeds the threshold, it holds the changes until you approve them.

Warning

Deactivation affects every Organization

We recommend enabling this safeguard because setting a user to active: false ends their access to every Mistral Organization they belong to and deletes their API keys. Reactivation restores their access, but not their API keys. See the user lifecycle before approving a large deprovisioning cycle.

Test and verify provisioning

Test and verify provisioning

  1. In Entra, use Provision on demand to send a test user.
  2. If you provision groups, send a test group and its members too.
  3. Check Entra's Provisioning logs for errors.
  4. In Mistral, open Admin > Members and check the user's email, first name, and last name. SCIM-managed users show the Externally managed badge.
  5. Open Admin > Groups and check the group's name and membership.
  6. Configure the group's permissions and Workspace access in Mistral.
Note

Changes are asynchronous

Provision on demand makes Entra send a change right away, but Mistral applies it asynchronously. If Entra's provisioning logs show success, Mistral has received the change; you do not need to provision it again. If it remains missing after some time, follow the SCIM troubleshooting steps.

Groups in Mistral only show members who are provisioned. Members who have not been provisioned yet are left out, even if Entra still lists them, and are added once provisioned. Deactivated members keep their group memberships.

Next steps

Next steps