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

# Appeler votre API à l’aide du flux de code d’autorisation

> Découvrez comment appeler votre propre API depuis des Regular Web Apps à l’aide du flux de code d’autorisation.

Ce tutoriel vous aidera à appeler votre propre API à l’aide du flux de code d’autorisation. Si vous souhaitez comprendre le fonctionnement de ce flux et pourquoi vous devriez l’utiliser, consultez [flux de code d’autorisation](https://auth0.com/docs/fr-ca/get-started/authentication-and-authorization-flow/authorization-code-flow.md). Si vous souhaitez apprendre à ajouter une fonctionnalité de connexion à votre Regular Web App, consultez [Add Login Using the flux de code d’autorisation](https://auth0.com/docs/fr-ca/get-started/authentication-and-authorization-flow/authorization-code-flow/add-login-auth-code-flow.md).

Auth0 permet à votre application d’implémenter facilement le flux de code d’autorisation (Code d’autorisation : Chaîne aléatoire générée par le serveur d’autorisation et renvoyée à l’application dans le cadre de la réponse d’autorisation lors de l’utilisation du flux de code d’autorisation (avec ou sans PKCE).) à l’aide de :

* [Quickstarts pour les Regular Web Apps](https://auth0.com/docs/fr-ca/quickstart/webapp) : La façon la plus simple d’implémenter ce flux.
* [Authentication API](https://auth0.com/docs/fr-ca/api/authentication.md) : Si vous préférez créer votre propre solution, poursuivez votre lecture pour apprendre à appeler directement notre API.

## Prérequis

**Avant de commencer ce tutoriel :**

* [Enregistrez votre application dans Auth0](https://auth0.com/docs/fr-ca/get-started/auth0-overview/create-applications/regular-web-apps.md).

  * Sélectionnez le **Type d’application** **Regular Web Apps**.
  * Ajoutez l’**URL de rappel autorisée** `{https://yourApp/callback}`.
  * Assurez-vous que les **Types d’octroi** de votre application incluent le **Code d’autorisation**. Pour savoir comment faire, consultez [Mettre à jour les types d’octroi](https://auth0.com/docs/fr-ca/get-started/applications/update-grant-types.md).
  * Si vous voulez que votre application puisse utiliser des [jetons d’actualisation](https://auth0.com/docs/fr-ca/secure/tokens/refresh-tokens), assurez-vous que les **Types d’octroi** de l’application incluent le **jeton d’actualisation**. Pour savoir comment faire, consultez [Mettre à jour les types d’octroi](https://auth0.com/docs/fr-ca/get-started/applications/update-grant-types.md). Pour en savoir plus sur les jetons d’actualisation, consultez [jetons d’actualisation](https://auth0.com/docs/fr-ca/secure/tokens/refresh-tokens).
* [Enregistrez votre API dans Auth0](https://auth0.com/docs/fr-ca/get-started/auth0-overview/set-up-apis.md)

  * Si vous voulez que votre API reçoive des jetons d’actualisation pour pouvoir obtenir de nouveaux jetons lorsque les précédents expirent, activez **Allow Offline Access**.

## Étapes

> [accordion] Autoriser un utilisateur
>
> Cette étape peut inclure un ou plusieurs des processus suivants :
>
> * Authentifier l’utilisateur
> * Rediriger l’utilisateur vers un fournisseur d’identité pour gérer l’authentification
> * Vérifier la présence de sessions actives d’authentification unique (SSO)
> * Obtenir le consentement de l’utilisateur pour le niveau de permission demandé, sauf si ce consentement a déjà été accordé.
>
> Pour autoriser l’utilisateur, votre application doit rediriger l’utilisateur vers l’[URL d’autorisation](https://auth0.com/docs/fr-ca/api/authentication.md#authorization-code-grant).
>
> #### Exemple d’URL d’autorisation
>
> ##### Paramètres
>
> Notez que pour autoriser un utilisateur lors de l’appel d’une API personnalisée, vous :
>
> * devez inclure un paramètre audience
> * pouvez inclure des scopes supplémentaires pris en charge par l’API cible
>
> | Nom du paramètre | Description |
> | - | - |
> | `response_type` | Indique le type d’identifiant qu’Auth0 renverra (`code` ou `token`). Pour ce flux, la valeur doit être `code`. |
> | `client_id` | Le Client ID de votre application. Vous trouverez cette valeur dans les [Paramètres de l’application](https://manage.auth0.com/#/Applications/\{yourClientId}/settings). |
> | `redirect_uri` | L’URL vers laquelle Auth0 redirigera le navigateur une fois que l’autorisation aura été accordée par l’utilisateur. Le code d’autorisation sera disponible dans le paramètre d’URL `code`. Vous devez indiquer cette URL comme URL de rappel valide dans vos [Paramètres de l’application](https://manage.auth0.com/#/Applications/\{yourClientId}/settings). **Avertissement :** Conformément à la [spécification OAuth 2.0](https://tools.ietf.org/html/rfc6749#section-3.1.2), Auth0 supprime tout ce qui suit le hash et ne prend *pas* en charge les fragments. |
> | `scope` | Précise les [scopes](https://auth0.com/docs/fr-ca/get-started/apis/scopes) pour lesquels vous souhaitez demander une autorisation, lesquels déterminent quelles claims (ou quels attributs utilisateur) vous souhaitez voir renvoyés. Ceux-ci doivent être séparés par une espace. Vous pouvez demander n’importe lequel des [scopes OpenID Connect (OIDC) standard](https://openid.net/specs/openid-connect-core-1_0.html#StandardClaims) concernant les utilisateurs, comme `profile` ou `email`, des [claims personnalisées](https://auth0.com/docs/fr-ca/secure/tokens/json-web-tokens/json-web-token-claims.md#custom-claims) conformes à un [format avec espace de noms](https://auth0.com/docs/fr-ca/secure/tokens/json-web-tokens/create-custom-claims.md), ou tout scope pris en charge par l’API cible (p. ex. `read:contacts`). Incluez `offline_access` pour obtenir un [Refresh Token](https://auth0.com/docs/fr-ca/glossary?term=Refresh+Token) (assurez-vous que le champ **Allow Offline Access** est activé dans les [Paramètres de l’application](https://manage.auth0.com/#/applications)). |
> | `audience` | L’identifiant unique de l’API à laquelle votre application web veut accéder. Utilisez la valeur **Identifier** dans l’onglet [Paramètres](https://manage.auth0.com/#/apis) de l’API que vous avez créée dans le cadre des prérequis de ce tutoriel. |
> | `state` | (recommandé) Une chaîne alphanumérique arbitraire opaque que votre application ajoute à la requête initiale et qu’Auth0 inclut lors de la redirection vers votre application. Pour voir comment utiliser cette valeur afin de prévenir les attaques de falsification de requêtes intersites (CSRF), consultez [Mitiger les attaques CSRF avec les paramètres d’état](https://auth0.com/docs/fr-ca/secure/attack-protection/state-parameters.md). |
> | `organization` | (facultatif) ID de l’organisation à utiliser lors de l’authentification d’un utilisateur. Lorsqu’il n’est pas fourni, si votre application est configurée pour **Display Organization Prompt**, l’utilisateur pourra saisir le nom de l’organisation au moment de l’authentification. |
> | `invitation` | (facultatif) ID du ticket d’invitation à l’organisation. Lorsque vous [invitez un membre dans une organisation](https://auth0.com/docs/fr-ca/manage-users/organizations/configure-organizations/invite-members.md), votre application doit gérer l’acceptation de l’invitation en transmettant les paires clé-valeur `invitation` et `organization` lorsque l’utilisateur accepte l’invitation. |
>
> Par exemple, l’extrait HTML de votre URL d’autorisation pourrait ressembler à ceci lorsque vous ajoutez la connexion à votre application :
>
> #### Réponse
>
> Si tout se passe bien, vous recevrez une réponse `HTTP 302`. Le code d’autorisation est inclus à la fin de l’URL :
>
> ```http lines theme={null}
> HTTP/1.1 302 Found
> Location: {https://yourApp/callback}?code={authorizationCode}&state=xyzABC123
> ```

> [accordion] Jetons de requête
>
> Maintenant que vous disposez d'un code d'autorisation, vous devez l'échanger contre des jetons. À l'aide du code d'autorisation extrait (`code`) à l'étape précédente, vous devrez effectuer un `POST` vers l'[URL du jeton](https://auth0.com/docs/fr-ca/api/authentication.md#authorization-code).
>
> #### Exemple de POST vers l'URL du jeton
>
> ##### Paramètres
>
> | Nom du paramètre | Description |
> | - | - |
> | `grant_type` | Réglez ce paramètre à `authorization_code`. |
> | `code` | Le `authorization_code` récupéré à l’étape précédente de ce tutoriel. |
> | `client_id` | Le Client ID de votre application. Vous trouverez cette valeur dans les [Paramètres de l’application](https://manage.auth0.com/#/Applications/\{yourClientId}/settings). |
> | `client_secret` | Le secret client de votre application. Vous trouverez cette valeur dans les [paramètres de l’application](https://manage.auth0.com/#/Applications/\{yourClientId}/settings). Pour en savoir plus sur les méthodes d’authentification d’application disponibles, consultez [Identifiants de l’application](https://auth0.com/docs/fr-ca/secure/application-credentials.md). |
> | `redirect_uri` | L’URL de rappel valide définie dans les paramètres de votre application. Elle doit correspondre exactement au `redirect_uri` transmis à l’URL d’autorisation à l’étape précédente de ce tutoriel. Notez qu’elle doit être encodée pour une URL. |
>
> #### Réponse
>
> Si tout se passe bien, vous recevrez une réponse `HTTP 200` avec une charge utile contenant les valeurs `access_token`, `refresh_token`, `id_token` et `token_type` :
>
> ```json lines theme={null}
> {
>   "access_token": "eyJz93a...k4laUWw",
>   "refresh_token": "GEbRxBN...edjnXbL",
>   "id_token": "eyJ0XAi...4faeEoQ",
>   "token_type": "Bearer"
> }
> ```
>
> > [!WARNING]
> >
> > Validez vos jetons avant de les enregistrer. Pour savoir comment, consultez [Valider les jetons d’identité](https://auth0.com/docs/fr-ca/secure/tokens/id-tokens/validate-id-tokens.md) et [Valider les jetons d’accès](https://auth0.com/docs/fr-ca/secure/tokens/access-tokens/validate-access-tokens.md).
>
> [Les jetons d'ID](https://auth0.com/docs/fr-ca/secure/tokens/id-tokens.md) contiennent des informations sur l'utilisateur qui doivent être décodées et extraites.
>
> Les [jetons d'accès](https://auth0.com/docs/fr-ca/secure/tokens/access-tokens.md) sont utilisés pour appeler le [point de terminaison /userinfo de l'API d'authentification Auth0](https://auth0.com/docs/fr-ca/api/authentication.md#get-user-info) ou une autre API. Si vous appelez votre propre API, la première chose que votre API devra faire est de [vérifier le jeton d'accès](https://auth0.com/docs/fr-ca/secure/tokens/access-tokens/validate-access-tokens.md).
>
> [Les jetons d’actualisation](https://auth0.com/docs/fr-ca/secure/tokens/refresh-tokens) servent à obtenir un nouveau jeton d’accès ou un jeton d’ID après l’expiration du précédent. Le `refresh_token` ne sera présent dans la réponse que si vous avez inclus la portée `offline_access` et activé **Allow Offline Access** pour votre API dans le tableau de bord.
>
> > [!WARNING]
> >
> > Les jetons d’actualisation doivent être stockés de façon sécurisée, puisqu’ils permettent à un utilisateur de rester authentifié pratiquement indéfiniment.

> [accordion] Effectuez un appel d’API
>
> Pour appeler votre API à partir d’une application Web traditionnelle, l’application doit transmettre le jeton d’accès récupéré comme jeton Bearer dans l’en-tête Authorization de votre requête HTTP.

> [accordion] Échanger un jeton d’actualisation
>
> Vous avez déjà reçu un [jeton d'actualisation](https://auth0.com/docs/fr-ca/secure/tokens/refresh-tokens) si vous avez suivi ce tutoriel et complété ce qui suit :
>
> * configuré votre API pour permettre l’accès hors ligne
> * inclus la portée `offline_access` lorsque vous avez lancé la requête d’authentification au moyen du [point de terminaison authorize](https://auth0.com/docs/fr-ca/api/authentication/authorization-code-flow/authorize-application.md).
>
> Vous pouvez utiliser le Refresh Token pour obtenir un nouveau jeton d'accès. En général, un utilisateur n'aura besoin d'un nouveau jeton d'accès qu'après l'expiration du précédent ou lors de l'accès à une nouvelle ressource pour la première fois. Il est déconseillé d'envoyer une requête à l'endpoint pour obtenir un nouveau jeton d'accès chaque fois que vous effectuez une requête vers une API. Auth0 applique des limites de débit qui restreignent le nombre de requêtes vers l'endpoint pouvant être exécutées avec le même jeton depuis la même adresse IP.
>
> Pour actualiser votre jeton, effectuez une requête `POST` vers le point de terminaison `/oauth/token` de l’API d’authentification, en utilisant `grant_type=refresh_token`.
>
> ##### Exemple de POST vers l'URL du jeton
>
> ###### Paramètres
>
> | Nom du paramètre | Description |
> | - | - |
> | `grant_type` | Réglez cette valeur sur `refresh_token`. |
> | `client_id` | Le Client ID de votre application. Vous trouverez cette valeur dans [Application Settings](https://manage.auth0.com/#/Applications/\{yourClientId}/settings). |
> | `refresh_token` | Le jeton d’actualisation à utiliser. |
> | `scope` | (facultatif) Une liste des portées demandées, séparées par des espaces. Si ce paramètre n’est pas envoyé, les portées d’origine seront utilisées ; sinon, vous pouvez demander un sous-ensemble de portées. Notez que ce paramètre doit être encodé dans l’URL. |
>
> ###### Réponse
>
> Si tout se passe bien, vous recevrez une réponse `HTTP 200` avec une charge utile contenant un nouvel `access_token`, sa durée de vie en secondes (`expires_in`), les valeurs de `scope` accordées et le `token_type`. Si le scope du jeton initial incluait `openid`, la réponse comprendra également un nouvel `id_token` :
>
> ```json lines theme={null}
> {
>   "access_token": "eyJ...MoQ",
>   "expires_in": 86400,
>   "scope": "openid offline_access",
>   "id_token": "eyJ...0NE",
>   "token_type": "Bearer"
> }
> ```
>
> > [!WARNING]
> >
> > Validez vos jetons avant de les enregistrer. Pour savoir comment, consultez [Valider les jetons d’identité](https://auth0.com/docs/fr-ca/secure/tokens/id-tokens/validate-id-tokens.md) et [Valider les jetons d’accès](https://auth0.com/docs/fr-ca/secure/tokens/access-tokens/validate-access-tokens.md).

### Exemples de scénarios d’utilisation

#### Personnaliser les jetons

Vous pouvez utiliser Auth0 Actions pour modifier les permissions d’un jeton d’accès (Jeton d’accès : information d’identification d’autorisation, sous la forme d’une chaîne opaque ou d’un JWT, utilisée pour accéder à une API.) et/ou ajouter des demandes personnalisées aux jetons d’accès et aux jetons d’ID (Jeton d’identification : information d’identification destinée au client lui-même, plutôt que pour accéder à une ressource.). Pour en savoir plus sur Auth0 Actions, consultez [Comprendre le fonctionnement d’Auth0 Actions.](https://auth0.com/docs/fr-ca/customize/actions/actions-overview.md)

Pour ce faire, ajoutez l’Action Post-Login suivante, qui s’exécutera une fois l’utilisateur authentifié :

```js lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  // Ajouter des revendications personnalisées au jeton d'accès et au jeton d'identité
  api.accessToken.setCustomClaim('https://foo/bar', 'value');
  api.idToken.setCustomClaim('https://fiz/baz', 'some other value');

  // Modifier la portée du jeton d'accès
  api.transaction.addTargetScope('read:reports');
  api.transaction.addTargetScope('write:reports');
};
```

Auth0 évalue les permissions cibles finales en fonction des politiques d’autorisation et des exigences de consentement applicables. Pour en savoir plus, consultez [Gestion des permissions dans les Actions](https://auth0.com/docs/fr-ca/customize/actions/handling-scopes-in-actions.md).

> [!WARNING]
>
> Auth0 renvoie les informations du profil dans un format de demande structuré, tel que défini par la [spécification OpenID Connect (OIDC)](https://openid.net/specs/openid-connect-core-1_0.html#StandardClaims). Cela signifie que les demandes personnalisées ajoutées aux jetons d’ID ou aux jetons d’accès doivent [respecter les directives et les restrictions](https://auth0.com/docs/fr-ca/secure/tokens/json-web-tokens/create-custom-claims.md) afin d’éviter d’éventuels conflits.

## En savoir plus

* [Cadre d’autorisation OAuth 2.0](https://auth0.com/docs/fr-ca/authenticate/protocols/oauth.md)
* [Protocole OpenID Connect](https://auth0.com/docs/fr-ca/authenticate/protocols/openid-connect-protocol.md)
* [Jetons](https://auth0.com/docs/fr-ca/secure/tokens.md)
