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

Agent IA sans clé d’API : des accès de quelques minutes

Votre agent détient une clé d’API qui peut rester valable des mois, pour quiconque la copie. Que devrait-il détenir à la place ?

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’authentification d’un agent sans clé d’API est un montage où l’agent prouve qui il est avec sa propre identité, puis obtient un jeton valable quelques minutes et qui n’ouvre qu’une seule API. Une clé copiée-collée dure en général des mois et donne trop de droits.

À RETENIR · 3

  • Une clé d’API copiée-collée, valable des mois, n’a rien à faire dans un agent IA : elle peut fuir dans les journaux, elle est transmise à chaque sous-agent, et une injection de prompt suffit pour que le modèle la recrache.
  • Donnez à chaque agent sa propre identité de plateforme, puis échangez-la contre un jeton valable quelques minutes pour une seule API.
  • Un brouillon de l’IETF sur l’identité des agents interdit au modèle d’accéder aux identifiants de l’agent. C’est un Internet-Draft : il peut encore changer.
Sur cette page

Pourquoi une clé d’API copiée-collée est le mauvais choix pour un agent

EN BREF Une clé d’API copiée-collée confie votre secret le plus durable au processus le plus exposé de votre infrastructure.

LES MOTS À CONNAÎTRE

Clé d’API
Une longue chaîne secrète qui donne accès à un compte d’API à quiconque la présente. Celui qui la copie peut s’en servir aussi.
Jeton d’accès
Un laissez-passer qu’une API accepte à la place d’un mot de passe. Il donne des droits limités et, dans cet épisode, expire en quelques minutes.
Identité de workload
Une identité que la plateforme donne à un programme en cours d’exécution, au moyen d’un justificatif qu’elle émet. Personne n’a à la copier-coller.

Quelqu’un colle une Clé d’API Une longue chaîne secrète qui donne accès à un compte d’API à quiconque la présente. Celui qui la copie peut s’en servir aussi. Voir le glossaire dans une variable d’environnement. L’agent la partage avec chaque sous-agent, ces agents auxiliaires à qui il confie une partie du travail. La clé reste en général valable des mois et donne bien plus de droits qu’une tâche n’en demande.

Dans un agent, trois choses déraillent d’un coup :

  • la clé peut finir dans les journaux et les vidages mémoire ;
  • chaque sous-agent en hérite en entier ;
  • le modèle n’est qu’à une injection de prompt de la recracher.

EN CLAIR

Une injection de prompt est une attaque qui glisse des consignes au modèle, par exemple cachées dans une page web ou un e-mail que l’agent lit. Des jetons courts et restreints limitent ce qu’elle atteint, pas l’attaque elle-même.

DEUX FAÇONS DE DONNER UN ACCÈS À UN AGENT

La clé copiée-collée

Un secret durable dans une variable d’environnement, partagé par l’agent principal et chaque sous-agent. Il marche partout où le compte a accès, pour quiconque le copie.

Le jeton échangé

Émis pour chaque sous-agent à partir de sa propre identité. Il ouvre une seule API, avec une partie des droits du parent, pendant cinq minutes. Lié à une clé que l’agent détient. Jamais visible par le modèle.
Illustratif. La colonne de droite est le montage que construit cet épisode.

Ce dernier point n’est pas de moi. L’IETF, qui élabore les standards d’Internet, en fait une règle dans le brouillon de son groupe de travail sur l’identité des agents, un Internet-Draft qui peut encore changer :

The Large Language Model MUST NOT have access to an agent’s credentials or to credentials that may be needed to access tools and services.

draft-ietf-wimse-aims-00

Autrement dit, le modèle ne doit voir ni les secrets de l’agent ni ceux qui ouvrent ses outils. Le jeton reste dans le code qui fait l’appel HTTP, pas dans le contexte du modèle.

Dans l’épisode sur le moindre privilège pour les agents qui paient, j’ai plaidé pour des identifiants de courte durée, limités à une tâche, sans aller plus loin que le principe.

Coming up next: Alors, que porte un agent à la place d’une clé ?

Comment un agent IA s’authentifie-t-il quand personne n’est là ?

EN BREF Partez de l’identité, pas d’un secret : la plateforme identifie l’agent, puis le serveur d’autorisation transforme cette identité en jeton restreint.

Un agent sans interface tourne sans personne devant l’écran : personne ne peut cliquer sur « autoriser ». Il lui faut sa propre Identité de workload Une identité que la plateforme donne à un programme en cours d’exécution, au moyen d’un justificatif qu’elle émet. Personne n’a à la copier-coller. Voir le glossaire, fournie par la plateforme qui l’exécute.

Le justificatif qui la prouve a une courte durée de validité. Préférez un format lié à une clé créée sur le workload, comme un X.509-SVID (un certificat) ou un jeton d’identité de workload WIMSE. Le brouillon de l’IETF range les JWT-SVID parmi les identifiants au porteur de courte durée : quiconque en détient un peut s’en servir.

