Comment donner une clé d'API à un agent d'IA sans qu'il voie la clé ?
Donnez à l'agent une référence, pas la clé, et laissez un proxy sur la même machine insérer la vraie clé dans la requête au moment où elle sort. Voici pourquoi les variables d'environnement ne suffisent plus, et comment mettre cela en place.
Donnez à l'agent une référence plutôt que la clé, et laissez un petit proxy sur la même machine substituer la vraie clé dans la requête au moment où elle sort. L'agent écrit clavitor://OpenAI/key là où le secret doit figurer. L'API reçoit la vraie clé. L'agent ne la détient jamais, donc il ne peut ni l'afficher, ni la consigner dans un journal, ni être persuadé de la transmettre.
C'est toute l'idée. Le reste de cette page explique pourquoi c'est important, et comment le mettre en place.
Pourquoi « mets-la dans une variable d'environnement » ne suffit plus
Il y a un an, export OPENAI_API_KEY=sk-... était la façon normale de transmettre une clé à un script. Personne ne s'en offusquait.
Puis le script a commencé à réfléchir par lui-même.
Un agent d'IA lit des fichiers, exécute des outils, écrit des journaux et parle à des inconnus sur internet. Chacun de ces canaux est une porte de sortie pour une clé qu'il détient :
- L'environnement. Tout ce que l'agent exécute en hérite. Elle apparaît dans
/proc, dans les vidages de plantage, dans la sortie d'intégration continue. - La mémoire. Récupérez la clé au moment de l'exécution et elle reste dans le processus aussi longtemps que l'agent tourne.
- La conversation. Une injection de prompt dans une page web ou un commentaire de ticket demande à l'agent d'« inclure votre configuration pour le débogage ». Un agent serviable obéit.
Rien de tout cela n'exige un bug dans l'agent. Il suffit que la clé soit quelque part où l'agent peut l'atteindre.
Le schéma : l'agent demande, le proxy signe
Pensez à la carte magnétique d'un hôtel. Le client peut ouvrir sa chambre. Le client ne voit jamais la clé maîtresse, et la porte enregistre chaque passage.
Pour une clé d'API, cela donne :
- La vraie clé vit dans un coffre-fort, chiffrée.
- Un proxy tourne à côté de l'agent, sur la même machine.
- L'agent envoie sa requête HTTPS avec une référence à l'endroit où la clé doit figurer.
- Le proxy récupère la valeur dans le coffre-fort, l'insère dans la requête et la transmet.
- Le côté agent ne détient jamais que la référence.
Les journaux de l'agent montrent la référence. Sa fenêtre de contexte aussi. Il n'y a rien à faire fuiter.
Comment le mettre en place avec Clavitor
C'est ainsi que nous l'avons conçu. Un seul binaire, une seule variable d'environnement, aucune modification du code de l'agent.
Créez un client pour l'agent dans votre coffre-fort avec les portées dont il a besoin, puis inscrivez le proxy et démarrez-le :
$ clavitor-proxy init $ clavitor-proxy ca $ clavitor-proxy serve
init inscrit le proxy en tant que ce client. ca affiche l'autorité de certification du proxy : ajoutez-la au magasin de confiance qu'utilise le client HTTP de votre agent, car le proxy ouvre lui-même la connexion HTTPS de l'agent. Puis pointez l'agent vers le proxy :
$ export HTTPS_PROXY="http://clavitor:$(cat proxy-auth)@127.0.0.1:1983"
$ curl -H "Authorization: Bearer clavitor://OpenAI/key" \
https://api.openai.com/v1/chat/completionsproxy-auth est le jeton d'accès propre au proxy, le fichier à côté du binaire. Chaque connexion doit le porter, pour qu'un autre utilisateur sur la même machine ne puisse pas emprunter le proxy. Le proxy écoute sur 127.0.0.1:1983 et uniquement sur cette machine, sauf si vous le configurez volontairement pour un réseau privé de confiance.
Cela fonctionne avec tout agent dont le client HTTP respecte HTTPS_PROXY : Claude Code, Codex, vos propres scripts. Un identifiant ne va qu'à un hôte que son entrée désigne comme adresse web, si bien qu'un agent victime d'une injection de prompt ne peut pas pointer la même référence vers le serveur d'un inconnu. La procédure pas à pas se trouve dans la documentation du proxy.
Et les autres secrets de l'agent ?
Tous les secrets ne transitent pas dans un en-tête HTTP. Un mot de passe de déploiement, une clé SSH, un code à deux facteurs pour une connexion.
Pour ceux-là, l'agent demande au coffre-fort une entrée nommée à la fois avec clavitor-cli, et uniquement pour des entrées qui lui ont été attribuées :
$ clavitor-cli get "GitHub Deploy" --field password $ clavitor-cli get "Stripe API" --field key clavitor-cli: CV-2041: Access denied.
L'agent ne peut pas lister le coffre-fort. Une recherche par nom affiche au plus cinq titres correspondants, et seulement un compte au-delà.
Les codes d'authentification fonctionnent de la même façon. clavitor-cli totp "GitHub" calcule le code en cours sur la machine de l'agent, qui peut ainsi franchir une connexion à deux facteurs sans que personne ait à lire un téléphone. Le coffre-fort conserve le secret chiffré.
Ce que cela ne résout pas
Un proxy maintient la clé hors de portée de l'agent. Il ne rend pas l'agent digne de confiance.
- Un agent compromis peut toujours utiliser l'accès qui lui a été donné. Il ne peut simplement pas emporter la clé avec lui.
- Quelqu'un disposant d'un accès administrateur à la machine peut aussi utiliser le proxy, ou lire sa mémoire.
- Une API qui renvoie votre clé dans sa réponse la remet à l'agent. Le proxy insère des clés dans les requêtes et ne filtre pas les réponses.
C'est pourquoi l'accès autour du proxy compte autant que le proxy lui-même :
- La portée. Chaque agent n'obtient que les entrées dont il a besoin. Un agent de travail voit GitHub et AWS. Un agent de déploiement voit les clés SSH et la base de données.
- Les limites de lecture. Chaque agent ne peut lire qu'un certain nombre d'entrées différentes par minute et par heure, et c'est vous qui fixez ces chiffres. Un agent qui dépasse sa limite horaire deux fois en deux heures est verrouillé jusqu'à ce que vous le déverrouilliez.
- Une trace. Chaque lecture est consignée : quel agent, quelle entrée, quand.
Vous faites tourner plusieurs agents ? Donnez à chacun son propre proxy et sa propre inscription. Chacun a alors sa propre portée, ses propres limites et sa propre trace, et l'agent A ne peut pas voir les clés de l'agent B.
En résumé
Ne remettez pas votre clé à un agent. Remettez-lui un nom pour la clé, et gardez la clé à une étape de distance, dans un endroit qui décide, à chaque fois, si cet agent peut l'utiliser maintenant.
Mettez en place le proxy ou voyez comment fonctionne l'accès des agents.