Skip to main content
L’agent comme mandant fait des agents d’IA des identités de première classe dans Auth0, distinctes des utilisateurs humains et des clients traditionnels de communication entre machines (M2M). Un agent est une entité enregistrée dotée d’un identifiant stable, de sa propre gestion du cycle de vie, de ses propres informations d’identification et de sa propre piste d’audit. Une fois enregistré comme principal Auth0, un agent peut :
  • agir au nom de l’utilisateur;
  • s’exécuter de façon autonome, sans session utilisateur;
  • participer à une délégation à sauts multiples par échange de jetons.

​
Cas d’utilisation

  • Agents autonomes : un agent d’IA utilise des informations d’identification de client pour appeler directement des API en son propre nom, son identité étant consignée dans les journaux et les jetons.
  • Accès délégué : un utilisateur autorise un agent d’IA à agir en son nom. L’agent échange le jeton d’accès de l’utilisateur contre un jeton délégué qui conserve l’utilisateur comme sujet et désigne l’agent comme acteur.
  • Chaînes à sauts multiples : un agent orchestrateur délègue à un sous-agent. La chaîne de délégation est préservée dans des demandes act imbriquées, ce qui permet une traçabilité complète à n’importe quel serveur de ressources.

​
Fonctionnement

L’agent comme mandant fonctionne en trois étapes : l’enregistrement, l’association du client et l’émission du jeton.
  1. Enregistrer l’agent : vous enregistrez un agent dans Auth0 à l’aide du Dashboard ou de la Management API. Auth0 crée un objet agent doté d’un agent_id stable qu’il est possible de suivre dans les jetons, les journaux et la Management API tout au long de son cycle de vie.
  2. Associer l’agent à un client : un agent ne possède pas d’information d’identification qui lui soit propre; il s’authentifie par l’entremise d’un ou de plusieurs clients associés. Un même agent peut être lié à plusieurs clients, ce qui est utile pour avoir des clients distincts par environnement ou par région tout en conservant une seule identité logique dans les journaux.
  3. Identité de l’agent dans les jetons : lorsqu’un client lié à un agent s’authentifie, Auth0 intègre l’identité de l’agent au jeton émis selon le type d’autorisation.
L’agent_id (ou l’external_agent_id, s’il est défini à la création) est également inscrit dans les journaux du locataire à chaque émission de jeton, ce qui vous procure une piste de vérification complète pour chaque agent. Vous pouvez aussi accéder à l’identité de l’agent dans les Actions au moyen de event.agent afin d’appliquer une logique personnalisée au moment de l’émission du jeton.

​
Conseils de migration

Migrez vos clients et serveurs de ressources existants afin d’utiliser l’agent comme mandant.

​
Clients

Les clients existants ne sont pas touchés, sauf si vous les associez explicitement à un agent. L’association à un agent est optionnelle et réversible. Pour en savoir plus, consultez Associer un agent à un client.

​
Serveurs de ressources

Pour recevoir les demandes sub_profile et client_profile, définissez agent_subject_claims: 'auth0-v1' dans la configuration du serveur de ressources visé. Cette option s’active individuellement pour chaque serveur de ressources. Pour en savoir plus, consultez Configurer un serveur de ressources pour recevoir les demandes de sujet d’agent.