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
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.
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
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
- In the enterprise application, open Provisioning and create a provisioning configuration.
- Enable SCIM in Mistral, then copy its SCIM URL and bearer token.
- In Entra, set Tenant URL to the SCIM URL shown in Mistral.
- Set Secret Token to the bearer token generated by Mistral.
- Check the attribute mappings described below, configure accidental deletion prevention, and save the configuration.
- 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 the mappings for:
userName: must be the user's email address.- Primary email: the first
emailsentry markedprimary: trueis used; otherwise Mistral usesuserName. name.givenNameandname.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
In the application's Provisioning settings:
- Turn on Prevent accidental deletions.
- Set a threshold appropriate for your Organization.
- 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.
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
- In Entra, use Provision on demand to send a test user.
- If you provision groups, send a test group and its members too.
- Check Entra's Provisioning logs for errors.
- In Mistral, open Admin > Members and check the user's email, first name, and last name. SCIM-managed users show the Externally managed badge.
- Open Admin > Groups and check the group's name and membership.
- Configure the group's permissions and Workspace access in Mistral.
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.