> ## Documentation Index
> Fetch the complete documentation index at: https://docs.airmdr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Okta

> Okta is an integrated identity and mobility management service.

Okta securely connects people to their applications from any device, anywhere, anytime. Okta integrates with existing directories, identity systems, and thousands of on-premises, cloud, and mobile applications. It runs on a secure, reliable, and extensively audited cloud-based platform.

## Create Okta API Token

* Login into the [Okta Admin Console](https://your-okta-domain.okta.com).
* Enter your admin username and password, then click **Sign In**.

<img src="https://mintcdn.com/airmdr/W8fdv67VSs6YDZWp/images/Okta-1.png?fit=max&auto=format&n=W8fdv67VSs6YDZWp&q=85&s=de43c6532810754c04ccdb051d83bab2" alt="" width="751" height="378" data-path="images/Okta-1.png" />

<Info>
  The user must have access to create an Okta API token.

  The list of RBACs (Role-Based Access Control) to create Okta API tokens are as follows:

  * Super Admins
  * Org Admins
  * Group Admins
  * Group Membership Admins
  * Read Only Admins
</Info>

* In the Okta Admin Console, click on **Security** in the top navigation bar.
* From the dropdown, select **API**.
* Under the **API** section, click on the **Tokens** tab.
* Click the **Create Token** button.

<img src="https://mintcdn.com/airmdr/BsrAaFhPC4UDUKkR/images/Okta-2.png?fit=max&auto=format&n=BsrAaFhPC4UDUKkR&q=85&s=1656ddd32b1be64e2b7d7c88397c03a4" alt="Okta 2 Pn" width="740" height="411" data-path="images/Okta-2.png" />

* In the **Create Token** dialog box, enter a **Token Name** (e.g., "Companyname Okta API Token").

<img src="https://mintcdn.com/airmdr/W8fdv67VSs6YDZWp/images/Okta-3.png?fit=max&auto=format&n=W8fdv67VSs6YDZWp&q=85&s=c073014dc6300ecf5b25c31f073e1bb0" alt="" width="854" height="451" data-path="images/Okta-3.png" />

* Click **Create Token** to generate the new token.

<Info>
  After creation, Okta will display the new API token.
</Info>

<Warning>
  This is the only time the token will be visible, so copy and store it securely (e.g., in a password manager).
</Warning>

* Click **Done** to finish the process.

<Tip>
  Now that you have your API token, you can use it to authenticate API requests.
</Tip>

<Check>
  <Icon icon="envelope" /> Email the API token and the Okta Base URL to AirMDR.
</Check>

## Optional: Revoke an API Token

If you need to revoke the token at any time:

* Go back to the **API Tokens** page in the Okta Admin Console.
* Find the token you want to revoke and click on the **Revoke** button next to it.

### Configure Okta in the AirMDR Integrations Dashboard

1. Navigate to [AirMDR](https://app.airmdr.com/auth/login), provide the credentials, and click **Login**
2. Navigate to the AirMDR Integrations Dashboard in the left navigation pane and select **Integrations.**
3. Use the search option, enter the keyword "**Okta**", select the **Connections** tab, and click **Add New Connection**.

   <img src="https://mintcdn.com/airmdr/W7xRdWO6hkeheGHl/images/Okta-4.png?fit=max&auto=format&n=W7xRdWO6hkeheGHl&q=85&s=7cacd97d92912f7890174b74d4d924da" alt="Okta 4 Pn" width="2100" height="1238" data-path="images/Okta-4.png" />
4. Enter an unique name to the Instance (e.g., `your org name-Okta`) to easily identify the user connection by AirMDR and brief Description to showcase the purpose.
5. Enter the generated **API Key** and **Base Domain** in the Authentication Details field params, and click **Save.**

   <img src="https://mintcdn.com/airmdr/W7xRdWO6hkeheGHl/images/Okta-5.png?fit=max&auto=format&n=W7xRdWO6hkeheGHl&q=85&s=6bee2cb9a0fa119e5e6cd5fb158f7ce4" alt="Okta 5 Pn" width="1502" height="1458" data-path="images/Okta-5.png" />
