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

# Okta

> Follow these steps to connect Okta via the StackOne Hub successfully.

<Warning>
  Ensure that your Okta account has **API Access Administrator**, **Organization Administrator**, or  **Super Administrator** privileges.
</Warning>

If you've been directed to StackOne to integrate with Okta, the following steps will help you understand the process and any necessary actions to configure a successful integration.

## Log in to Okta

Log in to your Okta account: [https://login.okta.com/](https://login.okta.com/)

<Frame>
  <img className="rounded-md" style={{ width: '70%',margin: '0 auto', border: '1px solid #efefef' }} alt="Log in to Okta" src="https://mintcdn.com/stackone-hub/_vrnUI8B2K_JB09R/images/okta/image2.png?fit=max&auto=format&n=_vrnUI8B2K_JB09R&q=85&s=7b84838f4c433e388e697b7c521a39a6" width="1255" height="1225" data-path="images/okta/image2.png" />
</Frame>

## Find your Okta Organization URL

Your Organization URL can be found in the URL when logged in to Okta.

Given the URL: `https://MY-ORG.okta.com/app/UserHome`, the **Organization URL** is `MY-ORG`.

## Create your Okta API Token

<Steps>
  <Step title="Navigate to your Okta Admin">
    From your Okta homepage, click the **Admin** button in the top right.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Navigate to your Okta Admin" src="https://mintcdn.com/stackone-hub/_vrnUI8B2K_JB09R/images/okta/image3.png?fit=max&auto=format&n=_vrnUI8B2K_JB09R&q=85&s=9dd6da7d03a4eb9ec7ccf18213f7ac26" width="3192" height="628" data-path="images/okta/image3.png" />
    </Frame>
  </Step>

  <Step title="Navigate to API Tokens">
    In the left navigation menu, click **Security > API**.

    <Frame>
      <img className="rounded-md" style={{ width: '50%', margin: '0 auto', border: '1px solid #efefef' }} alt="Navigate to API" src="https://mintcdn.com/stackone-hub/_vrnUI8B2K_JB09R/images/okta/image4.png?fit=max&auto=format&n=_vrnUI8B2K_JB09R&q=85&s=679375dc5cde8e9a564da2e103d62606" width="642" height="1820" data-path="images/okta/image4.png" />
    </Frame>

    Then under *API*, click **Tokens**.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Click API Tokens" src="https://mintcdn.com/stackone-hub/_vrnUI8B2K_JB09R/images/okta/image5.png?fit=max&auto=format&n=_vrnUI8B2K_JB09R&q=85&s=447a4837e9f50b76663942491ac0e93e" width="1994" height="754" data-path="images/okta/image5.png" />
    </Frame>
  </Step>

  <Step title="Create a new API Token">
    Click the **Create token** button to create a new API Token.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Create a new API Token" src="https://mintcdn.com/stackone-hub/_vrnUI8B2K_JB09R/images/okta/image6.png?fit=max&auto=format&n=_vrnUI8B2K_JB09R&q=85&s=818bc1796a4731dff40e414da64f5f5f" width="1994" height="754" data-path="images/okta/image6.png" />
    </Frame>
  </Step>

  <Step title="Enter initial API Token details">
    Enter a name for the new API Token, and select **Any IP** for the dropdown: *API calls made with this token must originate from*.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enter initial API Token details" src="https://mintcdn.com/stackone-hub/_vrnUI8B2K_JB09R/images/okta/image7.png?fit=max&auto=format&n=_vrnUI8B2K_JB09R&q=85&s=a79fbc33364ed3e08fe4f6c56157ea16" width="1106" height="834" data-path="images/okta/image7.png" />
    </Frame>

    <Info>
      If your Okta instance requires connections only from specific network zones, please contact [integrations@stackone.com](mailto:integrations@stackone.com) for details.
    </Info>
  </Step>

  <Step title="Copy your API Token">
    Copy your **API Token** and store it safely to be used in a later step.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Copy your API Token" src="https://mintcdn.com/stackone-hub/_vrnUI8B2K_JB09R/images/okta/image8.png?fit=max&auto=format&n=_vrnUI8B2K_JB09R&q=85&s=2891fea1f142660c5f02d036a8909c55" width="1102" height="910" data-path="images/okta/image8.png" />
    </Frame>
  </Step>
</Steps>

## Connecting with StackOne

Upon reaching the Link Account page, enter the credential(s) from the previous steps:

* **Organization URL**
* **API Token**

Proceed by clicking the Connect button.

<Frame>
  <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enter Credentials" src="https://mintcdn.com/stackone-hub/_vrnUI8B2K_JB09R/images/okta/image9.png?fit=max&auto=format&n=_vrnUI8B2K_JB09R&q=85&s=6f5861aa2cc3b575599e66ce251c32bc" width="970" height="1302" data-path="images/okta/image9.png" />
</Frame>

## Available data

This integration has the following [IAM Resources](https://docs.stackone.com/reference/getting-started-with-your-api) available from the provider:

<ul>
  <li>Users</li>
  <li>Groups</li>
  <li>Roles</li>
</ul>