Skip to content

Okta

  • Managed deployment
  • Self-hosted

This guide walks you through setting up Directory Sync with Okta using SCIM provisioning.

Add a SCIM Integration in Okta

Step 1: Log in to your Okta account using your administrator credentials. From the left-hand navigation menu, click Applications, then select Browse App Catalog.

step-1-browse-app-catalog

Step 2: In the search bar, type SCIM 2.0 Test App (OAuth Bearer Token), and select the app called SCIM 2.0 Test App (OAuth Bearer Token) from the search results.

step-2-search-scim-app

Step 3: On the app's details page, click Add Integration.

step-3-add-integration

Step 4: Enter a name for your application, such as "Qualytics Directory Sync."

step-4-application-name

Step 5: Click on the Next button.

step-5-next-button

Configuring SCIM Endpoints

Step 1: In the newly created app, go to the Provisioning tab and click Configure API Integration.

step-6-configure-api

Step 2: Check the box labeled Enable API Integration, and enter the following details:

  • SCIM 2.0 Base URL: https://<your-Qualytics-domain>/api/scim/v2

  • OAuth Bearer Token: Use the restricted Service Token described in the Directory Sync requirements.

step-7-enable-api

Step 3: Click Test API Credentials to verify the connection. Once the credentials are validated, click Save.

step-8-test-credentials

Step 4: A new settings page will appear. Under the To App section, enable the following settings:

  • Create Users
  • Update User Attributes
  • Deactivate Users

After enabling these settings, your Okta SCIM API integration is successfully configured.

step-9-app-section

Assigning Users for Provisioning

Step 1: Click the Assignments tab and select Assign to People from the dropdown Assign.

step-10-assign-people

Step 2: Select the users you want to assign to the app and click the Assign button.

step-11-assign-button

Step 3: After you click the Assign button, you'll see a new popup window with various fields. Confirm the field values and click the Save and Go Back buttons.

step-12-save

Assigning Groups for Provisioning

Step 1: Navigate to the tab Push Groups and select Find group by name from the dropdown Push Groups.

step-13-push-groups

Step 2: Search for the group you want to assign to the app.

step-14-search-group

Step 3: After assigning the group name, then click on the Save button.

step-15-save