Ik log op mijn laptop in met een YubiKey. Pincode, aanraken, bureaublad. Geen wachtwoord getypt.

Dan start de eerste app die een opgeslagen geheim wil, en GNOME gooit een venster op: “An application wants access to the keyring ‘Login’, but it is locked.” Bij elke login. Hetzelfde venster, dezelfde vraag, een wachtwoord waarvan me net was verteld dat ik het niet nodig had.

Geen enkel onderdeel is stuk. Elk deel doet waarvoor het gebouwd is. Het probleem is dat de keyring ontworpen is in de veronderstelling dat er bij een login altijd een wachtwoord komt kijken, en een wachtwoordloze login breekt die veronderstelling zonder het iemand te vertellen.

Waarom een login met een sleutel de keyring uithongert

De login-keyring is waar het bureaublad de geheimen bewaart die apps eraan geven: wifi-sleutels, opslagsleutels van de browser, de tokens waarmee chatclients, wachtwoordmanagers en vergaderapps ingelogd blijven. Hij staat op schijf, versleuteld met je loginwachtwoord, en de Secret Service API1 is hoe apps vragen naar wat erin zit.

Normaal zie je hem nooit. Je typt je wachtwoord op het loginscherm, de PAM-stack controleert het tegen het account, en een keyringmodule verderop in dezelfde stack pakt stilletjes datzelfde wachtwoord op en gebruikt het om de keyring te openen voordat je bureaublad zelfs maar klaar is met tekenen. Eén wachtwoord, twee taken.

Mijn stack begint met deze regel:

auth        sufficient        pam_u2f.so cue

sufficient betekent dat een geslaagde YubiKey de authenticatie daar en dan beëindigt. Dat is precies wat Yubico documenteert voor wachtwoordloos inloggen2. Het werkt. Het betekent ook dat de wachtwoordstap nooit draait, dus er is geen wachtwoord in de stack dat de keyringmodule kan oppakken. De keyring blijft op slot tot iets erom vraagt, en dat iets is de app die het eerst start.

Twee manieren om binnen te komen, en wat elk de keyring geeftTwee manieren om binnen te komen, en wat elk de keyring geeftDe keyring opent alleen met een wachtwoord. Een YubiKey-login levert er nooit een, dus het script levert het.Login met wachtwoordpam_unix controleert het wachtwoordpam_oo7 geeft hetzelfde wachtwoord aan oo7-daemonde login-keyring ontsleutelt ermeekeyring open, geen promptYubiKey-login (pincode + aanraken)pam_u2f is sufficient, dus de auth-stack stoptgeen wachtwoordstap, geen wachtwoordoo7-daemon krijgt nietskeyring op slot, prompt bij eerste gebruikAutostartscriptpincode + aanraken, sleutel geeft de hmac-secretontsleutelt het wachtwoord, ontgrendelt de keyringApps die de keyring lezen, wachten tot hij open is, dus geen ervan kan eerst de prompt opwerpen.
Een login met wachtwoord geeft de keyring het enige waarmee hij open kan. Een login met een sleutel geeft hem niets. Het autostartscript rechts is de bouw die dit stuk beschrijft.

De gebruikelijke oplossingen, en wat elk kost

Er zijn vier gangbare antwoorden hierop. Elk ervan levert iets in.

OplossingWat je krijgtWat het kost
Het wachtwoord typen bij de promptNiets te bouwenDe prompt, bij elke login. De sleutel bespaarde je niks
Leeg keyringwachtwoordPrompt wegElk opgeslagen geheim staat onversleuteld op schijf
Wachtwoord en sleutel bij het inloggenEchte tweefactor, keyring opent zichzelfBij elke login het wachtwoord typen, en daar was de sleutel nu juist voor
Wachtwoord verzegeld in de TPM, ontgrendeld bij het inloggenGeen prompt, niets typenWie een sessie op die machine krijgt, krijgt de geheimen. Geen pincode, geen sleutel nodig
YubiKey hmac-secret (dit stuk)Geen prompt, pincode + aanraken, inloggen met wachtwoord werkt nogEen tweede pincode en aanraking na het inloggen, en een script om bij te houden

Het lege wachtwoord is waar de meeste forumdraadjes op eindigen, en het is de slechtste van het stel. De TPM-route is respectabel, maar de TPM vraagt je nooit iets, dus wat hij beschermt is een schijf die uit de laptop is gehaald, niet een sessie waar iemand achter is gaan zitten terwijl jij thee zette. Ik wilde de keyring vastknopen aan hetzelfde waaraan mijn login vastzit: de sleutel, en de pincode die erbij hoort.

