Échange d’identifiants

Découvrez les Actions d’échange d’identifiants, qui s’exécutent lorsqu’un jeton d’accès est émis dans le cadre du flux machine à machine. Elles peuvent servir à rejeter l’échange ou à ajouter des revendications personnalisées au jeton d’accès.

Le déclencheur credentials-exchange s’exécute lorsqu’un jeton d’accès est émis dans le cadre du flux d’identifiants client, avant d’être renvoyé.

Les Actions de ce flux sont bloquantes (synchrones) : elles s’exécutent dans le cadre du processus du déclencheur et empêchent le reste du pipeline Auth0 de s’exécuter jusqu’à ce que l’Action soit terminée.

​

Références

• Objet d’événement : Fournit des informations contextuelles sur la requête d’échange d’identifiants client.
• Objet API : Fournit des méthodes permettant de modifier le comportement du flux.

​

Cas d’utilisation courants

​

Contrôle d’accès

Une Action credentials-exchange permet de rejeter un jeton d’accès selon une logique personnalisée :

/**
 * @param {Event} event - Détails sur la demande d’octroi des informations d’identification du client.
 * @param {CredentialsExchangeAPI} api - Interface dont les méthodes permettent de modifier le comportement de l’octroi des informations d’identification du client.
 */
exports.onExecuteCredentialsExchange = async (event, api) => {
  if (event.request.geoip.continentCode === "NA") {
    api.access.deny('invalid_request', "Access from North America is not allowed.");
  }
};

​

Ajouter des revendications personnalisées au jeton d’accès

Une Action credentials-exchange permet d’ajouter des revendications personnalisées à un jeton d’accès :

/**
 * @param {Event} event - Détails sur la requête de client credentials grant.
 * @param {CredentialsExchangeAPI} api - Interface dont les méthodes permettent de modifier le comportement du client credentials grant.
 */
exports.onExecuteCredentialsExchange = async (event, api) => {
  api.accessToken.setCustomClaim("https://my-api.exampleco.com/request-ip", event.request.ip);
};

Nous recommandons fortement d’utiliser une revendication personnalisée avec espace de noms sous la forme d’une URI. Pour en savoir plus sur les revendications personnalisées avec ou sans espace de noms, consultez Create Custom Claims.