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 ?

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
- Le serveur contrôle le jeton parent : valide, ni expiré ni révoqué.
- invoices:read figure dans le périmètre du parent et dans le plafond du sous-agent.
- L’API du grand livre est sur la liste des API permises au sous-agent.
- 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
- Le parent a bien payments:create.
- 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
Étape 1. Jeton parent. Signature, émetteur, ni expiré ni révoqué. Un parent mort n’a pas d’enfants.
- Jeton parent Signature, émetteur, ni expiré ni révoqué. Un parent mort n’a pas d’enfants.
- Acteur L’identité du sous-agent est valide, et il peut agir pour ce parent.
- Profondeur Les sous-agents de sous-agents s’arrêtent à une profondeur fixe, par exemple 3.
- 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.
- 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.
- É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.
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
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.
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 besoinSuivre les notes techniques
Recevez les nouveaux articles sur l’IA en production et les smart contracts par email.