ALLER AU CONTENU
AGENTS IA7 minAgents en production / Ép. 13 · Niveau 13-2

Droits d’un sous-agent : les réduire par l’échange de jetons

Votre orchestrateur peut payer des factures. Le sous-agent qui se contente de les lire doit-il avoir les mêmes droits ?

XIN
Scène nocturne en pixel art : un petit robot, devant une borne lumineuse, échange une grande clé maîtresse en laiton contre une minuscule clé turquoise reliée à son poignet par un fil de lumière, sous un sablier qui s’écoule.

EN 30 SECONDES

L’échange de jetons est une requête où un sous-agent remet au serveur d’autorisation le jeton de son parent et sa propre identité, et demande un jeton plus restreint. Dans mon montage, le serveur décide jusqu’où restreindre : une API, une partie du périmètre, une expiration jamais postérieure à celle du parent.

À RETENIR · 3

  • L’échange de jetons RFC 8693 permet au sous-agent de troquer le jeton du parent et sa propre identité contre un jeton plus restreint, si le serveur d’autorisation accepte l’échange.
  • Dans mon montage, c’est le serveur d’autorisation qui restreint les droits, pas l’agent : un périmètre inclus dans celui du parent, une API par jeton, une expiration jamais postérieure à celle du parent.
  • La révocation ne se propage pas toute seule : vérifiez le parent à chaque échange, et dans vos API si quelques minutes de délai comptent.
Sur cette page

L’échange de jetons : une requête, un jeton plus restreint

EN BREF En une requête, le sous-agent remet le jeton du parent et sa propre identité, et reçoit un jeton pour une seule tâche.

LES MOTS À CONNAÎTRE

Serveur d’autorisation
Le serveur qui vérifie qui demande et délivre les jetons d’accès, selon OAuth, le cadre d’autorisation courant du web. Il décide, l’agent ne fait que demander.
Échange de jetons
Demander au serveur d’autorisation de troquer un jeton contre un autre. La RFC 8693 en fixe les règles ; le serveur décide jusqu’où le nouveau est restreint.
Périmètre (scope)
La liste des actions qu’un jeton autorise, par exemple lire des factures sans pouvoir créer de paiement.

Échange de jetons Demander au serveur d’autorisation de troquer un jeton contre un autre. La RFC 8693 en fixe les règles ; le serveur décide jusqu’où le nouveau est restreint. Voir le glossaire est défini par la RFC 8693, une RFC publiée sur la voie normative (Standards Track). En plus des deux jetons, le sous-agent nomme l’API qu’il veut appeler et le Périmètre (scope) La liste des actions qu’un jeton autorise, par exemple lire des factures sans pouvoir créer de paiement. Voir le glossaire dont il a besoin.

Le Serveur d’autorisation Le serveur qui vérifie qui demande et délivre les jetons d’accès, selon OAuth, le cadre d’autorisation courant du web. Il décide, l’agent ne fait que demander. Voir le glossaire garde aussi un plafond par sous-agent : le maximum qu’il peut détenir, quels que soient les droits de son parent.

UN EXEMPLE CONCRET

Chiffres illustratifs

VALIDÉLe sous-agent de collecte demande à lire des factures

ENTRÉE

Périmètre du parent
invoices:read payments:create
Expiration du parent
dans 30 min
Plafond du sous-agent
invoices:read
Demande
invoices:read sur l’API du grand livre

CE QUI SE PASSE

  1. Le serveur contrôle le jeton parent : valide, ni expiré ni révoqué.
  2. invoices:read figure dans le périmètre du parent et dans le plafond du sous-agent.
  3. L’API du grand livre est sur la liste des API permises au sous-agent.
  4. L’expiration retenue est la plus proche des deux : celle du parent, ou l’instant présent plus cinq minutes.

SORTIE

Périmètre
invoices:read
API
grand livre seulement
Expiration
dans 5 min
Lié à
la clé DPoP du sous-agent

REFUSÉLe même sous-agent demande à créer des paiements

ENTRÉE

Demande
payments:create

CE QUI SE PASSE

  1. Le parent a bien payments:create.
  2. Le plafond du sous-agent, non : il ne reste rien à accorder.

SORTIE

Résultat
400 invalid_scope (mon choix d’erreur), aucun jeton

La RFC 8693 distingue deux cas. Avec l’usurpation d’identité (impersonation), A devient impossible à distinguer de B. Avec la délégation, A garde sa propre identité et agit pour le compte de B.

EN CLAIR

C’est la délégation qu’il vous faut. Le nouveau jeton l’inscrit dans son champ act (une claim), celui qui désigne l’acteur.

Coming up next: Mais qu’est-ce qui empêche un sous-agent de demander davantage ?

Comment donner à un sous-agent moins de droits que son parent ?

EN BREF La restriction des droits n’existe que si le serveur d’autorisation l’impose, contrôle par contrôle.

La RFC 8693 permet au client de demander un périmètre plus restreint. Elle n’y oblige personne.

