Je me connecte à mon portable avec une YubiKey. PIN, toucher, bureau. Aucun mot de passe tapé.

Puis la première application qui veut un secret stocké démarre et GNOME affiche une boîte : « An application wants access to the keyring ‘Login’, but it is locked. » À chaque connexion. Même boîte, même question, un mot de passe dont on venait de me dire que je n’avais pas besoin.

Aucune pièce isolée n’est cassée. Chaque partie fait ce pour quoi elle a été construite. Le problème, c’est que le trousseau a été conçu en partant du principe qu’une connexion implique toujours un mot de passe, et qu’une connexion sans mot de passe brise ce principe sans prévenir personne.

Pourquoi une connexion par clé affame le trousseau

Le trousseau de session est l’endroit où le bureau garde les secrets que les applications lui confient : clés Wi-Fi, clés de stockage du navigateur, les jetons dont se servent les clients de messagerie, les gestionnaires de mots de passe et les applications de visioconférence pour rester connectés. Il est stocké sur disque, chiffré avec votre mot de passe de session, et l’API Secret Service1 est la façon dont les applications demandent ce qu’il contient.

Normalement, vous ne le voyez jamais. Vous tapez votre mot de passe à l’écran de connexion, la pile PAM le vérifie contre le compte, et un module de trousseau plus bas dans la même pile récupère discrètement ce même mot de passe et s’en sert pour ouvrir le trousseau avant même que votre bureau ait fini de s’afficher. Un mot de passe, deux tâches.

Ma pile commence par cette ligne :

auth        sufficient        pam_u2f.so cue

sufficient veut dire qu’une YubiKey validée termine l’authentification sur-le-champ. C’est exactement ce que Yubico documente pour la connexion sans mot de passe2. Ça marche. Ça veut aussi dire que l’étape du mot de passe ne s’exécute jamais, donc qu’il n’y a aucun mot de passe dans la pile que le module de trousseau puisse récupérer. Le trousseau reste verrouillé jusqu’à ce que quelque chose le demande, et ce quelque chose est la première application qui démarre.

Deux entrées, et ce que chacune donne au trousseauDeux entrées, et ce que chacune donne au trousseauLe trousseau ne s'ouvre qu'avec un mot de passe. Une connexion YubiKey n'en produit pas, le script le fournit.Connexion par mot de passepam_unix vérifie le mot de passepam_oo7 passe ce mot de passe à oo7-daemonle trousseau de session se déchiffre avectrousseau ouvert, sans inviteConnexion YubiKey (PIN + toucher)pam_u2f est sufficient, il clôt la pile authpas d'étape mot de passe, aucun mot de passeoo7-daemon ne reçoit rientrousseau verrouillé, invite au 1er usageScript de démarrage autoPIN + toucher, la clé rend le hmac-secretdéchiffre le mot de passe, ouvre le trousseauLes applications qui lisent le trousseau attendent son ouverture, donc aucune ne peut lever l'invite avant.
Une connexion par mot de passe donne au trousseau la seule chose qui puisse l’ouvrir. Une connexion par clé ne lui donne rien. Le script de démarrage automatique à droite est le montage que décrit ce billet.

Les correctifs habituels, et ce que chacun coûte

Il y a quatre réponses courantes à ce problème. Chacune d’elles sacrifie quelque chose.

CorrectifCe que vous obtenezCe que ça coûte
Taper le mot de passe à l’inviteRien à construireL’invite, à chaque connexion. La clé ne vous a rien épargné du tout
Mot de passe de trousseau videPlus d’inviteChaque secret stocké est sur disque, non chiffré
Mot de passe et clé à la connexionVraie double authentification, le trousseau s’ouvre seulTaper le mot de passe à chaque connexion, ce que la clé devait justement éviter
Mot de passe scellé par le TPM, déverrouillé à la connexionPas d’invite, rien à taperQuiconque obtient une session sur cette machine obtient les secrets. Ni PIN ni clé en jeu
hmac-secret de la YubiKey (ce billet)Pas d’invite, PIN + toucher, la connexion par mot de passe marche toujoursUn deuxième PIN et un deuxième toucher après la connexion, et un script à entretenir

Le mot de passe vide est celui sur lequel finissent la plupart des fils de forum, et c’est le pire du lot. La voie du TPM est respectable, mais le TPM ne vous demande jamais rien, donc ce qu’il protège, c’est un disque sorti du portable, pas une session devant laquelle quelqu’un s’est assis pendant que vous vous faisiez un thé. Je voulais que le trousseau soit lié à la même chose que ma connexion : la clé, et le PIN qui va avec.

