> ## 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 SAML SSO with Okta

> For Biqli Enterprise users, securely manage your team's access to Biqli using Okta SAML SSO.

<Warning>
  **Enterprise Plan Feature**: SAML Single Sign-On is available exclusively for workspaces on the **Enterprise plan**.
</Warning>

## Step 1: Create SAML Integration in Okta

In your Okta Dashboard, navigate to the **Applications** section in the sidebar and click on **Create App Integration**.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/6u-Qjlh2ycaDp84P/images/okta-saml/okta-saml-create-app.png?fit=max&auto=format&n=6u-Qjlh2ycaDp84P&q=85&s=1fbbf7396958a92259defe2931a76350" alt="Create App Integration" width="3840" height="2160" data-path="images/okta-saml/okta-saml-create-app.png" />
</Frame>

For the sign-on method, select **SAML 2.0** and click **Next**.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/6u-Qjlh2ycaDp84P/images/okta-saml/okta-saml-saml2.png?fit=max&auto=format&n=6u-Qjlh2ycaDp84P&q=85&s=ccba179a1c00df0321fb93f1bb0e5d42" alt="Select SAML 2.0" width="3840" height="2160" data-path="images/okta-saml/okta-saml-saml2.png" />
</Frame>

On the General Settings page, enter **Biqli** for the app name, then click **Next** to continue to the SAML settings.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/6u-Qjlh2ycaDp84P/images/okta-saml/okta-saml-app-name.png?fit=max&auto=format&n=6u-Qjlh2ycaDp84P&q=85&s=a564c863144e6e8c1b049dc5ca325e68" alt="General Settings - App Name" width="3840" height="2160" data-path="images/okta-saml/okta-saml-app-name.png" />
</Frame>

## Step 2: Configure SAML Settings

Copy the following values and paste them into the **SAML Settings > General** section:

```text Single sign-on URL theme={null}
https://biq.li/saml/acs
```

```text Audience URI (SP Entity ID) theme={null}
https://biq.li/workspaces/{WORKSPACE_SLUG}
```

<Note>
  Please ensure you replace `{WORKSPACE_SLUG}` with the slug of the specific workspace in which you are activating Okta SAML.
</Note>

Set the **Name ID format** to `EmailAddress` and the **Application username** to `Email`.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/6u-Qjlh2ycaDp84P/images/okta-saml/okta-saml-urls.png?fit=max&auto=format&n=6u-Qjlh2ycaDp84P&q=85&s=6f4a87ebadefda87554f85acc288e610" alt="SAML Settings configuration" width="3840" height="2160" data-path="images/okta-saml/okta-saml-urls.png" />
</Frame>

## Step 3: Configure Attribute Statements

Just below the General section in the SAML Settings, navigate to the **Attribute Statements** section. Add the following four attribute statements:

| Name          | Name format | Value              |
| :------------ | :---------- | :----------------- |
| `email`       | Unspecified | `user.email`       |
| `firstName`   | Unspecified | `user.firstName`   |
| `lastName`    | Unspecified | `user.lastName`    |
| `displayName` | Unspecified | `user.displayName` |

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/6u-Qjlh2ycaDp84P/images/okta-saml/okta-saml-attributes.png?fit=max&auto=format&n=6u-Qjlh2ycaDp84P&q=85&s=3cc25f4068e199e56bdac875bd5bdaa9" alt="Configure Attribute Statements" width="3840" height="2160" data-path="images/okta-saml/okta-saml-attributes.png" />
</Frame>

## Step 4: Submit Feedback

You will then be presented with an Okta Feedback section. Select the option **"This is an internal app we have created"** and click **Finish** to complete the application creation process.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/6u-Qjlh2ycaDp84P/images/okta-saml/okta-saml-feedback.png?fit=max&auto=format&n=6u-Qjlh2ycaDp84P&q=85&s=0568f101d44b7afaf02f4b44015addfa" alt="Submit Okta Feedback" width="3840" height="2160" data-path="images/okta-saml/okta-saml-feedback.png" />
</Frame>

## Step 5: Copy the Metadata URL

After finishing the setup, you will be taken to the **Sign On** tab for your new application. Under the settings section, locate and copy the **Metadata URL**. You will need this to complete the configuration on Biqli.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/6u-Qjlh2ycaDp84P/images/okta-saml/okta-saml-metadata-url.png?fit=max&auto=format&n=6u-Qjlh2ycaDp84P&q=85&s=2be046b901e591ab20027f90c9052b47" alt="Copy Metadata URL" width="3840" height="2160" data-path="images/okta-saml/okta-saml-metadata-url.png" />
</Frame>

## Step 6: Configure SAML SSO on Biqli

Navigate to your Biqli workspace **Security Settings**. Under the **SAML Single Sign-On** section, click **Configure SAML Single Sign-On**.

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

In the configuration modal:

1. **Select Identity Provider**: Choose **Okta** as your SAML provider.
2. **Metadata URL**: Paste the Metadata URL you copied in Step 5.
3. **Test Connection**: Click to verify your setup.
4. **Enable SAML**: Toggle on SAML authentication for your workspace.
5. **Save Changes**: Click **Save changes** to complete the configuration.

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/6u-Qjlh2ycaDp84P/images/okta-saml/okta-saml-biqli-setup2.png?fit=max&auto=format&n=6u-Qjlh2ycaDp84P&q=85&s=42e09a0e89cc847173eca2bd1e0deb2c" alt="Biqli SAML Configuration Modal" width="3840" height="2160" data-path="images/okta-saml/okta-saml-biqli-setup2.png" />
</Frame>

## Step 7: Assign Users

To assign users, navigate back to your Okta dashboard and open your Biqli application. Under the **Assignments** tab, click **Assign** (you can assign users individually or in bulk by group).

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/6u-Qjlh2ycaDp84P/images/okta-saml/okta-saml-biqli-assignments.png?fit=max&auto=format&n=6u-Qjlh2ycaDp84P&q=85&s=ddfdfd8c7859bd63be651965eb2a46d4" alt="Okta Assignments Tab" width="3840" height="2160" data-path="images/okta-saml/okta-saml-biqli-assignments.png" />
</Frame>

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

<Frame>
  <img src="https://mintcdn.com/biqlillc-cc349ea4/6u-Qjlh2ycaDp84P/images/okta-saml/okta-saml-biqli-assignments2.png?fit=max&auto=format&n=6u-Qjlh2ycaDp84P&q=85&s=2a2009d197db3b63a43399ad67bdfc07" alt="Okta User Assignment" width="3840" height="2160" data-path="images/okta-saml/okta-saml-biqli-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/6u-Qjlh2ycaDp84P/images/okta-saml/okta-saml-biqli-assignments3.png?fit=max&auto=format&n=6u-Qjlh2ycaDp84P&q=85&s=c1c6b923fcdaeda66b342ef0629cd413" alt="Save Okta Assignments" width="3840" height="2160" data-path="images/okta-saml/okta-saml-biqli-assignments3.png" />
</Frame>

The users you assigned will now be able to sign in to Biqli using Okta SSO.

## Technical Notes

<Info>
  **Just-In-Time (JIT) Provisioning**: When users sign in for the first time, their Biqli account will be automatically created and assigned to your workspace.
</Info>

<Warning>
  We highly recommend configuring [SCIM Directory Sync](/workspace/saml-sso/okta-scim) before assigning users & groups to your workspace. This ensures users are automatically added when assigned, and immediately deactivated in Biqli when disabled in Okta.
</Warning>
