<a id="auth0"></a>

# Auth0

<a id="backend-class"></a>

## Backend class

For Django, add this class path to `AUTHENTICATION_BACKENDS`. For other
integrations, use the same class path in the framework-specific backend
setting.

| Backend name   | Class path                               |
|----------------|------------------------------------------|
| `auth0`        | `social_core.backends.auth0.Auth0OAuth2` |

<a id="auth0-oauth2"></a>

## Auth0 OAuth2

Auth0 provides OAuth2 authentication. This is the original `Auth0OAuth2` backend.

For a newer OpenID Connect implementation, see [Auth0 OpenID Connect](auth0_openidconnect.html.md).

<a id="setup"></a>

### Setup

To enable Auth0 OAuth2 support:

1. Register your application at [Auth0 Dashboard](https://manage.auth0.com/) to get your Auth0 domain,
   Client ID, and Client Secret.
2. Fill in the settings with your Auth0 domain, Client ID, and Client Secret:
   ```default
   SOCIAL_AUTH_AUTH0_KEY = ''
   SOCIAL_AUTH_AUTH0_SECRET = ''
   SOCIAL_AUTH_AUTH0_DOMAIN = 'yourdomain.auth0.com'
   ```

   Replace `yourdomain` with your Auth0 tenant domain.
3. Add the backend to your authentication backends:
   ```default
   AUTHENTICATION_BACKENDS = (
       ...
       'social_core.backends.auth0.Auth0OAuth2',
       ...
   )
   ```

<a id="scopes"></a>

### Scopes

You can define custom scopes using the `SOCIAL_AUTH_AUTH0_SCOPE` setting:

```default
SOCIAL_AUTH_AUTH0_SCOPE = ['openid', 'profile', 'email']
```

The backend will handle JWT token validation and extract user details including
username, email, full name, and profile picture.