SCIM Provisioning
Last updated on November 20, 2026
SCIM provisioning pushes member changes from your identity provider to TofuPilot: add a user to a linked group in Okta and they get a TofuPilot account, remove them and their access is revoked.
SCIM is available on the Enterprise plan and runs on top of SSO: SSO handles authentication, SCIM handles lifecycle. SSO works without SCIM, but SCIM requires SSO. Configuring SCIM requires the Owner role.
What SCIM syncs
| Event in your directory | Effect in TofuPilot |
|---|---|
| User created in linked group | New member, with the Viewer role and the access for new members |
| User removed from group | Member removed from organization |
| User attributes updated (name, email) | Profile updated, for accounts created by SCIM only (existing accounts keep their own profile) |
| User suspended | Member removed from the organization (owners excepted), re-added as Viewer with the access for new members on reactivation |
SCIM creates every new member with the Viewer role. Change roles in Settings > Members afterwards. Existing TofuPilot accounts must be invited to the organization first, and they keep their current role.
Configure SCIM
Set up SSO first.
Open Settings > SCIM.
Click Configure SCIM and copy the SCIM base URL and bearer token.
In your identity provider, create a SCIM 2.0 provisioning connection for TofuPilot, then paste the base URL and bearer token.
Enable provisioning in your identity provider.
The first sync runs immediately, and subsequent syncs are incremental.
Verify the sync
Add a test user to the provisioned group: the user appears in Settings > Members within a minute with the Viewer role. Remove the test user from the group: their membership is removed within a minute.
Rotate the SCIM token
Open Settings > SCIM.
Click Edit on the SCIM Provider, then Regenerate Token.
Paste the new token into your identity provider's SCIM connection.
The old token is revoked as soon as the new one is generated.
Limitations
SCIM controls organization membership, but it does not control roles or access group membership. A new member gets the organization's access for new members, which is no access by default. For other access group assignments, use the access groups UI or the API.
The Owner role cannot be assigned via SCIM. To change the Owner, contact support@tofupilot.com.
How is this guide?
Single Sign-On
Learn how to authenticate every TofuPilot member through your identity provider with SAML 2.0 or OIDC, so credentials never live on TofuPilot.
Passkeys and MFA
Learn how to sign in to TofuPilot with a passkey on every plan, and how your identity provider's MFA applies to SSO sign-ins on Enterprise.