La clé peut garder un secret

Une clé FIDO2 fait plus que dire oui ou non. La norme CTAP 2.1 a une extension appelée hmac-secret, qui « is used by the platform to retrieve a symmetric secret from the authenticator when it needs to encrypt or decrypt data using that symmetric secret »3.

Le fonctionnement est assez simple. Quand vous créez un identifiant, la clé génère des valeurs aléatoires et les garde en elle. Plus tard, vous lui envoyez un sel, et elle renvoie un HMAC de ce sel calculé avec sa valeur cachée. Même identifiant, même sel, même réponse à chaque fois. Autre clé, rien.

Le détail qui compte ici : la clé détient deux de ces valeurs cachées, CredRandomWithUV et CredRandomWithoutUV3. UV, c’est la vérification de l’utilisateur, ce qui sur cette clé veut dire le PIN. Demandez avec le PIN et vous obtenez un secret. Demandez avec un simple toucher et vous en obtenez un complètement différent. Le PIN n’est donc pas une vérification boulonnée devant le secret. Il fait partie du secret.

ÉlémentOù il vitÀ lui seul, il vous donne
ID de l’identifiant et sel~/.local/share/yubikey-keyring/, fichiers en clairRien. Ils ne sont pas secrets
Mot de passe du trousseau chiffréMême dossier, password.encRien sans le secret de déchiffrement
Valeur cachée de l’identifiantDans la YubiKey, n’en sort jamaisRien sans le sel et un toucher
PINVotre têteSélectionne le secret avec PIN. Mauvais PIN, pas de secret, et la clé compte la tentative

Les quatre ensemble rendent le mot de passe du compte. Retirez-en un seul et vous êtes à l’invite, là où vous auriez été de toute façon.

Ce que j’ai construit avec Claude

Le mot de passe du trousseau est mon mot de passe de compte, exprès. Ça garde la connexion par mot de passe fonctionnelle de la façon normale : tapez-le à l’écran de connexion et la pile PAM ouvre le trousseau elle-même, sans aucun script. C’est la voie YubiKey qui a besoin d’aide.

PièceRôle
yubikey-keyring-setupUne seule fois. Crée l’identifiant FIDO2 sur la clé avec hmac-secret activé. Demande le PIN et un toucher
yubikey-keyring-resetDemande le mot de passe du compte, le vérifie contre le vrai compte avec unix_chkpwd avant de toucher à quoi que ce soit, le chiffre avec le secret conditionné au PIN, sauvegarde l’ancien trousseau et crée le nouveau
yubikey-keyring-unlockTourne à la connexion. Dialogue de PIN, toucher, déchiffrement, déverrouillage. Deux essais de PIN, puis il abandonne et vous laisse l’invite normale
wait-for-keyringEnveloppe les entrées de démarrage automatique de chaque application qui lit le trousseau. Retient chacune jusqu’à 60 secondes, le temps que le trousseau soit ouvert

Le secret sort de fido2-assert4 avec -h pour hmac-secret, -p pour le toucher et -v pour le PIN. Le mot de passe est chiffré avec OpenSSL, en AES-256 avec 200 000 tours de PBKDF2 sur le secret dérivé. À la connexion, le mot de passe ne transite jamais que par un pipe. Le secret dérivé et, pendant une réinitialisation, le mot de passe tapé restent brièvement dans un répertoire temporaire privé sous /tmp, qui sous Fedora est un tmpfs en RAM, et sont supprimés dès qu’ils ont servi. Aucun des deux ne passe jamais sur une ligne de commande où ps pourrait le voir.

wait-for-keyring est la pièce que les gens sauteraient. Ne le faites pas. L’ordre du démarrage automatique n’est pas garanti, et si une application demande son jeton une seconde avant que j’aie fini de taper le PIN, GNOME lève l’ancienne invite par-dessus la mienne, et le correctif a l’air cassé alors qu’il ne l’est pas.

Les scripts sont à vous : yubikey-keyring.zip, SHA-256 9b3670cf0f38c1b93e7738d2f68abef0380786d918491973e3ebefa5143e6263. Il contient les scripts, un installeur, un README et le banc de test décrit plus bas. Aucun identifiant, sel ou mot de passe n’y figure. Ceux-ci sont créés sur votre propre machine quand vous lancez la configuration. Lisez le README, puis lancez test/run.sh avant de laisser quoi que ce soit approcher votre vrai trousseau.

Ce que le montage a révélé

C’était censé être une heure de travail. L’essentiel de la soirée est parti dans des choses que la documentation ne mentionne pas.

