# SSO Configuration

### Step 1: Navigate to SSO Settings

1. Log in to the Telmai.
2. Go to **Administration**.

<figure><img src="/files/TxAnLsie7ERzD9zDuyso" alt="" width="119"><figcaption></figcaption></figure>

3. Click on **Single Sign-On (SSO) Settings**.

<figure><img src="/files/62taOUDAI1NHnA9kbwnw" alt="" width="563"><figcaption></figcaption></figure>

### Step 2: Configure SSO Details

1. Enter a unique **Login URL Suffix**
   * This will be used to list IDPs available for the user
2. Provide client credentials:
   * **Client ID**: Enter the ID provided by your IdP.
   * **Client Secret**: Enter the secret key provided by your IdP.
3. Provide SSO endpoints or click **Provide Issuer URL**:
   * You can enter the below details manually:
     1. **Issuer**: Enter the Issuer URL from your IdP.
     2. **Authorization**: Enter the Authorization endpoint.
     3. **Token**: Enter the Token endpoint.
     4. **JWKS**: Enter the JWKS (JSON Web Key Set) URL.
     5. **User Info**: Enter the User Info endpoint.
   * **OR** Click on **Provide Issuer URL** to open a modal dialog.

     1. Enter the **Issuer URL** from your IdP and click **Retrieve Endpoints**.

     <figure><img src="/files/Y40UPpowTCBFPfLnXXF7" alt="" width="563"><figcaption></figcaption></figure>
4. Click **Save** to store the configuration.

<figure><img src="/files/S8R3NLvL24x4yFO79yHC" alt="" width="563"><figcaption></figcaption></figure>

5. You can use the toggle button to Enable/Disable the setting. You can also **update** or **delete** the setting at anytime.

<figure><img src="/files/UKK0WZ1q65kytH0dWoXi" alt="" width="563"><figcaption></figcaption></figure>

***

### Step 3: SSO Testing and Verification

1. Navigate to the login page
   * Example: <https://dev.telm.ai/login>
2. Click on **Sign in with IDP.**

<figure><img src="/files/ET6Jirs1tWyI4mMd4oUI" alt="" width="375"><figcaption></figcaption></figure>

3. You will be redirected to Issuer URL. Enter the required details and click Sign In.

<figure><img src="/files/n0RQt32OWB9g1lzc7IgZ" alt="" width="563"><figcaption></figcaption></figure>

If authentication is successful, you should be redirected to the Telmai dashboard.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.telm.ai/telmai/authentication-and-access-control/sso-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.