> For the complete documentation index, see [llms.txt](https://docs.luciq.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.luciq.ai/organization-settings/user-management/sso-using-oauth.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.luciq.ai/organization-settings/user-management/sso-using-oauth.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.