> For the complete documentation index, see [llms.txt](https://help.getboomerang.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.getboomerang.ai/integrations/okta-integration.md).

# Okta Integration

Set up Okta SSO for Boomerang using OIDC, collect the required credentials, and send them to Boomerang for configuration.

## Setting Up SSO with Okta

Boomerang supports Single Sign-On (SSO) via **OpenID Connect (OIDC)**, allowing your team to authenticate through Okta using an IdP-initiated flow with Just-in-Time (JIT) user provisioning.

{% hint style="info" %}
**Prerequisite:** You must have administrator access to an Okta organization before starting this setup.
{% endhint %}

***

### Step 1: Install Boomerang in Okta

1. Sign in to your **Okta Admin Console**.
2. Navigate to **Applications → Applications** and click **Browse App Catalog**.
3. Search for **Boomerang by BuyerAssist.io** and click **Add Integration**.
4. Once installed, enter your **Boomerang subdomain** in the Subdomain field.\ <br>

   <figure><img src="https://2414717843-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF4sGqcoCrkId9JzoARE8%2Fuploads%2FngIPyyAqZfpfKZ9zk0lK%2FOkta%20Boomerang.png?alt=media&amp;token=da6f61b9-a3c3-49e3-993d-c9f7adce5320" alt=""><figcaption></figcaption></figure>

***

### Step 2: Gather Your Okta Credentials

You'll need to collect three values from Okta to complete the integration.

1. In the Admin Console, open the **Boomerang** application and go to the **Sign On** tab.
2. Copy your **Client ID** and **Client Secret** — use the eye icon to reveal the secret.
3. Copy your **Okta Domain** — find it by clicking your username in the top-right corner of the Admin Console.\ <br>

   <figure><img src="https://2414717843-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF4sGqcoCrkId9JzoARE8%2Fuploads%2F5tAJw3jRZ1Mlyroajzm1%2Fokta%20domain.png?alt=media&amp;token=90e8c976-97c7-4f01-a3d8-480fb623dddf" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Keep your Client Secret confidential. Do not share it in public channels or commit it to version control.
{% endhint %}

***

### Step 3: Send the Credentials to Boomerang

Email the following information to <support@getboomerang.ai>:

| Field                    | Where to find it                         |
| ------------------------ | ---------------------------------------- |
| Client ID                | Boomerang app → Sign On tab              |
| Client Secret            | Boomerang app → Sign On tab              |
| Okta Domain (Issuer URL) | Top-right username menu in Admin Console |

{% hint style="info" %}
Once received, the Boomerang support team will configure the integration and follow up with you when it's ready.
{% endhint %}