> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/authentication-and-access-control/auth0-setup.md).

# Auth0 Setup

### Register an OIDC App in Auth0

#### 1. Log in to Auth0 Dashboard

Go to [https://manage.auth0.com](https://manage.auth0.com/) and sign in to your Auth0 tenant.

#### 2. Navigate to Applications

From the dashboard, go to **Applications > Applications** and click **+ Create Application**.

#### 3. Register the Application

Complete the following fields in the "Create Application" dialog:

* **Name:** Enter a descriptive name for your application (e.g., `Telmai-OIDC-App`).
* **Application Type:** Choose `Regular Web Applications`.

Click **Create**.

#### 4. Configure the Application

After creating the application, configure its settings:

* **Callback URL:** Enter the redirect URI provided by Telmai. This will likely follow the format: `https://<your-telmai-instance>.okta.com/oauth2/v1/authorize/callback`. **Please confirm the exact redirect URL with Telmai.**
* Under **Advanced Settings -> OAuth**:
  * **JSON Web Token (JWT) Signature Algorithm:** Choose `RS256`.
  * **Grant Types:** Select `Implicit`, `Authorization Code`, `Refresh Token`, and `Client Credentials`.

Click **Save Changes**.

#### 5. Enable Supported Connections

Under the **Connections** tab of the application:

* Enable the appropriate database, enterprise, or social login providers that your users will utilize.
* Ensure users are provisioned or available under the selected connection.

Click **Save Changes**.

#### 6. Post-Registration Configuration

Once saved, copy the following details from your application's settings, as you will need them for Telmai's configuration:

* **Client ID**
* **Client Secret**
* **Endpoints -> OAuth -> All the OAuth Endpoints**

***