---
title: "Okta Directory Integration"
slug: "okta-directory-integration"
updated: 2024-07-17T10:11:47Z
published: 2024-07-17T10:11:47Z
---

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

# Okta Directory Integration

This guide will instruct you on integrating your OKTA directory with Unleash.

## Step 1 - Creating an App

- In the *Applications* section of your Okta admin console, create a new *API Services* app

![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1721210817547.png)![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1721210831510.png)

- Name your app *Unleash Admin*

![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1721210864297.png)

## Step 2 - Config Scopes

Now that the integration is created, go to the *OKTA Api Scopes* tab and grant access to the following scopes:

- `okta.users.read`
- `okta.groups.read`

![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1721210896533.png)

## Step 3 - Config Credentials

Go to the *General* tab and edit the *Client Credentials* section:

![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1721210991017.png)

Change the *Client authentication* type to *Public key/Private Key*:

![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1721211010141.png)

Add generate a new key:

![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1721211043113.png)

Copy the private key and save the new key pair:

![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1721211093669.png)

Finally, share the new *Private Key* and *Client Id* with your Unleash representative, so that they may complete the configuration for your Unleash workspace:

![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1721211077365.png)