Skip to main content
Une fois l’agent enregistré comme identité de premier ordre dans Auth0, vous pouvez l’associer à n’importe quel client OAuth. Un agent peut être associé à plusieurs clients. C’est utile lorsque vous souhaitez une seule identité logique d’agent, avec un agent_id unique visible dans les jetons et les journaux de plusieurs clients, par exemple des clients distincts par environnement ou par région. L’agent_id est stocké dans l’objet client, et les associations sont gérées de façon dynamique. Dès que vous associez un agent à un client, les jetons émis à ce client portent l’identité de l’agent comme sujet (sub) dans le cas des octrois par information d’identification client, ou comme acteur (act) dans le cas de l’échange de jetons et des 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 un external_agent_id ou non.

​
Associer un client à la création

Définissez le paramètre agent_id au moment de créer un client avec POST /api/v2/clients :
Vous utilisez l’interface de ligne de commande Auth0? Si ce n’est pas déjà fait, configurez et authentifiez votre session CLI avant d’exécuter cette commande.
Si l’opération réussit, Auth0 retourne l’objet client avec l’agent_id que vous avez défini.

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

Une fois que vous avez associé un agent_id à un client, envoyez une requête GET à /api/v2/clients/{id} pour obtenir l’objet client :
Si la requête réussit, 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 Auth0 Dashboard ou de la Management API.
  1. Accédez à Dashboard > Agents, sélectionnez l’agent, puis ouvrez son onglet Applications.
  2. Sélectionnez Add Application, puis choisissez les applications à associer à l’agent dans la fenêtre modale. Vous pouvez en sélectionner plusieurs.
  3. Sélectionnez Add Applications.
Une fois l’ajout réussi, les applications s’affichent sous l’onglet Applications de l’agent.

​
Supprimer l’association à l’agent

Pour dissocier un client de son agent, définissez agent_id à null au moyen de PATCH /api/v2/clients/{id} :
Après la dissociation, les nouveaux jetons émis au client ne portent plus l’identité de l’agent. Les jetons existants demeurent valides jusqu’à leur expiration.

​
Prochaines étapes