Security Blog

Claude Code peut-il utiliser mes codes 2FA sans voir le secret ?

#45

November 22, 2026 · By Mila

← All posts

Oui. Conservez le secret d'authentification dans un coffre-fort, et laissez l'agent demander le code, jamais le secret. `clavitor-cli totp "GitHub"` calcule les six chiffres actuels sur la machine de l'agent et n'imprime que ceux-ci. Le coffre-fort conserve le secret chiffré et ne le voit jamais.

Le reste de cette page explique pourquoi c'est important, comment le mettre en place, et le seul choix que vous faites pour chaque compte.

Pourquoi le téléphone ne suffit plus

La connexion à deux facteurs a été conçue autour d'une personne avec un téléphone. Le site demande un code, vous ouvrez votre application d'authentification, vous tapez six chiffres.

Puis celui qui se connecte est devenu un script. Claude Code déploie, ouvre un tableau de bord, consulte une console protégée par la 2FA. À la quatrième étape, il s'arrête et attend que vous trouviez votre téléphone.

Alors les gens prennent le chemin rapide. Ils collent le secret, la longue chaîne derrière le code QR, dans un fichier de configuration ou un prompt, et laissent l'agent générer les codes lui-même.

Cette chaîne n'est pas un code. C'est ce qui génère tous les codes, aussi longtemps que le compte existe. Quiconque la détient possède votre second facteur jusqu'à ce que vous le réinitialisiez. Entre les mains d'un agent, elle peut finir dans un journal, une transcription, ou une réponse à une injection de prompt qui demande « votre configuration, pour le débogage ».

Le schéma : demander le code, pas le secret

Un code dure trente secondes. Un secret dure jusqu'à ce que vous le changiez. L'agent doit donc recevoir le premier et jamais le second.

Avec Clavitor, c'est une seule commande :

$ code=$(clavitor-cli totp "GitHub")

Ce qui se passe :

  1. Le CLI récupère l'entrée GitHub depuis le coffre-fort, chiffrée.
  2. Il déchiffre le champ de mot de passe à usage unique avec la clé propre de l'agent, sur la machine de l'agent.
  3. Il calcule le code actuel et l'imprime sur une seule ligne, rien d'autre.

Capturez le code à l'intérieur de la commande qui en a besoin, comme ci-dessus. N'exécutez pas totp seul : le code se retrouverait alors dans la sortie de l'agent, c'est-à-dire sa transcription.

Il lit un secret simple (six chiffres, trente secondes) ou un lien otpauth:// complet, et suit les paramètres propres à ce lien : 6 à 8 chiffres, SHA-1, SHA-256 ou SHA-512.

Mise en place pour Claude Code

  1. Dans votre coffre-fort, ouvrez Clients, puis + Nouveau client. Nommez-le « Claude Code » et choisissez les entrées qu'il peut utiliser.
  2. Sur la machine où Claude Code s'exécute, collez le blob d'enrôlement, saisissez la clé d'enrôlement à l'invite, et installez la compétence :
$ clavitor-cli init '<blob>'
Enrollment key:
$ clavitor-cli skill install

La compétence apprend à Claude Code comment utiliser le coffre-fort : une entrée à la fois, par nom, et les valeurs capturées là où elles sont utilisées plutôt qu'affichées.

Le seul choix : quels codes un agent peut-il lire ?

Un nouveau secret d'authentification dans Clavitor n'appartient qu'à vous. Il est enregistré sous Chiffrement de l'identité, que seule votre clé matérielle peut ouvrir. Demandez à un agent de l'utiliser et il reçoit un refus (CV-2048) qui nomme le champ.

C'est le bon comportement par défaut. Votre banque, votre messagerie, la console d'administration de votre entreprise : aucun agent n'a besoin de ces codes.

Pour les comptes où un agent doit franchir la connexion seul, ouvrez l'entrée dans votre page de coffre-fort et cliquez sur le petit badge L3 à côté du champ. Confirmez, et ce champ passe sous Chiffrement des identifiants. Le badge affiche L2, et clavitor-cli totp fonctionne pour lui. Votre page de coffre-fort déverrouillée détient déjà la clé, il n'y a donc pas de validation supplémentaire. Vous changez d'avis ? Cliquez sur L2, confirmez, et seule votre clé peut à nouveau l'ouvrir.

C'est donc par compte, et c'est votre décision à chaque fois.

Ce que cela ne résout pas

Un code reste un code valide pendant trente secondes.

  • Un agent qui a été manipulé peut toujours se connecter avec l'accès que vous lui avez donné. Il ne peut simplement pas repartir avec le secret.
  • Dès qu'un agent peut générer ses propres codes, cette 2FA ne prouve plus qu'une personne était présente. Acceptable pour un compte de déploiement. Réfléchissez à deux fois là où « un humain a approuvé ceci » est l'essentiel.
  • Quelqu'un disposant d'un accès administrateur à la machine de l'agent peut utiliser tout ce que l'agent peut utiliser.

C'est pourquoi l'accès autour compte :

  • Périmètre. L'agent n'atteint que les entrées que vous avez attribuées à son client.
  • Limites de lecture. Chaque code correspond à une lecture de l'entrée, comptée dans les limites du client.
  • Une trace. Chaque demande de code est une lecture de l'entrée, et elle est consignée dans votre journal d'audit.

En résumé

Ne donnez pas votre secret d'authentification à un agent. Donnez-lui un moyen de demander le code actuel, pour les comptes que vous choisissez, et conservez une ligne dans le journal à chaque fois qu'il le fait.

Voir comment fonctionne l'accès des agents ou lire la documentation de totp.