> For the complete documentation index, see [llms.txt](https://ai-security-docs.akto.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ai-security-docs.akto.io/account-management/sso/okta-oidc.md).

# Okta OIDC

## Overview

Okta SSO integration with Akto enables centralized authentication using your existing identity provider. Akto uses OpenID Connect (OIDC) to authenticate users and enforce access control using identity and group attributes.

This integration allows your enterprise teams to manage authentication and authorization through Okta while Akto enforces role-based access during login.

## Configure Okta Account for Akto SSO

You can configure Okta SSO and role mapping in a single flow that connects Okta identity, group claims, and Akto role enforcement.

{% stepper %}
{% step %}
**Create Okta Application for Akto**

1. Go to your Okta Admin Console and navigate to **Applications**.\
   Select **Create App Integration**.
2. In **Sign-in Method**, choose **OIDC - OpenID Connect**.\
   In **Application type**, choose **Web Application**.
3. In **App integration name**, enter `Akto`.
4. In **Sign-in redirect URIs**, add:\
   `https://app.akto.io/authorization-code/callback`
5. In **Initiate login URI**, add the following URL if you use login initiated by Okta:\
   `https://app.akto.io/okta-initiate-login?accountId=<your-akto-accountId>`
6. In **Assignments**, select required users or groups.\
   Save the application.
7. Copy **CLIENT\_ID** and **CLIENT\_SECRET** from the application.
   {% endstep %}

{% step %}
**Configure Authorisation Server for Group Claims**

Configure your Okta authorisation server to include a **groups claim** in the access token.

You can use existing Okta groups if your organisation already defines access control groups.\
You may create new groups only when separate access control is required for Akto.

For guidance on creating groups in Okta, refer [here](https://help.okta.com/en-us/content/topics/users-groups-profiles/usgp-groups-create.htm).

Group claims allow Akto to assign roles based on Okta group membership.
{% endstep %}

{% step %}
**Generate Okta API Token**

Navigate to:

* **Security → API → Tokens**
* Create a new token
* Provide a name for the token
* Configure IP restrictions: `Any IP`

  <div data-with-frame="true"><figure><img src="https://1895868029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkpBG2Nfd5ZbNmahr8W6H%2Fuploads%2Fgit-blob-e0e4419acb4ce11537cf6bfcd180f73a4a11cb9c%2FScreenshot%202026-03-20%20at%206.57.36%E2%80%AFPM.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="info" %}
**Note**

Entering a valid Okta API token enables automatic group name suggestions in the mapping interface. Akto retrieves available groups from Okta, which helps reduce manual errors while defining mappings.
{% endhint %}

Copy the generated API token.
{% endstep %}
{% endstepper %}

## Setup Okta SSO in Akto Dashboard

Use the following configuration screen in Akto:

{% stepper %}
{% step %}
Navigate to **Integrations → Okta SSO** in the Akto dashboard.
{% endstep %}

{% step %}
You can see the same [#create-okta-application-for-akto](#create-okta-application-for-akto "mention") steps here too. Click on the **Next**.
{% endstep %}

{% step %}
Enter the following fields:

* **Client ID**: Okta application client ID
* **Client Secret**: Okta application client secret
* **Authorisation Server ID**: Okta authorisation server identifier
* **Domain Name**: Okta domain (for example: `your-org.okta.com`)
* **API Token**: Okta API token

<div data-with-frame="true"><figure><img src="https://1895868029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkpBG2Nfd5ZbNmahr8W6H%2Fuploads%2Fgit-blob-9a5517828d41673668ac6c882680ad2fdba4ebc3%2Fimage%20(155).png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Submit the configuration to enable SSO.
{% endstep %}
{% endstepper %}

## Configure Group-to-Role Mapping in Akto

After SSO configuration, define how Okta groups map to Akto roles.

You can also, optionally, turn on **Sync Okta groups to device tags** in this section. When enabled, every Okta group is synced as a `group` tag on each discovered user in **Akto Atlas**, and the tags are visible on the Users and Devices page. This sync runs in the background and refreshes every 1 hour. It is independent of role mapping and does not change the role a user gets in Akto.

{% stepper %}
{% step %}
Navigate to **Group mapping & API access** section and select **Edit**.

<div data-with-frame="true"><figure><img src="https://1895868029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkpBG2Nfd5ZbNmahr8W6H%2Fuploads%2Fgit-blob-59360e317792c57a74b40d64682f7a033260d763%2Fimage%20(156).png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
In **Okta group name**, enter the exact group name from Okta.

{% hint style="info" %}
Group name must match the value present in the access token or retrieved through the Okta API.
{% endhint %}
{% endstep %}

{% step %}
In **Akto role**, select the corresponding role such as **Admin**, **Security Engineer**, **Developer**, or **Guest**.

<div data-with-frame="true"><figure><img src="https://1895868029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkpBG2Nfd5ZbNmahr8W6H%2Fuploads%2Fgit-blob-320864444bbdedcd8885a69e2c442338c0af039c%2Fimage%20(157).png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Select **Add** to create the mapping.

Here, each Okta group maps to one Akto role, and each role can be assigned once.
{% endstep %}

{% step %}
Repeat the process for additional groups as required.
{% endstep %}

{% step %}
Add the **Management API token** in the same section if group claims are not included in the access token.
{% endstep %}

{% step %}
(Optional) Turn on **Sync Okta groups to device tags** to also use your Okta groups as device tags in **Akto Atlas**.

When enabled, every Okta group is synced as a `group` tag on each discovered user in Akto Atlas. This is separate from the group-to-role mapping above and does not affect which Akto role a user gets.

<div data-with-frame="true"><figure><img src="https://1895868029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkpBG2Nfd5ZbNmahr8W6H%2Fuploads%2Fgit-blob-a10da4b033ee9761e44e685aaa13074016eddee0%2Fimage%20(215).png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
**Note**

* This toggle is optional. Leave it off if you only need group-to-role mapping.
* The sync runs in the background and refreshes every 1 hour, so changes in Okta can take up to an hour to appear.
* Once synced, the tags are visible on the [Users and Devices](https://ai-security-docs.akto.io/akto-atlas-agentic-ai-security-for-employee-endpoints/ai-agent-activity/users-and-devices.md) page in Akto Atlas.
  {% endhint %}
  {% endstep %}

{% step %}
Save the configuration.

<div data-with-frame="true"><figure><img src="https://1895868029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkpBG2Nfd5ZbNmahr8W6H%2Fuploads%2Fgit-blob-2b794624920e472d0731eab672415a68a84fa635%2Fimage%20(216).png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Role Override on Okta SSO Login**

When you sign in using Okta SSO, your role in Akto is based on your current Okta group. If your group (and role) has changed in Okta, your role in Akto will automatically update and override your previous role the next time you log in.
{% endhint %}

## Role Assignment During Login

Akto evaluates group membership during user login and assigns roles based on configured mappings.

* Okta groups determine access levels
* Akto roles enforce permissions inside the platform
* API token enables fallback group resolution when required

This setup allows your teams to manage identity and access in Okta while Akto enforces consistent authorisation.
