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

# Okta

## What's supported

### Supported actions

This connector supports:

* [Proxy Actions](/proxy-actions), using the base URL `https://{{.workspace}}.okta.com`.

## Before you get started

To connect Okta with Ampersand, you will need an [Okta account](https://developer.okta.com/signup/).

Once your account is created, you'll need to create an OAuth 2.0 app in Okta and obtain the following credentials:

* Client ID
* Client Secret
* Scopes

You will use these credentials to connect your application to Ampersand.

### Create an Okta account

Here's how you can sign up for an Okta developer account:

1. Go to the [Okta Developer Sign Up page](https://developer.okta.com/signup/) and create an account.
2. Complete the registration process and verify your email.

### Creating an Okta app

Follow the steps below to create an OAuth 2.0 app in Okta:

1. Sign in to your [Okta Admin Console](https://login.okta.com/).
2. Navigate to **Applications** > **Applications** in the left sidebar.
3. Click **Create App Integration**.
4. Select **OIDC - OpenID Connect** as the sign-in method.
5. Select **Web Application** as the application type and click **Next**.
6. Enter a descriptive **App integration name**.
7. In the **Sign-in redirect URIs** field, enter the Ampersand redirect URL: `https://api.withampersand.com/callbacks/v1/oauth`
8. Click **Save**.

The **Client ID** and **Client Secret** will be displayed in the **Client Credentials** section. Note these credentials, as you will need them to connect your app to Ampersand.

To configure scopes, navigate to the **Okta API Scopes** tab and click **Grant** next to each scope your integration requires.

<img src="https://mintcdn.com/ampersand-24eb5c1a/0BnHBrfd6iX-O0Kz/images/provider-guides/okta1.gif?s=bb530f565822d7e6a7a0aca8d5bcdd47" alt="Okta App Creation" width="1152" height="648" data-path="images/provider-guides/okta1.gif" />

## Add your Okta app info to Ampersand

1. Log in to your [Ampersand Dashboard](https://dashboard.withampersand.com).

2. Select the project where you want to create an Okta integration.

   <img src="https://mintcdn.com/ampersand-24eb5c1a/CkzFg-K1u4gYx3ZD/images/provider-guides/dd47b7a-Ampersand.png?fit=max&auto=format&n=CkzFg-K1u4gYx3ZD&q=85&s=d580aa00cc421fe14cfbab79c2e0812f" alt="Ampersand project selection" width="2244" height="442" data-path="images/provider-guides/dd47b7a-Ampersand.png" />

3. Select **Provider Apps**.

4. Select *Okta* from the **Provider** list.

5. Enter the previously obtained **Client ID** in the **Client ID** field and the **Client Secret** in the **Client Secret** field.

6. Enter the scopes set for your application in *Okta*. For a list of available scopes, refer to the [Okta documentation](https://developer.okta.com/docs/guides/implement-oauth-for-okta/main/#scopes-and-supported-endpoints).

   <img src="https://mintcdn.com/ampersand-24eb5c1a/0BnHBrfd6iX-O0Kz/images/provider-guides/okta2.gif?s=6bb428118b4f73e711cbec89f44a5b4a" alt="Okta Ampersand integration" width="1152" height="648" data-path="images/provider-guides/okta2.gif" />

7. Click **Save Changes**.