LE FLUX QUE JE CONSTRUIRAIS

Diagramme de séquence : 5 participants : Plateforme de workload, Agent orchestrateur, Sous-agent de collecte, Serveur d’autorisation, API du grand livreDiagramme de séquence : 5 participants : Plateforme de workload, Agent orchestrateur, Sous-agent de collecte, Serveur d’autorisation, API du grand livre. Étape 1 : Plateforme de workload vers Agent orchestrateur, Délivrer une identité de courte durée. Étape 2 : Agent orchestrateur vers Serveur d’autorisation, Obtenir un jeton pour sa propre identité. Étape 3 : Plateforme de workload vers Sous-agent de collecte, Délivrer au sous-agent sa propre identité. Étape 4 : Sous-agent de collecte vers Serveur d’autorisation, Échanger : jeton parent et sa propre identité. Étape 5 : Serveur d’autorisation vers Sous-agent de collecte, Jeton plus restreint, cinq minutes, lié à sa clé. Étape 6 : Sous-agent de collecte vers API du grand livre, Appeler avec le jeton et une preuve fraîche.PLATEFORME DE WORKLOAD >AGENT ORCHESTRATEURDélivrer une identité decourte duréeAGENT ORCHESTRATEUR > SERVEURD’AUTORISATIONObtenir un jeton pour sapropre identitéPLATEFORME DE WORKLOAD >SOUS-AGENT DE COLLECTEDélivrer au sous-agent sapropre identitéSOUS-AGENT DE COLLECTE >SERVEUR D’AUTORISATIONÉchanger : jeton parent et sapropre identitéSERVEUR D’AUTORISATION >SOUS-AGENT DE COLLECTEJeton plus restreint, cinqminutes, lié à sa cléSOUS-AGENT DE COLLECTE > APIDU GRAND LIVREAppeler avec le jeton et unepreuve fraîche

Étape 1. Identité. La plateforme donne à l’orchestrateur un justificatif d’identité de courte durée, lié à une clé créée sur le workload. Aucun humain ne le copie.

Choisissez une étape pour la voir bouger
  1. Identité La plateforme donne à l’orchestrateur un justificatif d’identité de courte durée, lié à une clé créée sur le workload. Aucun humain ne le copie.
  2. Son propre jeton L’orchestrateur prouve cette identité et obtient son propre jeton d’accès.
  3. Identité du sous-agent La plateforme donne aussi au sous-agent sa propre identité : les journaux pourront nommer le processus qui a agi.
  4. Échange Le sous-agent envoie le jeton parent et sa propre identité, et demande un périmètre pour une seule API, avec une preuve DPoP signée par sa clé privée.
  5. Jeton restreint Le serveur vérifie la demande et renvoie un jeton valable cinq minutes au plus, qui ne marche qu’avec la clé du sous-agent.
  6. Appel Le sous-agent appelle l’API du grand livre avec le jeton et une preuve fraîche. L’API vérifie signature, expiration, cible, périmètre et clé.
Un orchestrateur (l’agent principal qui répartit le travail) lance un sous-agent de collecte, sans utilisateur présent. Seul le serveur d’autorisation décide du périmètre ; les agents ne font que demander.

Le sous-agent a sa propre identité : la piste d’audit peut dire quel processus a agi, au lieu de « c’est le compte de service ». Et il ne voit jamais l’identifiant de l’orchestrateur, seulement un jeton destiné à l’échange.

ADAM explique : Voyez la réception d’un hôtel qui code une carte par chambre, au lieu d’un passe-partout qui circule. Sauf qu’ici, le jeton exige aussi la clé privée de l’agent : copié seul, il n’ouvre rien tant que cette clé reste à l’abri.

Si vous n’avez qu’un agent, supprimez l’étape d’échange pour sous-agent et gardez le reste.

OBJET OBTENU

D’abord l’identité, puis un jeton restreint

La plateforme identifie l’agent. Le serveur d’autorisation en tire un jeton pour une seule API, valable quelques minutes.

NIVEAU TERMINÉ

Ce que vous savez maintenant

  • Pourquoi une clé copiée-collée est risquée dans un agent : elle peut durer des mois, passe à chaque sous-agent et peut fuir.
  • Ce qui la remplace : une identité de plateforme par agent, échangée contre un jeton valable quelques minutes pour une seule API.
  • Où se trouve le jeton : dans le code qui fait l’appel, jamais dans le contexte du modèle.

Vérifiez par vous-même

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

Votre agent travaille seul, sans sous-agent. Lui faut-il quand même une identité de workload ?

Oui. Seule l’étape d’échange pour sous-agent disparaît. L’agent prouve toujours sa propre identité et reçoit un jeton de courte durée pour une API.

Niveau suivant :Comment un sous-agent obtient-il moins de droits que l’agent qui l’a lancé ?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.