Skip to content
Dashboard
Theme
Theme

Okta SCIM directory sync

Set up SCIM directory sync with Okta

View Markdown

Turn on SCIM provisioning for your Okta app integration, connect it with the URL and token from this setup, and choose what Okta pushes.

The values in braces, such as {scim_base_url}, are specific to your connection. The setup link from the application you are connecting shows them with a copy button. The same steps appear there.

  1. Use the SAML app integration you created for single sign-on, or create one first. Okta adds SCIM to SAML integrations created in the classic experience.

  2. On the app’s General tab, select Edit in App Settings, set Provisioning to SCIM and select Save.

  3. On the Provisioning tab, open Settings > Integration and select Edit. Paste {scim_base_url} into SCIM connector base URL and enter userName as the unique identifier field for users.

    Paste into Okta:

    • SCIM base URL: {scim_base_url}
  4. Under Supported provisioning actions, select Push New Users, Push Profile Updates and Push Groups.

  5. Set Authentication Mode to HTTP Header and paste {scim_token} into Authorization. The token is shown once in this setup; generate a new one here if you lose it.

    Paste into Okta:

    • SCIM bearer token: {scim_token}

    Fixes: scim_token_invalid

  6. Select Test Connector Configuration, then Save.

    Fixes: first_scim_request_pending

  7. Under Settings > To App, select Edit and turn on creating users, updating user attributes and deactivating users, then select Save.

    Fixes: scim_user_out_of_domain

  8. Assign the people or groups to sync on the Assignments tab. To sync groups, add them on the Push Groups tab.