Associer un agent à un client

Associez un ou plusieurs clients à un agent afin que les jetons émis pour ces clients soient associés à l’identité de l’agent à des fins d’attribution et de traçabilité.

Une fois enregistré comme identité à part entière dans Auth0, vous pouvez associer un agent à n’importe quel client OAuth. Un agent peut être associé à plusieurs clients. C’est utile si vous voulez une même identité d’agent logique, avec un seul agent_id visible dans les jetons et les journaux de plusieurs clients, par exemple des clients distincts pour chaque environnement ou région.

L’agent_id est stocké dans l’objet client, et les associations sont gérées dynamiquement.

Une fois un agent associé à un client, les jetons émis pour ce client contiennent l’identité de l’agent comme sujet (sub) pour les autorisations Client Credentials, ou comme acteur (act) pour l’échange de jetons et les flux de connexion standards. Pour en savoir plus, consultez Identité de l’agent dans les jetons.

L’agent_id interne demeure l’identifiant utilisé pour gérer l’agent au moyen de la Management API, que vous ayez défini ou non un external_agent_id.

​

Associer un client à sa création

Définissez agent_id lors de la création d’un client au moyen de POST /api/v2/clients :

curl --request POST \
  --url 'https://YOUR_AUTH0_DOMAIN/api/v2/clients' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_MGMT_API_TOKEN' \
  --data '{
    "name": "My AI Client",
    "agent_id": "YOUR_AGENT_ID"
  }'

En cas de réussite, Auth0 renvoie l’objet client avec l’agent_id que vous avez défini.

​

Récupérer le client associé à l’agent

Après avoir associé un agent_id à un client, envoyez une requête GET à /api/v2/clients/{id} pour obtenir l’objet client :

curl --request GET \
  --url 'https://YOUR_AUTH0_DOMAIN/api/v2/clients/YOUR_CLIENT_ID' \
  --header 'Authorization: Bearer YOUR_MGMT_API_TOKEN'

En cas de réussite, Auth0 renvoie l’objet client avec l’agent_id que vous avez défini.

​

Associer un client existant

Vous pouvez associer un client existant à l’aide du Dashboard Auth0 ou de la Management API.

Dashboard Auth0

1. Accédez à Dashboard > Agents, sélectionnez l’agent, puis son onglet Applications.
2. Sélectionnez Add Application, puis les applications que vous souhaitez associer à l’agent dans la fenêtre modale. Vous pouvez en sélectionner plusieurs.
3. Sélectionnez Add Applications.

Une fois ajoutées, les applications s’affichent dans l’onglet Applications de l’agent.

Management API

Associez un client existant à un agent au moyen de PATCH /api/v2/clients/{id} :

curl --request PATCH \
  --url 'https://YOUR_AUTH0_DOMAIN/api/v2/clients/YOUR_CLIENT_ID' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_MGMT_API_TOKEN' \
  --data '{
    "agent_id": "YOUR_AGENT_ID"
  }'

En cas de réussite, Auth0 renvoie l’objet client mis à jour avec l’élément agent_id que vous avez défini.

​

Supprimer l’association avec l’agent

Pour dissocier un client de son agent, définissez agent_id sur null à l’aide de PATCH /api/v2/clients/{id} :

curl --request PATCH \
  --url 'https://YOUR_AUTH0_DOMAIN/api/v2/clients/YOUR_CLIENT_ID' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_MGMT_API_TOKEN' \
  --data '{
    "agent_id": null
  }'

Après la dissociation, les nouveaux jetons émis au client ne contiennent plus l’identité de l’agent. Les jetons existants demeurent valides jusqu’à leur expiration.

​

Prochaines étapes

• Découvrez comment Auth0 intègre l’identité de l’agent aux jetons