Contexte de l’agent dans les Actions

Accédez à l’identité et aux métadonnées de l’agent dans les Actions Auth0 à l’aide de l’objet event.agent.

Lorsqu’une requête implique un client lié à un agent, l’environnement d’exécution des Actions expose un objet event.agent. Cet objet est absent lorsqu’aucun agent n’est impliqué; le code Actions existant n’est donc pas affecté.

​

Déclencheurs

event.agent est présent dans les déclencheurs suivants :

Déclencheur	Lorsque event.agent est présent
credentials-exchange	Octroi de type Client Credentials lorsque agent_id est défini pour le client.
post-login	Code d’autorisation, échange de jetons ou flux d’appareil lorsque agent_id est défini pour le client.

​

Objet event.agent

L’objet event.agent a le schéma suivant :

{
  "agent_id": "agt_72jbvv7LfRKYp59gtRLtkn",
  "agent_metadata": {
    "env": "prod"
  }
}

event.client reste inchangé ; il continue de refléter le client OAuth lié qui a authentifié la requête.

​

Exemple : revendications personnalisées dans les jetons d’agent

Utilisez event.agent dans une action credentials-exchange pour ajouter le contexte de l’agent aux jetons d’accès :

exports.onExecuteCredentialsExchange = async (event, api) => {
  if (event.agent) {
    api.accessToken.setCustomClaim('agent_env', event.agent.agent_metadata?.env);
    api.accessToken.setCustomClaim('agent_id', event.agent.agent_id);
  }
};

Pour en savoir plus sur la création d’Actions, consultez Write Your First Action.