De sleutel kan een geheim bewaren

Een FIDO2-sleutel doet meer dan ja of nee zeggen. De CTAP 2.1-standaard heeft een extensie die hmac-secret heet, en die “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.

Hoe het werkt, is eenvoudig genoeg. Als je een credential aanmaakt, genereert de sleutel willekeurige waarden en houdt die in zichzelf. Later stuur je hem een salt, en hij geeft een HMAC van die salt terug, gesleuteld met zijn verborgen waarde. Zelfde credential, zelfde salt, elke keer hetzelfde antwoord. Andere sleutel, niets.

Het detail dat hier telt: de sleutel bewaart twee van die verborgen waarden, CredRandomWithUV en CredRandomWithoutUV3. UV is user verification, en dat betekent op deze sleutel de pincode. Vraag met de pincode en je krijgt het ene geheim. Vraag met alleen een aanraking en je krijgt een compleet ander. De pincode is dus geen controle die vóór het geheim is vastgeschroefd. Hij is een deel van het geheim.

InvoerWaar het staatAlleen levert het je op
Credential-ID en salt~/.local/share/yubikey-keyring/, gewone bestandenNiets. Ze zijn niet geheim
Versleuteld keyringwachtwoordZelfde map, password.encNiets zonder het ontsleutelgeheim
Verborgen credentialwaardeIn de YubiKey, verlaat hem nooitNiets zonder de salt en een aanraking
PincodeJe hoofdKiest het geheim met pincode. Verkeerde pincode, geen geheim, en de sleutel telt de poging

Alle vier samen geven het accountwachtwoord terug. Haal er één weg en je staat bij de prompt, en daar zou je anders toch al hebben gestaan.

Wat ik met Claude bouwde

Het keyringwachtwoord is mijn accountwachtwoord, met opzet. Zo blijft inloggen met een wachtwoord gewoon werken: typ het op het loginscherm en de PAM-stack opent de keyring zelf, zonder script. Het YubiKey-pad is het pad dat hulp nodig heeft.

OnderdeelTaak
yubikey-keyring-setupEenmalig. Maakt de FIDO2-credential op de sleutel aan met hmac-secret ingeschakeld. Vraagt de pincode en een aanraking
yubikey-keyring-resetVraagt het accountwachtwoord, controleert het met unix_chkpwd tegen het echte account voordat het iets aanraakt, versleutelt het met het geheim achter de pincode, maakt een back-up van de oude keyring en maakt de nieuwe aan
yubikey-keyring-unlockDraait bij het inloggen. Pincodevenster, aanraken, ontsleutelen, ontgrendelen. Twee pogingen voor de pincode, daarna geeft het op en laat het je de normale prompt
wait-for-keyringOmhult de autostartvermeldingen van elke app die de keyring leest. Houdt elk ervan tot 60 seconden vast tot de keyring open is

Het geheim komt uit fido2-assert4 met -h voor hmac-secret, -p voor aanraking en -v voor de pincode. Het wachtwoord wordt versleuteld met OpenSSL, AES-256 met 200.000 rondes PBKDF2 op het afgeleide geheim. Bij het inloggen gaat het wachtwoord alleen ooit door een pipe. Het afgeleide geheim en, tijdens een reset, het getypte wachtwoord staan even in een privé tijdelijke map onder /tmp, die op Fedora in RAM staat als tmpfs, en worden verwijderd zodra ze gebruikt zijn. Geen van beide komt ooit op een commandline waar ps het kan zien.

wait-for-keyring is het onderdeel dat mensen zouden overslaan. Niet doen. De volgorde van autostart is niet gegarandeerd, en als één app een seconde voordat ik klaar ben met de pincode typen om zijn token vraagt, zet GNOME de oude prompt boven op de mijne, en lijkt de oplossing stuk terwijl hij dat niet is.

De scripts mag je meenemen: yubikey-keyring.zip, SHA-256 9b3670cf0f38c1b93e7738d2f68abef0380786d918491973e3ebefa5143e6263. Er zitten de scripts in, een installer, een README en het testharnas dat hieronder beschreven staat. Er zit geen credential, salt of wachtwoord in. Die worden op je eigen machine gemaakt als je de setup draait. Lees de README en draai dan test/run.sh voordat je er iets van in de buurt van je echte keyring laat komen.

