# SSO Using OAuth

{% hint style="warning" %}
This guide uses [Auth0](https://auth0.com/) to show the OAuth setup flow. Other OAuth providers usually follow similar steps.
{% endhint %}

### Set up OAuth

### Open or create an Auth0 application

{% stepper %}
{% step %}

### Auth0: Create an account

Create an account in [Auth0](https://auth0.com/).
{% endstep %}

{% step %}

### Auth0: Open the application list

In Auth0, go to **Applications → Applications**.

<figure><img src="https://downloads.intercomcdn.com/i/o/ih9pma6x/1736831997/f2a0ced78c135ace19871f6e87d9/image.png?expires=1764258300&#x26;signature=077907c9e53de0e54318e7ac8b6ee9798c041ee414d450609b5d312614dfe2f0&#x26;req=dSckEMF9nIhWXvMW1HO4zS2FxAvZKnzSkFYvUmgIQyXybX71Bz8mWLf%2F0BJO%0AExGL%0A" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Auth0: Open the application

Open the default application.
{% endstep %}
{% endstepper %}

### Configure OAuth in Luciq

{% stepper %}
{% step %}

### Luciq: Open OAuth settings

In Luciq, go to **Account Management → Identity access management**.

Click **Configure** next to **OAuth**.

<figure><img src="https://downloads.intercomcdn.com/i/o/ih9pma6x/1736824710/73246dd82f4ddbab177fbc38c628/image.png?expires=1764258300&#x26;signature=f40717325d779d490bad2f22bc13df34792fbf31e01d4ec4f948032a27850036&#x26;req=dSckEMF8mYZeWfMW1HO4zetmf6OfnHRVHr7vdGLsnYpQ%2F2rsNolzRS0fc%2Fc2%0A6oQi%0A" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Auth0 and Luciq: Copy the application credentials

Use the values from the Auth0 application page to fill the matching fields in Luciq:

1. Copy `Client ID` from Auth0 to `Client ID` in Luciq.

   <figure><img src="https://downloads.intercomcdn.com/i/o/ih9pma6x/1401654343/296cfe9abe04e751ebf37fed280e/image.png?expires=1764258300&#x26;signature=f62280ac4d1b218e343199c089364caaf73c9b34e2943158f23be109958dcdae&#x26;req=dSQnF897mYJbWvMW1HO4zdN6o2KJSC0Hfc%2BqjYQD63KfhU4TvWh62E5VMPsj%0ANjpZ%0A" alt=""><figcaption></figcaption></figure>
2. Copy `Client Secret` from Auth0 to `Client Secret` in Luciq.

   <figure><img src="https://downloads.intercomcdn.com/i/o/ih9pma6x/1401654752/0514af0f906470774db17e0607c1/image.png?expires=1764258300&#x26;signature=f5bf2213b71bfc14a2f7bfe33c335ac8246249fe801139f056214ef9fdaa19a5&#x26;req=dSQnF897mYZaW%2FMW1HO4zf6oiqJWpa2vqHZG39rpAQD7%2FpyzEUpz688mX%2BrB%0ATxXX%0A" alt=""><figcaption></figcaption></figure>
3. In Auth0, scroll to **Advanced Settings → Endpoints**.

   Copy the authorization and token endpoints to the matching URL fields in Luciq.

   <figure><img src="https://downloads.intercomcdn.com/i/o/ih9pma6x/1401655449/2b9287fb903f4e9f29d761b694dc/image.png?expires=1764258300&#x26;signature=82a36df9b98f2ed76a3a03916327548f94c11f72b7dc4162b3972cadc0879593&#x26;req=dSQnF897mIVbUPMW1HO4zV8fZL%2FbVyWCfy4eTMacEB43I39cqFYubZtFqvGg%0Ae8Nw%0A" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}

### Add the callback URL in Auth0

{% stepper %}
{% step %}

### Auth0: Add the Luciq callback URL

In Auth0, on the application settings page, add your Luciq company callback URL.

Enter it in `Allowed Callback URLs`.

{% hint style="info" %}
You can add multiple callback URLs by separating them with a comma.
{% endhint %}

<figure><img src="https://downloads.intercomcdn.com/i/o/ih9pma6x/1736833129/6ac026f24da40f9ca0c1ad11bd6a/Screenshot+2025-09-22+at+12_16_44%E2%80%AFAM.png?expires=1764258300&#x26;signature=ea573c9ee74135ed8d3a96cf1c313b23b03e7424554f08499193f27ac70443d0&#x26;req=dSckEMF9noBdUPMW1HO4zXmuzw2YBRw8ABLr2rvuIgSNfQEj0Z82FKRfTvz%2B%0AyTwL%0A" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Luciq and Auth0: Save the configuration

Save your changes in Luciq.

Save your changes in Auth0.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
To activate the integration, log in with SSO at least once after setup.
{% endhint %}


---

# 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.luciq.ai/organization-settings/user-management/sso-using-oauth.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.