> For the complete documentation index, see [llms.txt](https://support.goodaccess.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.goodaccess.com/configuration-guides/features/sso-scim/auth0.md).

# Auth0

{% hint style="info" %}
This feature is available in the **Premium plan and higher**.
{% endhint %}

{% hint style="danger" %}
**Remember to grant your users access permissions to GoodAccess. Users without them won't be able to log in.**
{% endhint %}

## Step 1 - Adding a new identity provider

[Log in to the GoodAccess **Control Panel**, and go to **Settings** > **SSO & Identity**.](https://app.goodaccess.com/sso-and-identity/)

Click **+ Add provider**, enter the **Provider name**, choose your **Identity Provider**, and click **Continue**.

## Step 2 - Setting up Single Sign-On with SAML

Log in to the [Auth0 Admin console](https://manage.auth0.com/), go to **Applications** > **Applications**, and click **+ Create Application**.

Give the application a name, select **Native**, and click **Create**.

Go to **Addons**, and open **SAML2**.

<figure><img src="/files/EhlgMUzh1EJAbHaT4QZ9" alt="Auth0 Admin console with key steps to creating a new application."><figcaption><p>Creating a new application</p></figcaption></figure>

<figure><img src="/files/eYWQR540Dbzj4cP6EKLt" alt="Auth0 Admin console with key steps to creating a new application."><figcaption><p>Creating a new application</p></figcaption></figure>

<figure><img src="/files/b8Prsrn49h8xR1xzRtTa" alt="Auth0 Admin console with key steps to opening the SAML2 addon."><figcaption><p>Opening the SAML2 addon</p></figcaption></figure>

### 1. Settings

Go to **Settings**, and copy the details from GoodAccess - **(2) GoodAccess links**.

* **Application Callback URL** - Assertion Consumer Service URL

Copy the below code into **Settings**:

```
{
  "mappings": {
    "email": "email",
    "name": "name"
  },
  "createUpnClaim": false,
  "passthroughClaimsWithNoMapping": false,
  "mapUnknownClaimsAsIs": false,
  "mapIdentities": true
}
```

Return to GoodAccess, and click **Continue**.

Return to Auth0, scroll down to the bottom of the page, and click **Enable**.

<figure><img src="/files/viVWJ3fdLdKL9OT7zc0y" alt="Auth0 Admin console with key steps to setting up the &#x22;Settings&#x22;."><figcaption><p>Setting up the Settings</p></figcaption></figure>

### 2. Usage

Go to **Usage**, download the **Identity Provider Metadata**, and open the file in a text editor (e.g. Notepad).

Copy the details to GoodAccess - **(3) Identity Provider links**, and click **Continue**.

* **Sign in URL** - Identity Provider Login URL
* **Entity ID** - Issuer
* **X509 signing certificate** - Copy the certificate from the text editor

Click **Submit** to finish the configuration.

<figure><img src="/files/VkwXkP8lVcqTvovFKIZw" alt="Auth0 Admin console with key steps to setting up the &#x22;Usage&#x22;."><figcaption><p>Setting up the Usage</p></figcaption></figure>

<figure><img src="/files/2YH3SsWF3aclkgJeEZxY" alt="Notepad with highlighted X509 signin certificate."><figcaption><p>Copying the certificate from the Notepad</p></figcaption></figure>

You have now successfully set up your Auth0 SSO with GoodAccess.