Le démon avait changé sous mes pieds

Chaque guide que j’ai lu sur ce problème parle à gnome-keyring-daemon, et chacun d’eux m’aurait envoyé dans la mauvaise direction, parce que le processus qui répondait sur ma machine était oo7-daemon 0.7.0, une bêta. Le portable était passé à Fedora 45 plus tôt dans la même soirée, une transaction dnf de 5 464 étapes, et oo7 était arrivé avec.

oo7 est une implémentation en Rust du Secret Service, avec son propre serveur et son propre module PAM5. À son crédit, il implémente l’interface D-Bus privée de gnome-keyring pour déverrouiller avec un mot de passe, donc les outils existants continuent de marcher. Cette interface s’appelle org.gnome.keyring.InternalUnsupportedGuiltRiddenInterface6. Le nom vous dit jusqu’où lui faire confiance. Elle marche, je l’ai testée, et je m’attends quand même à ce qu’elle bouge un jour.

Le premier mot de passe que vous tapez devient celui du trousseau

Celle-là a expliqué toute la soirée.

Quand oo7 démarre et ne trouve aucun fichier de trousseau, il n’en crée pas : il présente aux applications un trousseau provisoire verrouillé appelé login, et le premier mot de passe dont quelqu’un se sert pour déverrouiller ce provisoire devient le mot de passe du trousseau, même si le fichier lui-même n’est écrit que lorsqu’une application stocke son premier secret.

Mon fichier de trousseau a été créé à 20 h 45, et son premier élément venait d’une application qui avait démarré quelques secondes plus tôt. Donc à 20 h 45, j’ai tapé quelque chose dans une invite dont je voulais me débarrasser, et c’est devenu le mot de passe. Rien de ce que j’ai essayé ensuite ne l’a ouvert. Le code de déverrouillage n’y était pour rien non plus : je l’ai prouvé sur un trousseau jetable au mot de passe connu, qui s’est verrouillé, déverrouillé et supprimé proprement.

J’ai ensuite vérifié le provisoire sur un démon jetable. Avant que le fichier existe, n’importe quel mot de passe le déverrouille, y compris un faux. Rien ne vous dit donc sur le moment que vous venez de définir un mot de passe. Vous le découvrez à la connexion suivante, quand le bon mot de passe, pour autant que vous le sachiez, est refusé.

ÉtatDéverrouillage avec n’importe quel mot de passeCe qui est écrit
Pas de fichier de trousseau, provisoire présentéRéussitRien pour l’instant
Premier élément stockésans objetFichier créé, chiffré avec ce qui a été tapé
Chaque connexion ensuiteSeul le mot de passe de 20 h 45 marchesans objet

J’ai donc arrêté de lui courir après. La réinitialisation sauvegarde l’ancien trousseau, déverrouille le provisoire avec le mot de passe du compte, et stocke tout de suite un élément témoin pour que le fichier soit écrit sur-le-champ, avec un mot de passe que je connais.

Les outils FIDO2 ne prennent un PIN que depuis un terminal

fido2-cred et fido2-assert lisent le PIN depuis le terminal de contrôle et nulle part ailleurs. Un script lancé à la connexion n’a pas de terminal. Il y a donc un petit wrapper qui lance l’outil sous un pseudo-terminal, attend le mot PIN dans sa sortie, et y tape le PIN venu d’un dialogue. Vingt lignes de Python. Pas joli, mais ça fait le travail et le PIN ne touche jamais un fichier ni une liste d’arguments.

Testez-le là où il ne peut pas vous faire de mal

La chose la plus utile qu’ait faite Claude Code a été de refuser de faire confiance au script de réinitialisation sur mon vrai trousseau. Il a d’abord déroulé tout le processus contre un second oo7-daemon sur une session D-Bus privée (dbus-run-session), avec un répertoire personnel jetable, un faux ancien trousseau et un mot de passe de test contenant £, @, " et #.

Le premier essai a échoué. Tant mieux. La réinitialisation a déplacé l’ancien trousseau vers sa sauvegarde, redémarré le démon, vu le login provisoire d’oo7, l’a pris pour un vrai trousseau et s’est arrêtée. Sur ma machine, ça m’aurait laissé sans aucun trousseau et avec une sauvegarde à restaurer à la main. Le script déverrouille désormais le provisoire au lieu de le refuser, et si quoi que ce soit échoue après la prise de la sauvegarde, il remet l’ancien trousseau en place tout seul.

Le propre garde-fou de Claude Code a aussi arrêté une version antérieure de la réinitialisation sur le vrai trousseau jusqu’à ce que j’aie confirmé. Agaçant sur le moment. Bien vu.

