> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/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-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/okta/image2.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=7b0f31bc714926d6fddb0e8e98ef13ea" 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-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/okta/image3.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=882bebd38f0fc4a5041924e3ec47433f" 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-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/okta/image4.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=6e360a60182e6c918f2994f24e1d472e" 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-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/okta/image5.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=53130208a405f1faab59eacb4d59e83f" 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-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/okta/image6.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=5fa2ba2609cbb137dc60992a3fe6f8be" 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-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/okta/image7.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=6901a3c04024043adfa199985d8d9ef5" 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-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/okta/image8.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=827c915e74d28275cb7f92d25053083a" 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-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/okta/image9.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=4da047fea36b277e935928f314a62497" width="970" height="1302" data-path="images/okta/image9.png" />
</Frame>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

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