# Okta

Source: https://userguide.qualytics.io/settings/access/directory-sync/how-tos/okta/

*Deployment availability: Managed deployment.*

*Deployment availability: 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](https://userguide.qualytics.io/assets/settings/access/directory-sync/how-tos/okta/step-1-browse-app-catalog.png)

**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](https://userguide.qualytics.io/assets/settings/access/directory-sync/how-tos/okta/step-2-search-scim-app.png)

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

![step-3-add-integration](https://userguide.qualytics.io/assets/settings/access/directory-sync/how-tos/okta/step-3-add-integration.png)

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

![step-4-application-name](https://userguide.qualytics.io/assets/settings/access/directory-sync/how-tos/okta/step-4-application-name.png)

**Step 5:** Click on the **Next** button.

![step-5-next-button](https://userguide.qualytics.io/assets/settings/access/directory-sync/how-tos/okta/step-5-next-button.png)

## Configuring SCIM Endpoints

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

![step-6-configure-api](https://userguide.qualytics.io/assets/settings/access/directory-sync/how-tos/okta/step-6-configure-api.png)

**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](https://userguide.qualytics.io/settings/access/directory-sync/introduction/#requirements).

![step-7-enable-api](https://userguide.qualytics.io/assets/settings/access/directory-sync/how-tos/okta/step-7-enable-api.png)

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

![step-8-test-credentials](https://userguide.qualytics.io/assets/settings/access/directory-sync/how-tos/okta/step-8-test-credentials.png)

**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](https://userguide.qualytics.io/assets/settings/access/directory-sync/how-tos/okta/step-9-app-section.png)

## Assigning Users for Provisioning

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

![step-10-assign-people](https://userguide.qualytics.io/assets/settings/access/directory-sync/how-tos/okta/step-10-assign-people.png)

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

![step-11-assign-button](https://userguide.qualytics.io/assets/settings/access/directory-sync/how-tos/okta/step-11-assign-button.png)

**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](https://userguide.qualytics.io/assets/settings/access/directory-sync/how-tos/okta/step-12-save.png)

## 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](https://userguide.qualytics.io/assets/settings/access/directory-sync/how-tos/okta/step-13-push-groups.png)

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

![step-14-search-group](https://userguide.qualytics.io/assets/settings/access/directory-sync/how-tos/okta/step-14-search-group.png)

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

![step-15-save](https://userguide.qualytics.io/assets/settings/access/directory-sync/how-tos/okta/step-15-save.png)

*Last updated: September 22, 2026.*
