For AI agents: the complete documentation index is at llms.txt. Remove the trailing slash from a page URL and append .md to read its Markdown version. For the docs home, use index.md.

Okta Auth Integration

Legacy integration. New connections use the Okta card instead: selecting Okta Auth in Reflex Build opens it. This page is for projects that already have an Okta Auth connection.

The Okta Auth Integration allows your app to authenticate users through Okta. This integration provides secure OAuth 2.0 / OIDC authentication and supports multi-tenant environments with customizable access policies.

What You Can Do

With Okta, your app can:

  • Authenticate users securely through Okta’s identity platform.
  • Enable SSO for enterprise users.
  • Manage user roles, groups, and access permissions.
  • Protect sensitive data and actions with OAuth 2.0 and OpenID Connect (OIDC).
  • Integrate with other identity workflows like MFA or adaptive policies.

Step 1: Set Up Okta OIDC App

Before connecting, you need to create an OIDC application in the Okta Admin Console:

1 - Go to Okta Admin Console → Applications and Resources → Applications

2 - Click Create App Integration (if asked, select Classic experience)

Documentation image

3 - Select OIDC – OpenID Connect and choose Web Application

Documentation image

4 - Configure your app settings:

  • Client definition: Use Okta-generated client ID
  • Sign-in redirect URIs: the redirect URI shown on the Okta Auth connection in Reflex Build, which has this form: https://{your-sandbox}/_reflex_oidc_okta/authorization-code/callback
  • Sign-out redirect URIs: https://{your-sandbox}
  • Assign to the correct Group or Everyone depending on your access control

Documentation image

5 - Save the app integration.

6 - Copy your Client ID (OKTA_CLIENT_ID) and Client Secret (OKTA_CLIENT_SECRET) from the Client Credentials section of the app's General tab.

Documentation image

Step 2: Finding Your Okta Issuer URI

  1. In the Okta Admin Console, go to Security → API and open the Authorization Servers tab
  2. Click on the default server and copy the Issuer URI, including /oauth2/default. This is your Okta Issuer URI (OKTA_ISSUER_URI).

Example: https://{yourOktaDomain}.okta.com/oauth2/default

Documentation image

Note: Always use separate Okta apps for dev, staging, and production environments to avoid mixing credentials.

Step 3: Configure the Integration

  1. In Reflex Build, open the Integrations tab and select your existing Okta Auth connection.
  2. Fill in the credential fields:
    • OKTA_CLIENT_ID: your Client ID
    • OKTA_CLIENT_SECRET: your Client Secret
    • OKTA_ISSUER_URI: your Issuer URI
  3. Click Save Changes.

Your app can now authenticate users through Okta using the secure OAuth 2.0 / OIDC flow.