Wat de bouw opleverde

Dit had een uur werk moeten zijn. Het grootste deel van de avond ging op aan dingen die de documentatie niet noemt.

De daemon was onder me veranderd

Elke handleiding die ik voor dit probleem heb gelezen, praat met gnome-keyring-daemon, en elk ervan zou me de verkeerde kant op hebben gestuurd, want het proces dat op mijn machine antwoordde, was oo7-daemon 0.7.0, een bèta. De laptop was eerder dezelfde avond naar Fedora 45 gegaan, een dnf-transactie van 5.464 stappen, en oo7 was meegekomen.

oo7 is een implementatie van de Secret Service in Rust, met een eigen server en een eigen PAM-module5. Het pleit voor oo7 dat het de private D-Bus-interface van gnome-keyring implementeert voor ontgrendelen met een wachtwoord, zodat bestaande tools blijven werken. Die interface heet org.gnome.keyring.InternalUnsupportedGuiltRiddenInterface6. De naam zegt je hoe ver je hem kunt vertrouwen. Hij werkt, ik heb hem getest, en ik verwacht nog steeds dat hij op een dag verschuift.

Het eerste wachtwoord dat je typt, wordt het keyringwachtwoord

Deze verklaarde de hele avond.

Als oo7 start en geen keyringbestand vindt, maakt het er geen aan, maar laat het apps een vergrendelde placeholder zien die login heet, en het eerste wachtwoord dat iemand gebruikt om die placeholder te ontgrendelen, wordt het keyringwachtwoord, al wordt het bestand zelf pas geschreven als een app zijn eerste geheim opslaat.

Mijn keyringbestand werd om 20:45 aangemaakt, en het eerste item kwam van een app die een paar seconden eerder was gestart. Om 20:45 had ik dus iets getypt in een prompt die ik uit de weg wilde hebben, en dat werd het wachtwoord. Niets wat ik daarna probeerde, kreeg hem open. Aan de ontgrendelcode lag het ook niet: dat bewees ik op een wegwerpkeyring met een bekend wachtwoord, die netjes vergrendelde, ontgrendelde en verwijderde.

Daarna heb ik de placeholder op een wegwerpdaemon gecontroleerd. Voordat het bestand bestaat, ontgrendelt elk wachtwoord hem, ook een verkeerd. Niets vertelt je dus op dat moment dat je net een wachtwoord hebt ingesteld. Je merkt het bij de volgende login, als het juiste wachtwoord, voor zover jij weet, wordt geweigerd.

ToestandOntgrendelen met welk wachtwoord dan ookWat er geschreven wordt
Geen keyringbestand, placeholder getoondLuktNog niets
Eerste item opgeslagenn.v.t.Bestand aangemaakt, versleuteld met wat er getypt was
Elke login daarnaAlleen het wachtwoord van 20:45 werktn.v.t.

Dus ben ik er niet langer achteraan gegaan. De reset maakt een back-up van de oude keyring, ontgrendelt de placeholder met het accountwachtwoord en slaat meteen een markeringsitem op, zodat het bestand daar en dan geschreven wordt, met een wachtwoord dat ik ken.

De FIDO2-tools nemen een pincode alleen van een terminal

fido2-cred en fido2-assert lezen de pincode van de controlerende terminal en nergens anders. Een script dat bij het inloggen start, heeft geen terminal. Dus is er een kleine wrapper die de tool onder een pseudoterminal draait, wacht op het woord PIN in de uitvoer, en de pincode vanuit een venster intypt. Twintig regels Python. Niet mooi, maar het doet het werk en de pincode komt nooit in een bestand of een argumentenlijst.

Test het ergens waar het je geen pijn kan doen

Het nuttigste wat Claude Code deed, was weigeren het resetscript op mijn echte keyring te vertrouwen. Het draaide de hele flow eerst tegen een tweede oo7-daemon op een private D-Bus-sessie (dbus-run-session), met een wegwerpthuismap, een nep oude keyring en een testwachtwoord met £, @, " en # erin.

De eerste run faalde. Mooi. De reset verplaatste de oude keyring naar de back-up, herstartte de daemon, zag de placeholder login van oo7, hield die voor een echte keyring en stopte. Op mijn machine had me dat zonder keyring achtergelaten, met een back-up om met de hand terug te zetten. Het script ontgrendelt de placeholder nu in plaats van hem te weigeren, en als er iets misgaat nadat de back-up gemaakt is, zet het de oude keyring zelf terug.

