> ## Documentation Index
> Fetch the complete documentation index at: https://hoopdev-feat-new-runbook-parameters.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Auth0

## Requirements

* An [account in Auth0](https://auth0.com)
* `API_URL` is the public DNS name of the hoop gateway instance

Contact the administrator of the hoop gateway instance to retrieve the `API_URL` address.

## Identity Provider Configuration

<Steps titleSize="h3">
  <Step title="Create an Application">
    Create a new application

    * Go to **Applications > Applications** and click on the **Create Application** button
    * Select a Regular Web Application
  </Step>

  <Step title="Configure the Redirect URIs">
    * Allowed Callback URLs: `{API_URL}/api/callback`
    * Allowed Logout URLs: `{API_URL}/api/logout`
  </Step>

  <Step title="Collect the Credentials">
    * In the Application Home, copy the **Client ID** and **Client Secret**
  </Step>

  <Step title="Collect Issuer Information">
    * In the **Application Home** > **Settings**, copy the **Domain**.
    * The issuer url is in the format `https://{YOUR_DOMAIN}`
  </Step>

  <Step title="Collect the Auth0 Management API Audience">
    * Go to **Applications** > **API**
    * Copy the **API Audience** value
  </Step>
</Steps>