> ## 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.

# Délégation

> Point de terminaison obsolète qui génère un jeton de délégation pour transmettre l’identité de l’utilisateur depuis une application vers un module complémentaire d’API.

<div id="endpoint">
  ## Point de terminaison
</div>

`POST /delegation`

<Note>
  Par défaut, cette fonctionnalité est désactivée pour les locataires qui n’utilisaient aucun module complémentaire au 8 juin 2017. Les anciens locataires qui utilisent actuellement un module complémentaire nécessitant la délégation peuvent continuer à utiliser cette fonctionnalité. Si la fonctionnalité de délégation est modifiée ou retirée du service, les clients qui l’utilisent actuellement en seront avisés à l’avance et disposeront de suffisamment de temps pour effectuer la migration.
</Note>

Un jeton de délégation peut être obtenu et utilisé lorsqu’une application doit appeler l’API d’un module complémentaire d’application, comme Firebase ou SAP, enregistré et configuré dans Auth0, dans le même locataire que le programme appelant.

À partir d’un jeton existant, ce point de terminaison génère un nouveau jeton signé avec le secret de l’application `target`. Cela permet de transmettre l’identité de l’utilisateur de l’application à une API.

<div id="remarks">
  ### Remarques
</div>

* La valeur de scope `profile` demande l’accès aux revendications de profil par défaut de l’utilisateur final, soit : `name`, `family_name`, `given_name`, `middle_name`, `nickname`, `preferred_username`, `profile`, `picture`, `website`, `gender`, `birthdate`, `zoneinfo`, `locale` et `updated_at`.

* La valeur de scope `email` demande l’accès aux revendications `email` et `email_verified`.

* La délégation n’est **pas prise en charge** dans la version 8 de [auth0.js](https://auth0.com/docs/libraries/auth0js). Pour voir un exemple avec la version 7 de la bibliothèque, consultez le [guide de référence auth0.js v7](https://auth0.com/docs/libraries/auth0js/v7).

* Ce point de terminaison est limité à 10 requêtes par minute pour une même adresse IP et un même `user_id`.

* Ce point de terminaison retourne trois en-têtes de réponse HTTP qui fournissent des données pertinentes sur ses limites de débit :
  * `X-RateLimit-Limit` : nombre de requêtes autorisées par minute.
  * `X-RateLimit-Remaining` : nombre de requêtes disponibles. Chaque nouvelle requête réduit ce nombre de 1. À chaque minute écoulée, une requête est rajoutée, ce qui augmente ce nombre de 1.
  * `X-RateLimit-Reset` : temps restant avant la réinitialisation de la limite de débit (`X-RateLimit-Limit`). La valeur est exprimée en [secondes d’époque Unix (UTC)](https://en.wikipedia.org/wiki/Unix_time).

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

* [Jetons de délégation](https://auth0.com/docs/secure/tokens/delegation-tokens)
* [Stratégie de limitation du nombre de requêtes de l’API Auth0](https://auth0.com/docs/troubleshoot/customer-support/operational-policies/rate-limit-policy)

<div id="response-messages">
  ## Messages de réponse
</div>

| Statut | Description                              |
| ------ | ---------------------------------------- |
| 200    | Obtention réussie du jeton de délégation |
