SCIM provisioning
Before you begin
Section titled “Before you begin”- Plan: Enterprise. Organizations only.
- Role: Super admin.
Create a SCIM token
Section titled “Create a SCIM token”- Go to Devices & Access › Single sign-on › Provisioning (SCIM).
- Choose Create SCIM token, enter a name and Expires after (days) (at most 365).
- Copy the Tenant URL and the token from Copy your SCIM token. The token is shown once.
Microsoft Entra ID
Section titled “Microsoft Entra ID”- Enterprise applications › New application › Create your own application (non-gallery).
- Provisioning › Automatic. Tenant URL is the SCIM base URL. Secret token is the SCIM token.
- Test connection.
- Under Mappings, keep
userPrincipalName → userName,mail → emails[type eq "work"].value,objectId → externalId, andSwitch([IsSoftDeleted]…) → active. Turn on group provisioning. - Assign users and groups, then Start provisioning.
- Applications › Create App Integration, an OIDC or SAML app for sign-in. Under General, enable SCIM provisioning.
- Provisioning › Integration: SCIM connector base URL is the SCIM base URL. Unique identifier field is
userName. Actions: Push New Users, Push Profile Updates, Push Groups. Authentication Mode is HTTP Header, withBearer <SCIM token>. - Provisioning › To App: enable Create, Update and Deactivate Users.
- Push the groups you map to roles.
Map groups to roles
Section titled “Map groups to roles”Under Group-to-role mappings, use the SCIM group’s display name. SCIM can grant at most Admin. Grant Super admin under Users.
Only provisioned people refuses sign-in to anyone your IdP hasn’t provisioned.
How it behaves
Section titled “How it behaves”- People are linked at their first sign-in when their verified email matches.
- Deactivating someone in the IdP signs them out at once and stops their API tokens.
- SCIM never removes the last active Super admin.
Rotate the token
Section titled “Rotate the token”Create a new token, paste it into the IdP, check that provisioning runs, then Revoke the old one.