De eigen veiligheidscontrole van Claude Code hield ook een eerdere versie van de reset op de echte keyring tegen tot ik die had bevestigd. Irritant op dat moment. Terechte beslissing.

Test, op de wegwerpdaemonResultaat
Reset vanaf een terminalprompt, back-up van de oude keyringGeslaagd
Oud wachtwoord tegen de nieuwe keyringGeweigerd
Verse daemon, zoals bij het inloggenStart vergrendeld
Verkeerd wachtwoordGeweigerd
Juist wachtwoord, hetzelfde pad als een login met wachtwoordOntgrendelt
Verse daemon, pincode + aanraken via het ontgrendelscriptOntgrendelt
Ontgrendelscript terwijl de keyring al open isStopt meteen, vraagt geen aanraking

Daarna nog één keer op het echte ding, met de keyring met de hand vergrendeld en het ontgrendelscript gedraaid zoals de login het draait: pincode, aanraken, open.

De ruwe kanten

Het is een werkende opzet, geen afgewerkt product, en dit zijn de stukken die ik ken.

  • Twee keer een pincode per login met de sleutel. Eén op het loginscherm voor PAM, één voor de keyring. Het zijn aparte verzoeken aan de sleutel en de sleutel voegt ze niet samen. Een keyring met alleen aanraking scheelt er één, maar dan beschermt de pincode na het inloggen niets meer.
  • Verander het accountwachtwoord en de opgeslagen kopie veroudert. Het ontgrendelscript zegt dat in een melding in plaats van stil te falen. Draai de reset opnieuw en het is geregeld.
  • Raak de sleutel kwijt en je typt weer het wachtwoord. Er gaat niets verloren, want het wachtwoord is nog steeds het accountwachtwoord.
  • Sommige apps herschrijven hun eigen autostartbestanden. Als een ervan ooit weer de prompt opwerpt, is dat waarom, en moet de wrapper teruggezet worden.
  • oo7 is een bèta, en de ontgrendelaanroep gaat via een interface met “Unsupported” in de naam. Elke update van oo7 is een testlogin waard voordat je erop vertrouwt.

Tot slot

De keyring was nooit stuk. De sleutel ook niet. Ze waren gebouwd op verschillende aannames over wat een login is, en niemand stroomopwaarts heeft ze aan elkaar geknoopt. Wachtwoordloos inloggen is gedocumenteerd door Yubico, zit in de authselect-profielen van Fedora en wordt met één feature flag aangezet. Nergens in dat alles staat dat op het moment dat je het gebruikt, elk geheim dat je bureaublad bewaart op slot blijft achter een wachtwoord dat je niet meer typt.

Zo valt het gat toe aan wie er achter de machine zit, en de oplossing is maar zo goed als het begrip van die persoon van waar het geheim werkelijk woont. Het makkelijke antwoord, een leeg wachtwoord, is het antwoord waar de meeste mensen naartoe worden gestuurd, en het ruilt een dialoogvenster in voor een onversleuteld bestand met elk token dat je bezit. Dat is geen oplossing. Dat is stilletjes opgeven.

De juiste vorm was er de hele tijd. De sleutel kan een geheim bewaren, de standaard zegt het met zoveel woorden, en de pincode kan een deel van dat geheim zijn in plaats van een deur ervoor. Het kostte een avond en een testharnas om het aan te sluiten. Het had geen van beide nodig mogen hebben.


  1. freedesktop.org, Secret Service API Draft — de D-Bus-API die bureaubladapps gebruiken om geheimen op te slaan en op te halen, en die zowel gnome-keyring als oo7 implementeren. ↩︎

  2. Yubico, pam-u2f — “For a passwordless experience, where the authenticator PIN can be used in place of the user password”, met de voorbeeldregel 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”, en “The authenticator generates two random 32-byte values (called CredRandomWithUV and CredRandomWithoutUV)”. ↩︎ ↩︎

  4. Yubico, libfido2 fido2-assert manual — de commandlinetool waarmee een assertion wordt aangevraagd, met de opties voor hmac-secret, aanwezigheid van de gebruiker en pincode. ↩︎

  5. linux-credentials/oo7 on GitHub — “server: org.freedesktop.secrets server implementation” en “pam: PAM integration for the server implementation”. ↩︎

  6. oo7 source, server/src/gnome/internal.rs — de implementatie in oo7 van de interne ontgrendelinterface van gnome-keyring, inclusief UnlockWithMasterPassword. ↩︎