# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hivel.ai/integrations/okta-sso.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.