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

# Okta SSO

To integrate Okta with Hivel, follow these steps:

### 1. Create an Application in Okta

Follow these steps to set up an Okta application for Hivel authentication:

1. **Log in** to your Okta Admin Console.

<figure><img src="/files/KHTsFgX9D0hMAMAj8pTS" alt="" width="563"><figcaption></figcaption></figure>

2. Navigate to **Applications** → Click **Create App Integration**.

<figure><img src="/files/hmIuJgjAxnmrUBmXQbNX" alt="" width="563"><figcaption></figcaption></figure>

3. Select the **Sign-in method**: `OIDC - OpenID Connect`.
4. Choose **Application Type**: `Web`.

<figure><img src="/files/HmiUQG5W05u5oX1LnQFm" alt="" width="563"><figcaption></figcaption></figure>

5. Enter the **Redirect URI**:

```
https://app.hivel.ai
```

6. Under **Assignments access**, configure permissions based on your organization's requirements.
7. Add the required users to the Okta application to grant them access to Hivel.

<figure><img src="/files/wORphWm8mAhSqpL7pRzk" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/3DkVtb3CWC9NufEKcdVX" alt="" width="563"><figcaption></figcaption></figure>

8. Click **Save** to generate a `Client ID` and `Client Secret`.

### 2. Fill the following details on Hivel UI

After creating the application, fill the input fields on integration page on Hivel UI. Here is how:

* **Log into Hivel -> Go to Settings -> Integrations -> SSO -> Okta**

<figure><img src="/files/YaVYKZU2kTvl8LjACLmk" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/XEHWvwZCXxPkRAIIkl3a" alt="" width="375"><figcaption></figcaption></figure>

#### **Fill the following details on the popup:**

* **OKTA Domain URL** – Your Okta instance URL, e.g., `https://yourcompany.okta.com`.&#x20;
* **OKTA API URL** - We prepopulate based on your domain URL, but it can be changed in case that is not the correct API URL.
* **Client ID** – The client identifier from your Okta application.
* **Client Secret** – The client secret associated with the client ID.

Click on "Integrate OKTA" once done.

These details will enable a seamless authentication flow between Okta and Hivel. If you have any questions or need assistance, feel free to reach out.