# 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="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FanAaNDtes7RnlYfkw6zl%2FScreenshot%202025-02-28%20at%207.14.58%E2%80%AFPM%20(1).png?alt=media&#x26;token=b7632eb2-7bf5-4818-a34a-3d266971fd3a" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FhrNf2HhLcOJ6gtvCgeNM%2FScreenshot%202025-02-28%20at%207.15.44%E2%80%AFPM.png?alt=media&#x26;token=028ac564-d33b-4611-b560-7a5dca537167" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FRmfehVF9EuUUoqli7UFo%2FScreenshot%202025-02-28%20at%207.16.20%E2%80%AFPM.png?alt=media&#x26;token=619a556b-e92c-43eb-b78e-64c8a77cbf13" 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="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FySxghUvU5ocpMhxrhMaN%2FScreenshot%202025-02-28%20at%207.18.26%E2%80%AFPM%20(2).png?alt=media&#x26;token=c0f75871-aaed-438f-a7a7-6990cc09a03a" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FmIxPvsaMBvasBbLdEcqJ%2FScreenshot%202025-02-28%20at%207.19.26%E2%80%AFPM.png?alt=media&#x26;token=38818db1-fb35-4f75-b7ea-099ce1eea447" 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="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FISzDLo8VgtjJ0LG7zupc%2Fimage.png?alt=media&#x26;token=9842c2c5-fe26-4b06-9404-40cbb234a116" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FMB0MrV6tN9gwXo3TZdnU%2FGemini%20Generated%20Image%20(2).png?alt=media&#x26;token=fed23c37-f849-40cf-8bb9-ba17bf1b9694" 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.