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

> Comprendre les scopes et les claims utilisés avec le protocole OpenID Connect (OIDC).

# Scopes d’OpenID Connect

Ce document présente les scopes inclus dans le protocole d’authentification <Tooltip tip="OpenID : norme ouverte d’authentification qui permet aux applications de vérifier l’identité des utilisateurs sans recueillir ni stocker leurs renseignements de connexion." cta="Voir le glossaire" href="/fr-CA/docs/glossary?term=OpenID">OpenID</Tooltip> Connect (OIDC). Pour en savoir plus sur OIDC, consultez [le protocole OpenID Connect](/fr-CA/docs/authenticate/protocols/openid-connect-protocol).

Les scopes OpenID Connect (OIDC) sont utilisés par une application pendant l’authentification pour autoriser l’accès aux renseignements d’un utilisateur, comme son nom et sa photo. Chaque scope renvoie un ensemble d’attributs utilisateur, appelés claims. Les scopes qu’une application doit demander dépendent des attributs utilisateur dont elle a besoin. Une fois que l’utilisateur a autorisé les scopes demandés, les claims sont renvoyés dans un <Tooltip tip="ID Token : jeton destiné au client lui-même, et non à l’accès à une ressource." cta="Voir le glossaire" href="/fr-CA/docs/glossary?term=ID+Token">ID Token</Tooltip> et sont aussi accessibles via le [point de terminaison `/userinfo`](/fr-CA/docs/api/authentication/user-profile/get-user-info).

Par exemple, supposons que vous avez créé une application Web classique, que vous l’avez enregistrée auprès d’Auth0 et que vous l’avez configurée pour permettre à un utilisateur d’ouvrir une session à l’aide d’un nom d’utilisateur et d’un mot de passe. Une fois l’utilisateur connecté à votre application, vous voulez générer et envoyer automatiquement un courriel de bienvenue personnalisé contenant son nom.

1. Un utilisateur clique sur **Connexion** dans votre application.
2. Votre application redirige l’utilisateur vers le serveur d’autorisation Auth0 (point de terminaison `/authorize`), en incluant les scopes suivants :

   * `openid` (obligatoire; pour indiquer que l’application prévoit utiliser OIDC pour vérifier l’identité de l’utilisateur)
   * `profile` (pour personnaliser le courriel avec le nom de l’utilisateur)
   * `email` (pour savoir où envoyer le courriel de bienvenue)
3. Votre serveur d’autorisation Auth0 redirige l’utilisateur vers l’invite de connexion.
4. L’utilisateur s’authentifie et voit une page de consentement présentant la liste des scopes qu’Auth0 accordera à votre application, y compris l’accès à ses renseignements de profil et à son adresse courriel.
5. L’utilisateur accepte et autorise votre application à avoir ce niveau d’accès à ses renseignements stockés par Auth0.
6. Votre application a maintenant accès aux renseignements de profil et à l’adresse courriel de l’utilisateur.

<div id="standard-claims">
  ## Claim standard
</div>

Les claim standard sont conçues pour fournir à une application des renseignements sur l’utilisateur, comme le nom, le courriel et la photo, et sont prédéfinies pour le protocole OIDC. Ces claim sont renvoyées dans un ID Token et sont aussi accessibles par l’intermédiaire du [point de terminaison `/userinfo`](/fr-CA/docs/api/authentication/user-profile/get-user-info).

Vous pouvez aussi créer des claim personnalisées, c’est-à-dire des claim que vous définissez, contrôlez et ajoutez à un jeton à l’aide des [Actions d’Auth0](/fr-CA/docs/customize/actions/actions-overview). Pour en savoir plus, consultez [JSON Web Token Claims](/fr-CA/docs/secure/tokens/json-web-tokens/json-web-token-claims).

Le scope de base (et obligatoire) pour OIDC est `openid`, ce qui indique qu’une application a l’intention d’utiliser le protocole OIDC pour vérifier l’identité d’un utilisateur. Au-delà de cela, une application peut demander des scopes supplémentaires en indiquant les noms de scopes demandés dans le paramètre `scope`, séparés par des espaces.

Les claim standard incluses dans les scopes les plus couramment utilisés sont indiquées ci-dessous, mais pour obtenir la liste complète des claim standard disponibles, consultez [Spécification OIDC : Standard Claims sur openid.net](https://openid.net/specs/openid-connect-core-1_0.html#StandardClaims). Pour obtenir la liste complète des scopes, consultez [Spécification OIDC : Requesting Claims Using Scope Values sur openid.net](https://openid.net/specs/openid-connect-core-1_0.html#ScopeClaims).

| Scope     | Claim                                                                                                                                                                                                                                                                                                                        |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `openid`  | (obligatoire) Renvoie la claim `sub`, qui identifie l’utilisateur de façon unique. Dans un ID Token, les claim `iss`, `aud`, `exp`, `iat` et `at_hash` seront aussi présentes. Pour en savoir plus sur les claim de l’ID Token, consultez [Structure de l’ID Token](/fr-CA/docs/secure/tokens/id-tokens/id-token-structure). |
| `profile` | Renvoie des claim qui représentent les renseignements de base du profil, y compris `name`, `family_name`, `given_name`, `middle_name`, `nickname`, `picture` et `updated_at`.                                                                                                                                                |
| `email`   | Renvoie la claim `email`, qui contient l’adresse de courriel de l’utilisateur, ainsi que `email_verified`, qui est une valeur booléenne indiquant si l’adresse de courriel a été vérifiée par l’utilisateur.                                                                                                                 |

Pour obtenir un exemple montrant comment demander des claim standard pour votre application, consultez [Exemples de cas d’utilisation : scopes et revendications](/fr-CA/docs/get-started/apis/scopes/sample-use-cases-scopes-and-claims).

<div id="learn-more">
  ## En savoir plus
</div>

* [Exemples de cas d’utilisation : scopes et claims](/fr-CA/docs/get-started/apis/scopes/sample-use-cases-scopes-and-claims)
* [Scopes](/fr-CA/docs/get-started/apis/scopes)
* [Créer des claims personnalisés](/fr-CA/docs/secure/tokens/json-web-tokens/create-custom-claims)