Test, sur le démon jetableRésultat
Réinitialisation depuis une invite de terminal, ancien trousseau sauvegardéRéussi
Ancien mot de passe contre le nouveau trousseauRefusé
Démon neuf, comme à la connexionDémarre verrouillé
Mauvais mot de passeRefusé
Bon mot de passe, par le même chemin qu’une connexion par mot de passeDéverrouille
Démon neuf, PIN + toucher via le script de déverrouillageDéverrouille
Script de déverrouillage avec le trousseau déjà ouvertSort aussitôt, aucun toucher demandé

Puis une fois de plus sur la vraie machine, avec le trousseau verrouillé à la main et le script de déverrouillage lancé comme le lance la connexion : PIN, toucher, ouvert.

Les aspérités

C’est un montage qui fonctionne, pas un produit fini, et voici les points que je connais.

  • Deux saisies de PIN par connexion par clé. Une à l’écran de connexion pour PAM, une pour le trousseau. Ce sont deux requêtes distinctes à la clé, et la clé ne les combinera pas. Un trousseau au toucher seul en économiserait une, au prix d’un PIN qui ne protège plus rien après la connexion.
  • Changez le mot de passe du compte et la copie stockée devient périmée. Le script de déverrouillage le signale par une notification au lieu d’échouer en silence. Relancez la réinitialisation et c’est réglé.
  • Perdez la clé et vous revoilà à taper le mot de passe. Rien n’est perdu, puisque le mot de passe reste celui du compte.
  • Certaines applications réécrivent leurs propres fichiers de démarrage automatique. Si l’une d’elles fait un jour réapparaître l’invite, c’est pour ça, et le wrapper doit être remis en place.
  • oo7 est une bêta, et l’appel de déverrouillage passe par une interface avec « Unsupported » dans son nom. Chaque mise à jour d’oo7 mérite une connexion de test avant de s’y fier.

Pour finir

Le trousseau n’a jamais été cassé. La clé non plus. Ils ont été construits sur des hypothèses différentes de ce qu’est une connexion, et personne en amont ne les a raccordés. La connexion sans mot de passe est documentée par Yubico, livrée dans les profils authselect de Fedora et activée avec une seule option. Rien du tout là-dedans ne vous dit qu’au moment où vous vous en servez, chaque secret que garde votre bureau reste verrouillé derrière un mot de passe que vous ne tapez plus.

De ce fait, le trou retombe sur celui qui est assis devant la machine, et le correctif ne vaut que ce que vaut sa compréhension de l’endroit où vit réellement le secret. La réponse facile, un mot de passe vide, est celle vers laquelle on oriente la plupart des gens, et elle échange une boîte de dialogue contre un fichier non chiffré de chaque jeton que vous possédez. Ce n’est pas un correctif. C’est abandonner sans bruit.

La bonne forme était là depuis le début. La clé peut garder un secret, la norme le dit en toutes lettres, et le PIN peut faire partie de ce secret plutôt qu’être une porte devant lui. Il a fallu une soirée et un banc de test pour le câbler. Ça n’aurait dû demander ni l’un ni l’autre.


  1. freedesktop.org, Secret Service API Draft — l’API D-Bus dont se servent les applications de bureau pour stocker et récupérer des secrets, implémentée à la fois par gnome-keyring et oo7. ↩︎

  2. Yubico, pam-u2f — « For a passwordless experience, where the authenticator PIN can be used in place of the user password », avec la ligne d’exemple auth sufficient pam_u2f.so authfile=/etc/u2f_mappings cue pinverification=1. ↩︎

  3. FIDO Alliance, Client to Authenticator Protocol 2.1, section 12.5 HMAC Secret Extension — « This extension is used by the platform to retrieve a symmetric secret from the authenticator when it needs to encrypt or decrypt data using that symmetric secret », et « The authenticator generates two random 32-byte values (called CredRandomWithUV and CredRandomWithoutUV) ». ↩︎ ↩︎

  4. Yubico, libfido2 fido2-assert manual — l’outil en ligne de commande qui sert à demander une assertion, avec les options hmac-secret, présence de l’utilisateur et PIN. ↩︎

  5. linux-credentials/oo7 on GitHub — « server: org.freedesktop.secrets server implementation » et « pam: PAM integration for the server implementation ». ↩︎

  6. oo7 source, server/src/gnome/internal.rs — l’implémentation par oo7 de l’interface interne de déverrouillage de gnome-keyring, dont UnlockWithMasterPassword. ↩︎