Skip to main content
SCIM 2.0 lets your identity provider manage who belongs to the workspace and which teams they are on. The payoff is lifecycle control: deprovisioning a user in your IdP instantly revokes their access across every agent and every connected account. SCIM is available on the Enterprise plan. Passport implements the SCIM 2.0 Users and Groups subset that Okta and Microsoft Entra drive in practice (walkthroughs below). Other IdPs that speak the same subset, including Google Workspace SCIM agents, may work, but Passport does not ship a Google-specific setup guide or Google-only extensions.

​
Endpoint and token

The SCIM base URL for your workspace is:
SCIM is off until you generate a bearer token. In Passport, open Settings and generate a SCIM token. The token is shown once, so copy it immediately. Point your IdP at the base URL above and authenticate with that token as an OAuth bearer token.
Generating the token requires the Enterprise plan. The token is stored as a one-way hash, so it cannot be recovered later. Generate a new one to rotate; delete it to turn SCIM off.

​
What Passport implements

Passport implements the subset of SCIM that Okta and Entra actually drive:
  • Users: list (with userName eq filter), get, create, replace, patch, and delete.
  • Groups: list, get, create, and patch membership. Groups map to Passport teams.
The ServiceProviderConfig advertises: patch supported, filter supported (max 200 results), and bulk, sort, and etag not supported. Group members removed from a group fall back to the “Unassigned” team.

​
Deprovisioning behavior

This is the important part. When your IdP deactivates or deletes a user (most send active: false, some send DELETE), Passport does a full deprovision:

Signed out everywhere

All sessions, agent connections, and devices are cut immediately.

Grants revoked

Connected-account grants are dropped, so nothing sits at rest or re-arms on reactivation.
Reactivating a user restores their access; they reconnect their own accounts.
Passport refuses to deprovision the last active admin, to avoid locking the workspace out of all administration. That request returns a SCIM 409 with “Cannot deprovision the last active admin. Assign another admin in your IdP first, then retry.” Assign a different admin first, then retry.
SCIM runs on Enterprise, which has no seat limit. If the workspace leaves Enterprise, every SCIM request returns a SCIM 403 so your IdP records the failure, and nobody is provisioned or deprovisioned until Enterprise is restored.

​
Okta provisioning

1

Enable provisioning

In your Okta app integration, open the Provisioning tab and configure the SCIM connection.
2

Set the base URL and token

SCIM connector base URL: https://<your-passport-host>/scim/v2. Authentication mode: HTTP Header (OAuth Bearer Token) with the token you generated in Passport.
3

Enable the actions

Turn on Create Users, Update User Attributes, and Deactivate Users. Push groups to map Okta groups to Passport teams.

​
Microsoft Entra provisioning

1

Add provisioning

In your Entra enterprise application, open Provisioning and set the mode to Automatic.
2

Set the tenant URL and secret token

Tenant URL: https://<your-passport-host>/scim/v2. Secret token: the token you generated in Passport. Test the connection.
3

Assign and start

Assign users and groups to the application and start provisioning.
Passport correctly handles Entra’s non-gallery SCIM agent, which sends booleans as the strings “True” and “False”. A deprovision from Entra is applied as a real deactivation, not a silent no-op.