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

# Okta

> Step-by-step guide to configure Okta OIDC for TextQL

Configure Okta as your identity provider for TextQL SSO.

## Step 1: Navigate to Applications

In your Okta Admin Console, go to **Applications** → **Applications**.

<Frame caption="Okta Applications page">
  <img src="https://mintcdn.com/textql/x9duCMdWrYDD2E4D/images/admin/oidc/okta/1-arrive-okta.png?fit=max&auto=format&n=x9duCMdWrYDD2E4D&q=85&s=6ed3e8522b8533989621ac855fed43cc" alt="Okta Applications dashboard" width="3024" height="1654" data-path="images/admin/oidc/okta/1-arrive-okta.png" />
</Frame>

## Step 2: Create App Integration

Click **Create App Integration**. Select **OIDC - OpenID Connect** and **Web Application**, then click **Next**.

<Frame caption="Create app integration - select OIDC and Web Application">
  <img src="https://mintcdn.com/textql/x9duCMdWrYDD2E4D/images/admin/oidc/okta/2-okta-create.png?fit=max&auto=format&n=x9duCMdWrYDD2E4D&q=85&s=ae0a8f4f7d983988724e636cbfb5bf10" alt="Okta create app integration dialog" width="3024" height="1656" data-path="images/admin/oidc/okta/2-okta-create.png" />
</Frame>

## Step 3: Copy Redirect URL from TextQL

Open TextQL OIDC Settings and copy the Redirect URL.

<Frame caption="Copy the Redirect URL from TextQL OIDC Settings">
  <img src="https://mintcdn.com/textql/x9duCMdWrYDD2E4D/images/admin/oidc/okta/3-2-tql-redicrect-remember.png?fit=max&auto=format&n=x9duCMdWrYDD2E4D&q=85&s=bdd4a58744ea238737ca4b1fd1781585" alt="TextQL Redirect URL to copy" width="3024" height="1652" data-path="images/admin/oidc/okta/3-2-tql-redicrect-remember.png" />
</Frame>

## Step 4: Configure the Okta App

Fill in the form:

* **App integration name**: `TextQL`
* **Sign-in redirect URIs**: Paste the redirect URL from TextQL

<Frame caption="Configure the Okta app with TextQL details">
  <img src="https://mintcdn.com/textql/x9duCMdWrYDD2E4D/images/admin/oidc/okta/3-1-okta-new-app-page.png?fit=max&auto=format&n=x9duCMdWrYDD2E4D&q=85&s=cf4bb6518d4c1321ce79ad2c0452355f" alt="Okta app configuration form" width="3024" height="1654" data-path="images/admin/oidc/okta/3-1-okta-new-app-page.png" />
</Frame>

Click **Save**.

## Step 5: Copy Client Credentials

After saving, you'll see the General tab with your client credentials. Copy the following values to enter into TextQL:

* **Client ID**: Click the copy button next to the Client ID
* **Client secret**: Click **Generate new secret** if needed, then copy it

<Frame caption="Okta app credentials - copy Client ID and Client secret">
  <img src="https://mintcdn.com/textql/x9duCMdWrYDD2E4D/images/admin/oidc/okta/4-saved-okta.png?fit=max&auto=format&n=x9duCMdWrYDD2E4D&q=85&s=e6581357ac45134cf52164d1e2a7390d" alt="Okta Client ID and secret" width="3024" height="1650" data-path="images/admin/oidc/okta/4-saved-okta.png" />
</Frame>

You'll also need your **Issuer URL**, which is your Okta domain (e.g., `https://yourcompany.okta.com` or `https://dev-xxxxx.okta.com`).

## Step 6: Configure TextQL OIDC Settings

Return to TextQL and paste the values from Okta:

* **Display name**: Enter a name (e.g., "TextQL Demo")
* **Client ID**: Paste from Okta
* **Client Secret**: Paste from Okta
* **Issuer URL**: Your Okta domain
* **Identity Provider**: Select **Okta OIDC**
* **Custom scopes**: Enter `openid email`

<Frame caption="Select Okta OIDC as the Identity Provider">
  <img src="https://mintcdn.com/textql/x9duCMdWrYDD2E4D/images/admin/oidc/okta/5-tql-set.png?fit=max&auto=format&n=x9duCMdWrYDD2E4D&q=85&s=e60e68a02c07b0c6b923ba6b52a68b67" alt="Select Okta OIDC from dropdown" width="1282" height="440" data-path="images/admin/oidc/okta/5-tql-set.png" />
</Frame>

<Frame caption="Complete OIDC configuration with all Okta credentials">
  <img src="https://mintcdn.com/textql/x9duCMdWrYDD2E4D/images/admin/oidc/okta/6-final.png?fit=max&auto=format&n=x9duCMdWrYDD2E4D&q=85&s=487bdc17daa3f7646687d3c22b1b7492" alt="TextQL OIDC Settings fully configured" width="3024" height="1650" data-path="images/admin/oidc/okta/6-final.png" />
</Frame>

Click **Save** to complete the setup.