> ## Documentation Index
> Fetch the complete documentation index at: https://learn.biq.li/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuring SCIM Directory Sync with Okta

> Automatically provision and deprovision users from your Okta directory to Biqli using SCIM.

<Warning>
  **Enterprise Plan Feature**: SCIM Directory Sync is available exclusively for workspaces on the **Enterprise plan**.
</Warning>

For Biqli Enterprise users, you can automatically provision and deprovision users from your Okta directory to Biqli using SCIM Directory Sync.

## Prerequisites

Before configuring SCIM Directory Sync, you must first create and configure a SAML application in Okta.

<Card title="Create Okta SAML Application" icon="shield-keyhole" href="/workspace/saml-sso/okta">
  Follow our guide to configure Okta SAML Single Sign-On for your Biqli Workspace.
</Card>

## Step 1: Configure Directory Sync on Biqli

Navigate to your workspace **Security Settings**. Under the **Directory Sync** section, click **Configure SCIM** to start setting up SCIM provisioning for your workspace.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/6u-Qjlh2ycaDp84P/images/okta-saml/biqli-security-scim.png?fit=max&auto=format&n=6u-Qjlh2ycaDp84P&q=85&s=992cc3cfef4c391a2d8863a7fd6e4eca" alt="Biqli Directory Sync Settings" width="3840" height="2160" data-path="images/okta-saml/biqli-security-scim.png" />
</Frame>

In the SCIM configuration modal:

1. **Select Identity Provider**: Choose **Okta** as your directory provider.
2. **Enable SCIM**: Toggle on SCIM directory synchronization.
3. Click **Save changes**.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/okta-scim/okta-scim-biqli-setup2.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=59d47abdb0e57085931051842f3355f2" alt="Select Okta and Enable SCIM" width="3840" height="2160" data-path="images/okta-scim/okta-scim-biqli-setup2.png" />
</Frame>

This will generate a Directory Sync connection for your Biqli workspace and return **2 values** which you will need in Step 2:

* **SCIM 2.0 Base URL**
* **OAuth Bearer Token**

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/okta-scim/okta-scim-biqli-setup3.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=fa4038b9615a67ff3022cd773c149c92" alt="Copy SCIM Credentials" width="3840" height="2160" data-path="images/okta-scim/okta-scim-biqli-setup3.png" />
</Frame>

## Step 2: Add Provisioning to SAML Application

Open the **General** tab of your existing Biqli Okta SAML application in your Okta Admin Console. Under **App Settings**, click **Edit**.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/okta-scim/okta-scim-general.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=d2609d7799581073a283e4c5282c094a" alt="Okta App Settings" width="3840" height="2160" data-path="images/okta-scim/okta-scim-general.png" />
</Frame>

Select the **SCIM provisioning** checkbox and click **Save**.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/okta-scim/okta-scim-general2.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=7d4b527b70eeb3bde079c38b215b3278" alt="Enable SCIM Provisioning option" width="3840" height="2160" data-path="images/okta-scim/okta-scim-general2.png" />
</Frame>

The **Provisioning** tab should now be visible in your Okta application settings. Open it, then click on **Edit**.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/okta-scim/okta-scim-provisioning.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=9f50dc387f5dfac9a9dba50fa06db200" alt="Okta Provisioning Settings" width="3840" height="2160" data-path="images/okta-scim/okta-scim-provisioning.png" />
</Frame>

Configure the following fields:

1. **SCIM connector base URL**: Paste the **SCIM 2.0 Base URL** value you obtained in Step 1.
2. **Unique identifier field for users**: Enter `userName`. You can copy this value below:
   ```text Unique Identifier theme={null}
   userName
   ```
3. **Supported provisioning actions**: Select the following checkboxes:
   * **Push New Users**
   * **Push Profile Updates**
   * **Push Groups**
4. **Authentication Mode**: Select **HTTP Header**.
5. **Authorization (Bearer Token)**: Paste the **OAuth Bearer Token** value you obtained in Step 1 into the field.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/okta-scim/okta-scim-integration.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=bdc7bf506ce78ee381c97ed909d97043" alt="Configure SCIM settings in Okta" width="3840" height="2160" data-path="images/okta-scim/okta-scim-integration.png" />
</Frame>

Click **Test Connector Configuration** to verify that the connection is working, and then click **Save**.

## Step 3: Configure Provisioning Actions

Under the **To App** section in the left sidebar of the Provisioning tab, click **Edit**.

Configure the following options and click **Save**:

* **Create Users** (Select Enable)
* **Update User Attributes** (Select Enable)
* **Deactivate Users** (Select Enable)

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/okta-scim/okta-scim-toapp.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=1f1757637133a07e3362378c9e6f6b37" alt="Configure Provisioning Actions" width="3840" height="2160" data-path="images/okta-scim/okta-scim-toapp.png" />
</Frame>

## Step 4: Assign Users

Once you've configured Directory Sync, you can assign users to Biqli directly within Okta. When a user is assigned to the application in Okta, their account will be automatically created in Biqli and attached to your workspace.

Click on the **Assignments** tab, and click **Assign**. You can choose to assign users individually, or assign them in bulk by group.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/okta-scim/okta-scim-assignments1.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=b06ce1f39d25cce71e9e85b0da71dba8" alt="Assign Users in Okta" width="3840" height="2160" data-path="images/okta-scim/okta-scim-assignments1.png" />
</Frame>

Select the users or groups you want to assign and click **Assign**.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/okta-scim/okta-scim-assignments2.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=90fd4c650e647168437a373da08c83b5" alt="Select Users or Groups" width="3840" height="2160" data-path="images/okta-scim/okta-scim-assignments2.png" />
</Frame>

On the next screen, scroll to the bottom and click **Save and Go Back**.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/okta-scim/okta-scim-assignments3.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=b1e87fa89c2bf069f8b81939518b6674" alt="Save Assignments" width="3840" height="2160" data-path="images/okta-scim/okta-scim-assignments3.png" />
</Frame>

After this, the users you assigned will be automatically provisioned into your Biqli workspace.
