> ## 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 Azure AD

> Automatically provision and deprovision users from Azure AD 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 Azure AD (Entra ID) to Biqli using SCIM Directory Sync.

## Prerequisites

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

<Card title="Create Azure AD SAML Application" icon="shield-keyhole" href="/workspace/saml-sso/azure-ad">
  Follow our guide to configure Azure AD 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.

<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 **Microsoft Entra ID** 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/entra-scim/entra-scim-biqli-setup2.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=e00b40c3f573f16368e217c1f58f4f6a" alt="Select Microsoft Entra ID and Enable SCIM" width="3840" height="2160" data-path="images/entra-scim/entra-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:

* **Tenant URL**
* **Secret Token**

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

## Step 2: Add Provisioning to SAML Application

Open the **Provisioning** tab of your existing Biqli Azure AD SAML application in the Azure Portal. Click **Connect your application** (or **Get started**).

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/entra-scim/entra-scim-connect.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=36018935cdf7cf7abb146c837b9b9e8d" alt="Connect your application" width="3840" height="2160" data-path="images/entra-scim/entra-scim-connect.png" />
</Frame>

Under the **Admin Credentials** section, enter the values you obtained in Step 1:

1. **Tenant URL**: Paste the Tenant URL.
2. **Secret Token**: Paste the Secret Token.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/entra-scim/entra-scim-admin.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=a491ce7bf11aef4095f80a429e4d3a52" alt="Enter Admin Credentials" width="3840" height="2160" data-path="images/entra-scim/entra-scim-admin.png" />
</Frame>

Click **Test Connection** to validate the credentials, then click **Save** (or **Create**) to store the configuration.

From the left sidebar, select **Provisioning**, expand the **Mappings** section, and click on **Provision Microsoft Entra ID Users**.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/entra-scim/entra-scim-provision.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=d84fbcc193daa10c71b963e78321e4e6" alt="Azure AD Provisioning Mappings" width="3840" height="2160" data-path="images/entra-scim/entra-scim-provision.png" />
</Frame>

Scroll down to the **externalId** attribute mapping row and click **Edit**.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/entra-scim/entra-scim-externalId.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=858123e0334fe86914bc533115ce1a7f" alt="Edit externalId Attribute" width="3840" height="2160" data-path="images/entra-scim/entra-scim-externalId.png" />
</Frame>

Change the **Source attribute** dropdown value to **objectId**, then click **OK**.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/entra-scim/entra-scim-objectid.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=3bfcac5418d9b757e55127c8caf6a0e7" alt="Map Source to objectId" width="3840" height="2160" data-path="images/entra-scim/entra-scim-objectid.png" />
</Frame>

Click **Save** in the top menu to store the attribute mapping configuration, then close the mapping details pane using the **X** in the top-right corner.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/entra-scim/entra-scim-save.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=84c3dd1328e0ca46664db5f7e81b8544" alt="Save mappings and exit" width="3840" height="2160" data-path="images/entra-scim/entra-scim-save.png" />
</Frame>

Expand the **Settings** section on the provisioning configuration page:

* Set the **Scope** dropdown to **Sync only assigned users and groups**.
* Verify that the **Provisioning Status** toggle is set to **On**.

Click **Save** at the top of the settings page.

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

## Step 3: Assign Users

Once SCIM Directory Sync is configured, you can assign users to Biqli directly within Azure AD, and they will be automatically provisioned.

Go to **Users and groups** in the left menu, and click **Add user/group**.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/entra-id-saml/entra-id-saml-add-users.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=8f87d0eb4f7f1722a5137e5587ee6086" alt="Add Users and Groups" width="3840" height="2160" data-path="images/entra-id-saml/entra-id-saml-add-users.png" />
</Frame>

Click **None Selected** under **Users**, select your users, click **Select**, and click **Assign** to confirm.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/fd8RfFbP-cGfepiQ/images/entra-id-saml/entra-id-saml-assign-users.png?fit=max&auto=format&n=fd8RfFbP-cGfepiQ&q=85&s=87c5244a072ad3897682dcef78a8dd6a" alt="Assign Users to SAML app" width="3840" height="2160" data-path="images/entra-id-saml/entra-id-saml-assign-users.png" />
</Frame>

Your assigned users will now have their accounts automatically created in Biqli, attached to the workspace, and enabled to sign in.

***

## Technical Notes

<Warning>
  **Sync Latency**: Azure AD SCIM provisioning runs on a background schedule and can take **between 20 to 40 minutes** to synchronize. If you need users to be added immediately, you can use Azure's **Provision on Demand** option to trigger instant syncing for selected users.
</Warning>
