Échange d’identifiants

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

Diagramme illustrant le flux machine à machine des Actions et le moment où ses déclencheurs s’exécutent.

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

Modifier les permissions d’un jeton d’accès

Utilisez les méthodes api.transaction.* pour modifier les permissions dans le flux des identifiants du client. Les modifications se cumulent d’une Action à l’autre, et event.transaction.target_scopes reflète immédiatement l’ensemble en vigueur. Une fois toutes les Actions exécutées, Auth0 en calcule l’intersection avec l’autorisation accordée au client. L’Action suivante limite l’accès à la lecture des rapports :

/**
 * @param {Event} event - Détails sur la requête d’octroi par identifiants du client.
 * @param {CredentialsExchangeAPI} api - Interface dont les méthodes permettent de modifier le comportement de l’octroi par identifiants du client.
 */
exports.onExecuteCredentialsExchange = async (event, api) => {
  api.transaction.setTargetScopes(["read:reports"]);
};

Les méthodes de permission cible sont le seul moyen de modifier les permissions dans ce déclencheur. Les méthodes api.accessToken.addScope() et removeScope() ne sont pas disponibles. Pour en savoir plus, consultez Gestion des permissions dans les Actions.

Personnalisation de l’image de marque

Personnalisation du code

Personnalisation par des tiers

Échange d’identifiants

Références

Cas d’utilisation courants

Contrôle d’accès

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

Modifier les permissions d’un jeton d’accès

​Références

​Cas d’utilisation courants

​Contrôle d’accès

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

​Modifier les permissions d’un jeton d’accès

Références

Cas d’utilisation courants

Contrôle d’accès

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

Modifier les permissions d’un jeton d’accès