Un agent qui demande poliment moins n’est pas un contrôle : un agent victime d’une injection de prompt peut tout aussi poliment demander davantage.

LA RESTRICTION CÔTÉ SERVEUR

Diagramme de flux : 6 étapesDiagramme de flux : 6 étapes. Contrôler le jeton parent, puis Authentifier l’acteur. Authentifier l’acteur, puis Plafonner la profondeur. Plafonner la profondeur, puis Croiser les périmètres. Croiser les périmètres, puis Vérifier le destinataire. Vérifier le destinataire, puis Émettre le jeton.1Contrôler le jeton parent2Authentifier l’acteur3Plafonner la profondeur4Croiser les périmètres5Vérifier le destinataire6Émettre le jeton
Le périmètre demandé doit tenir dans celui du parent et dans le plafond de cet acteur. Vide veut dire refus, pas « tout ».

Étape 1. Jeton parent. Signature, émetteur, ni expiré ni révoqué. Un parent mort n’a pas d’enfants.

Choisissez une étape pour la voir bouger
  1. Jeton parent Signature, émetteur, ni expiré ni révoqué. Un parent mort n’a pas d’enfants.
  2. Acteur L’identité du sous-agent est valide, et il peut agir pour ce parent.
  3. Profondeur Les sous-agents de sous-agents s’arrêtent à une profondeur fixe, par exemple 3.
  4. Trop large : refusé Le sous-agent demande payments:create. Une fois la demande croisée avec le périmètre du parent et le plafond du sous-agent, il ne reste rien : aucun jeton.
  5. Destinataire Si le périmètre tient dans les deux, le serveur vérifie que l’API visée est sur la liste de cet acteur.
  6. Émission Le jeton expire au plus tard avec le parent, nomme chaque acteur de la chaîne et ne marche qu’avec la clé du sous-agent.
Tout contrôle qui échoue bloque la demande. Les contrôles les moins coûteux passent en premier. Cela limite ce qu’obtient un agent piégé, pas l’injection.

Avec le plafond par acteur, même un parent très large ne peut pas donner au sous-agent le droit de payer. Et l’expiration est fixée à la première des deux échéances : celle du parent ou celle de l’acteur (sa durée de vie, ou TTL) : une fois le jeton de l’orchestrateur expiré, tout son arbre disparaît en quelques minutes.

OBJET OBTENU

Le serveur restreint, pas l’agent

Un périmètre inclus dans celui du parent et dans le plafond de l’acteur, une API par jeton, une expiration jamais postérieure à celle du parent.

La révocation, c’est autre chose. Selon la RFC 8693, la propager ne fait pas partie, en général, de ce que garantit le protocole du service de jetons (STS). Mon serveur vérifie donc la révocation du parent à chaque échange.

ATTENTION

Les jetons enfants déjà émis restent valides pendant leurs quelques minutes, sauf si vos API vérifient aussi la révocation.

Associer les refus à invalid_request, invalid_scope et invalid_target, c’est mon choix. La RFC 8693 définit invalid_target pour les destinataires (audiences) que le serveur ne sait pas prendre en charge.

FAQ

Par l’échange de jetons RFC 8693 : le sous-agent envoie le jeton du parent et sa propre identité, et demande un périmètre pour une seule API. Dans mon montage, le serveur vérifie que le périmètre est inclus, que l’API est permise et que la chaîne de délégation n’est pas trop longue. L’expiration ne dépasse jamais celle du parent.

NIVEAU TERMINÉ

Ce que vous savez maintenant

  • Comment un sous-agent obtient son propre jeton, plus restreint : il échange le jeton du parent et sa propre identité, en une requête RFC 8693.
  • Qui décide jusqu’où restreindre, dans mon montage : le serveur d’autorisation, d’après le périmètre du parent, le plafond de l’acteur et la liste d’API permises à l’acteur.

Vérifiez par vous-même

Touchez ou cliquez une question pour voir la réponse.

Cas fictif : un jeton parent expire dans 2 minutes, et la durée de vie maximale du sous-agent (TTL) est de 5 minutes. Quand son nouveau jeton expire-t-il ?

Dans 2 minutes. Le serveur retient la première des deux échéances : un enfant ne survit jamais à son parent.

Niveau suivant :Comment empêcher un jeton copié de servir, et les standards ont-ils tranché ?7 min
Adam Boudjemaa
Adam Boudjemaa

Ingénieur web3 x IA, ancien CTO d’Integra. Auteur nommé (1 sur 5) d’ERC-3643, premier auteur d’ERC-6960, co-auteur d’ERC-7410 et co-auteur d’ERC-8203, encore à l’état de brouillon.

Un projet à livrer ou un poste à pourvoir ?

Parlons de votre besoin

Mon travail entre web3 et IAMes outils open source

Suivre les notes techniques

Recevez les nouveaux articles sur l’IA en production et les smart contracts par email.