OKTA

SCIM for OKTA

circle-info

The Stacksync OKTA app is currently under review by OKTA. Until the app is published on OKTA marketplace, here is a guide to synchronize your OKTA users automatically into Stacksync by creating the SCIM app yourself

This setup takes ~10min

Notes:

  • This setup needs to be implemented by an OKTA ADMIN

  • The SCIM integration is associated to a unique Stacksync workspace. If you have multiple workspaces (such as dev, stage and prod) you will need to set up an SCIM app for each of these Stacksync workspaces. Each workspace has independent RBAC enforcement.

Setup manual

  1. On your OKTA homepage go on the admin section

  2. Once you are on the admin page, go to Applications and click on Create App Integration

  3. Browse for SCIM 2.0 App with Header Authentication

  4. Add the application

  5. In the provisioning section click on Configure API Integration

  6. Go to the Workspace Settings page at https://app.stacksync.com to find the informations necessary for the next steps.

    1. Find your workspace_id on the top of the page

    1. Generate a workspace_api_key at the bottom of the page.

  7. Set up the API integrations using your Stacksync credentials:

    1. Base URL: https://api.stacksync.com /v1/workspace/<your_workspace_id>/scim/v2/

    2. API Token: Bearer <your_workspace_api_key>

  8. Now that you are connected to the Stacksync SCIM server, you can create a Group for the users that will have the role editor in Stacksync and then provision that group to the app you just created. Note that there are 2 roles you can set for you group: viewer or editor.

  9. Now you can assign users to this group

Congrats' you just automatically provisioned users to the Stacksync app!

Last updated