Ich melde mich an meinem Laptop mit einem YubiKey an. PIN, Berührung, Desktop. Kein Passwort getippt.
Dann startet die erste App, die ein gespeichertes Geheimnis will, und GNOME wirft ein Fenster hoch: „An application wants access to the keyring ‘Login’, but it is locked.“ Bei jedem Login. Dasselbe Fenster, dieselbe Frage, ein Passwort, von dem mir gerade gesagt wurde, dass ich es nicht brauche.
Kein einzelnes Teil ist kaputt. Jedes Teil tut, wofür es gebaut wurde. Das Problem ist, dass der Schlüsselbund unter der Annahme entworfen wurde, dass zu einem Login immer ein Passwort gehört, und ein passwortloser Login bricht diese Annahme, ohne es irgendwem zu sagen.
Warum ein Schlüssel-Login den Schlüsselbund aushungert
Im Login-Schlüsselbund bewahrt der Desktop die Geheimnisse auf, die Apps ihm geben: WLAN-Schlüssel, Speicherschlüssel des Browsers, die Tokens, mit denen Chat-Clients, Passwortmanager und Konferenz-Apps angemeldet bleiben. Er liegt verschlüsselt mit deinem Login-Passwort auf der Platte, und über die Secret Service API1 fragen Apps nach dem, was drin ist.
Normalerweise siehst du ihn nie. Du tippst dein Passwort am Anmeldebildschirm, der PAM-Stack prüft es gegen das Konto, und ein Schlüsselbund-Modul weiter unten im selben Stack nimmt still dasselbe Passwort auf und öffnet damit den Schlüsselbund, bevor dein Desktop überhaupt fertig gezeichnet ist. Ein Passwort, zwei Aufgaben.
Mein Stack beginnt mit dieser Zeile:
auth sufficient pam_u2f.so cue
sufficient heißt, dass ein erfolgreicher YubiKey die Authentifizierung auf der Stelle beendet. Genau so dokumentiert Yubico den passwortlosen Login2. Es funktioniert. Es heißt aber auch, dass der Passwortschritt nie läuft, also gibt es im Stack kein Passwort, das das Schlüsselbund-Modul aufnehmen könnte. Der Schlüsselbund bleibt gesperrt, bis etwas nach ihm fragt, und dieses Etwas ist die App, die zuerst startet.
Die üblichen Lösungen und was jede kostet
Es gibt vier gängige Antworten darauf. Jede gibt etwas auf.
| Lösung | Was du bekommst | Was es kostet |
|---|---|---|
| Das Passwort an der Abfrage tippen | Nichts zu bauen | Die Abfrage, bei jedem Login. Der Schlüssel hat dir nix erspart |
| Leeres Schlüsselbund-Passwort | Abfrage weg | Jedes gespeicherte Geheimnis liegt unverschlüsselt auf der Platte |
| Passwort und Schlüssel beim Login | Echte Zwei-Faktor-Anmeldung, der Schlüsselbund öffnet sich selbst | Das Passwort bei jedem Login tippen, und genau dafür war der Schlüssel da |
| Im TPM versiegeltes Passwort, beim Login entsperrt | Keine Abfrage, kein Tippen | Wer eine Sitzung auf dieser Maschine bekommt, bekommt die Geheimnisse. Keine PIN, kein Schlüssel beteiligt |
| YubiKey hmac-secret (dieser Beitrag) | Keine Abfrage, PIN + Berührung, Passwort-Login funktioniert weiter | Eine zweite PIN und Berührung nach dem Login, und ein Skript, um das man sich kümmern muss |
Beim leeren Passwort enden die meisten Forenthreads, und es ist das schlechteste von allen. Der TPM-Weg ist respektabel, aber das TPM fragt dich nie etwas, also schützt es eine Platte, die aus dem Laptop gezogen wurde, nicht eine Sitzung, an die sich jemand gesetzt hat, während du dir einen Tee gemacht hast. Ich wollte den Schlüsselbund an dasselbe binden, woran mein Login gebunden ist: den Schlüssel und die PIN, die dazugehört.
Der Schlüssel kann ein Geheimnis halten
Ein FIDO2-Schlüssel kann mehr als Ja oder Nein sagen. Der Standard CTAP 2.1 hat eine Erweiterung namens hmac-secret, 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.
Wie das funktioniert, ist einfach genug. Wenn du ein Credential erzeugst, generiert der Schlüssel Zufallswerte und behält sie in sich. Später schickst du ihm ein Salt, und er gibt einen HMAC dieses Salts zurück, mit seinem verborgenen Wert als Schlüssel. Dasselbe Credential, dasselbe Salt, jedes Mal dieselbe Antwort. Anderer Schlüssel, nichts.
Das Detail, auf das es hier ankommt: Der Schlüssel hält zwei dieser verborgenen Werte, CredRandomWithUV und CredRandomWithoutUV3. UV ist User Verification, und das heißt auf diesem Schlüssel die PIN. Frag mit der PIN, und du bekommst ein Geheimnis. Frag nur mit einer Berührung, und du bekommst ein völlig anderes. Die PIN ist also keine Prüfung, die vor das Geheimnis geschraubt ist. Sie ist Teil des Geheimnisses.
| Eingabe | Wo sie liegt | Allein bringt sie dir |
|---|---|---|
| Credential-ID und Salt | ~/.local/share/yubikey-keyring/, normale Dateien | Nichts. Sie sind nicht geheim |
| Verschlüsseltes Schlüsselbund-Passwort | Derselbe Ordner, password.enc | Nichts ohne das Geheimnis zum Entschlüsseln |
| Verborgener Credential-Wert | Im YubiKey, verlässt ihn nie | Nichts ohne das Salt und eine Berührung |
| PIN | Dein Kopf | Wählt das Geheimnis mit PIN. Falsche PIN, kein Geheimnis, und der Schlüssel zählt den Versuch |
Alle vier zusammen geben das Kontopasswort zurück. Nimm eines weg, und du stehst an der Abfrage, wo du ohnehin gestanden hättest.
Was ich mit Claude gebaut habe
Das Schlüsselbund-Passwort ist mein Kontopasswort, mit Absicht. So funktioniert der Passwort-Login weiter wie gewohnt: Tipp es am Anmeldebildschirm, und der PAM-Stack öffnet den Schlüsselbund selbst, ohne Skript. Der YubiKey-Weg ist der, der Hilfe braucht.
| Teil | Aufgabe |
|---|---|
yubikey-keyring-setup | Einmalig. Erzeugt das FIDO2-Credential auf dem Schlüssel mit aktiviertem hmac-secret. Braucht die PIN und eine Berührung |
yubikey-keyring-reset | Fragt nach dem Kontopasswort, prüft es mit unix_chkpwd gegen das echte Konto, bevor es irgendetwas anfasst, verschlüsselt es mit dem PIN-gebundenen Geheimnis, sichert den alten Schlüsselbund und legt den neuen an |
yubikey-keyring-unlock | Läuft beim Login. PIN-Dialog, Berührung, entschlüsseln, entsperren. Zwei Versuche für die PIN, dann gibt es auf und lässt dir die normale Abfrage |
wait-for-keyring | Umhüllt die Autostart-Einträge jeder App, die den Schlüsselbund liest. Hält jede bis zu 60 Sekunden zurück, bis der Schlüsselbund offen ist |
Das Geheimnis kommt aus fido2-assert4, mit -h für hmac-secret, -p für die Berührung und -v für die PIN. Das Passwort wird mit OpenSSL verschlüsselt, AES-256 mit 200.000 Runden PBKDF2 auf dem abgeleiteten Geheimnis. Beim Login wandert das Passwort nur durch eine Pipe. Das abgeleitete Geheimnis und, während eines Resets, das getippte Passwort liegen kurz in einem privaten temporären Verzeichnis unter /tmp, das unter Fedora ein RAM-gestütztes tmpfs ist, und werden gelöscht, sobald sie benutzt sind. Keines von beiden landet je auf einer Kommandozeile, wo ps es sehen könnte.
wait-for-keyring ist das Teil, das die Leute weglassen würden. Lass es nicht weg. Die Autostart-Reihenfolge ist nicht garantiert, und wenn eine App eine Sekunde, bevor ich die PIN fertig getippt habe, nach ihrem Token fragt, legt GNOME die alte Abfrage über meine, und die Lösung sieht kaputt aus, obwohl sie es nicht ist.
Die Skripte darfst du dir nehmen: yubikey-keyring.zip, SHA-256 9b3670cf0f38c1b93e7738d2f68abef0380786d918491973e3ebefa5143e6263. Darin sind die Skripte, ein Installer, eine README und das unten beschriebene Test-Harness. Kein Credential, kein Salt und kein Passwort ist darin. Die entstehen auf deiner eigenen Maschine, wenn du das Setup ausführst. Lies die README, dann führ test/run.sh aus, bevor du irgendetwas davon an deinen echten Schlüsselbund lässt.
Was der Aufbau zutage gefördert hat
Das sollte eine Stunde Arbeit sein. Der größte Teil des Abends ging für Dinge drauf, die die Dokumentation nicht erwähnt.
Der Daemon hatte sich unter mir geändert
Jede Anleitung, die ich zu diesem Problem gelesen habe, spricht mit gnome-keyring-daemon, und jede einzelne hätte mich in die falsche Richtung geschickt, denn der Prozess, der auf meiner Maschine antwortete, war oo7-daemon 0.7.0, eine Beta. Der Laptop war am selben Abend auf Fedora 45 gegangen, eine dnf-Transaktion mit 5.464 Schritten, und oo7 war mit ihr gekommen.
oo7 ist eine Implementierung des Secret Service in Rust, mit eigenem Server und eigenem PAM-Modul5. Man muss ihm zugutehalten, dass es die private D-Bus-Schnittstelle von gnome-keyring zum Entsperren mit einem Passwort implementiert, sodass bestehende Werkzeuge weiter funktionieren. Diese Schnittstelle heißt org.gnome.keyring.InternalUnsupportedGuiltRiddenInterface6. Der Name sagt dir, wie weit du ihr trauen kannst. Sie funktioniert, ich habe sie getestet, und ich würde trotzdem erwarten, dass sie sich eines Tages ändert.
Das erste Passwort, das du tippst, wird das Schlüsselbund-Passwort
Das hat den ganzen Abend erklärt.
Wenn oo7 startet und keine Schlüsselbund-Datei findet, legt es keine an. Es zeigt den Apps einen gesperrten Platzhalter namens login, und das erste Passwort, mit dem irgendjemand diesen Platzhalter entsperrt, wird das Schlüsselbund-Passwort, auch wenn die Datei selbst erst geschrieben wird, wenn eine App ihr erstes Geheimnis speichert.
Meine Schlüsselbund-Datei wurde um 20:45 angelegt, und ihr erster Eintrag kam von einer App, die ein paar Sekunden vorher gestartet war. Um 20:45 habe ich also etwas in eine Abfrage getippt, die ich aus dem Weg haben wollte, und das wurde das Passwort. Nichts, was ich danach probiert habe, hat ihn geöffnet. Am Entsperrcode lag es auch nicht: Das habe ich auf einem Wegwerf-Schlüsselbund mit bekanntem Passwort bewiesen, der sich sauber sperren, entsperren und löschen ließ.
Dann habe ich den Platzhalter auf einem Wegwerf-Daemon geprüft. Bevor die Datei existiert, entsperrt ihn jedes Passwort, auch ein falsches. Nichts sagt dir also in dem Moment, dass du gerade ein Passwort gesetzt hast. Du merkst es beim nächsten Login, wenn das richtige Passwort, soweit du weißt, abgewiesen wird.
| Zustand | Entsperren mit beliebigem Passwort | Was geschrieben wird |
|---|---|---|
| Keine Schlüsselbund-Datei, Platzhalter angezeigt | Klappt | Noch nichts |
| Erster Eintrag gespeichert | entfällt | Datei angelegt, verschlüsselt mit dem, was getippt wurde |
| Jeder Login danach | Nur das Passwort von 20:45 funktioniert | entfällt |
Also habe ich aufgehört, dem hinterherzujagen. Der Reset sichert den alten Schlüsselbund, entsperrt den Platzhalter mit dem Kontopasswort und speichert sofort einen Markereintrag, damit die Datei auf der Stelle geschrieben wird, mit einem Passwort, das ich kenne.
Die FIDO2-Werkzeuge nehmen eine PIN nur von einem Terminal
fido2-cred und fido2-assert lesen die PIN vom steuernden Terminal und von nirgends sonst. Ein Skript, das beim Login gestartet wird, hat kein Terminal. Also gibt es einen kleinen Wrapper, der das Werkzeug unter einem Pseudo-Terminal ausführt, auf das Wort PIN in seiner Ausgabe wartet und die PIN aus einem Dialog hineintippt. Zwanzig Zeilen Python. Nicht hübsch, aber es tut seinen Job, und die PIN berührt nie eine Datei oder eine Argumentliste.
Test es dort, wo es dir nicht schaden kann
Das Nützlichste, was Claude Code getan hat, war, dem Reset-Skript auf meinem echten Schlüsselbund nicht zu trauen. Es hat den ganzen Ablauf zuerst gegen einen zweiten oo7-daemon auf einer privaten D-Bus-Sitzung (dbus-run-session) laufen lassen, mit einem Wegwerf-Home-Verzeichnis, einem falschen alten Schlüsselbund und einem Testpasswort mit £, @, " und # darin.
Der erste Lauf schlug fehl. Gut so. Der Reset verschob den alten Schlüsselbund in sein Backup, startete den Daemon neu, sah den Platzhalter login von oo7, hielt ihn für einen echten Schlüsselbund und brach ab. Auf meiner Maschine hätte mich das ganz ohne Schlüsselbund zurückgelassen, mit einem Backup, das ich von Hand hätte zurückspielen müssen. Das Skript entsperrt den Platzhalter jetzt, statt ihn abzulehnen, und wenn nach dem Backup irgendetwas fehlschlägt, legt es den alten Schlüsselbund von selbst zurück.
Die eigene Sicherheitsprüfung von Claude Code hat außerdem eine frühere Version des Resets auf dem echten Schlüsselbund angehalten, bis ich sie bestätigt hatte. Damals nervig. Richtige Entscheidung.
| Test, auf dem Wegwerf-Daemon | Ergebnis |
|---|---|
| Reset von einer Terminal-Abfrage, alter Schlüsselbund gesichert | Bestanden |
| Altes Passwort gegen den neuen Schlüsselbund | Abgewiesen |
| Frischer Daemon, wie beim Login | Startet gesperrt |
| Falsches Passwort | Abgewiesen |
| Richtiges Passwort, derselbe Weg wie bei einem Passwort-Login | Entsperrt |
| Frischer Daemon, PIN + Berührung über das Entsperrskript | Entsperrt |
| Entsperrskript bei schon offenem Schlüsselbund | Beendet sich sofort, fragt nach keiner Berührung |
Dann noch einmal auf dem echten System, mit von Hand gesperrtem Schlüsselbund und dem Entsperrskript so ausgeführt, wie der Login es ausführt: PIN, Berührung, offen.
Die rauen Kanten
Es ist ein funktionierendes Setup, kein fertiges Produkt, und das sind die Stellen, die ich kenne.
- Zwei PIN-Eingaben pro Schlüssel-Login. Eine am Anmeldebildschirm für PAM, eine für den Schlüsselbund. Es sind getrennte Anfragen an den Schlüssel, und der Schlüssel fasst sie nicht zusammen. Ein Schlüsselbund nur mit Berührung würde eine sparen, um den Preis, dass die PIN nach dem Login nichts mehr schützt.
- Ändere das Kontopasswort, und die gespeicherte Kopie ist veraltet. Das Entsperrskript sagt das in einer Benachrichtigung, statt still zu scheitern. Führ den Reset noch einmal aus, und es ist erledigt.
- Verlier den Schlüssel, und du tippst wieder das Passwort. Nichts geht verloren, weil das Passwort immer noch das Kontopasswort ist.
- Manche Apps schreiben ihre eigenen Autostart-Dateien neu. Wenn eine davon je wieder die Abfrage hochholt, ist das der Grund, und der Wrapper muss wieder eingesetzt werden.
- oo7 ist eine Beta, und der Entsperraufruf geht über eine Schnittstelle mit „Unsupported“ im Namen. Jedes Update von oo7 ist einen Test-Login wert, bevor man sich darauf verlässt.
Zum Schluss
Der Schlüsselbund war nie kaputt. Der Schlüssel auch nicht. Sie wurden auf unterschiedlichen Annahmen darüber gebaut, was ein Login ist, und upstream hat niemand sie zusammengebracht. Passwortloser Login ist von Yubico dokumentiert, steckt in den authselect-Profilen von Fedora und wird mit einem einzigen Feature-Flag eingeschaltet. Nix davon sagt dir, dass in dem Moment, in dem du ihn benutzt, jedes Geheimnis, das dein Desktop hält, hinter einem Passwort gesperrt bleibt, das du nicht mehr tippst.
Insofern fällt die Lücke dem zu, der an der Maschine sitzt, und die Lösung ist nur so gut wie das Verständnis dieser Person davon, wo das Geheimnis tatsächlich liegt. Die bequeme Antwort, ein leeres Passwort, ist die, auf die die meisten verwiesen werden, und sie tauscht ein Dialogfenster gegen eine unverschlüsselte Datei mit jedem Token, das du besitzt. Das ist keine Lösung. Das ist stilles Aufgeben.
Die richtige Form war die ganze Zeit da. Der Schlüssel kann ein Geheimnis halten, der Standard sagt es wörtlich, und die PIN kann Teil dieses Geheimnisses sein statt einer Tür davor. Es hat einen Abend und ein Test-Harness gekostet, das zu verdrahten. Es hätte keins von beidem brauchen sollen.
freedesktop.org, Secret Service API Draft — die D-Bus-API, mit der Desktop-Apps Geheimnisse speichern und abrufen und die sowohl gnome-keyring als auch oo7 implementieren. ↩︎
Yubico, pam-u2f — „For a passwordless experience, where the authenticator PIN can be used in place of the user password“, mit der Beispielzeile
auth sufficient pam_u2f.so authfile=/etc/u2f_mappings cue pinverification=1. ↩︎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“ und „The authenticator generates two random 32-byte values (called CredRandomWithUV and CredRandomWithoutUV)“. ↩︎ ↩︎
Yubico, libfido2 fido2-assert manual — das Kommandozeilenwerkzeug, mit dem eine Assertion angefordert wird, mit den Optionen für hmac-secret, Benutzeranwesenheit und PIN. ↩︎
linux-credentials/oo7 on GitHub — „server: org.freedesktop.secrets server implementation“ und „pam: PAM integration for the server implementation“. ↩︎
oo7 source, server/src/gnome/internal.rs — die Implementierung der internen Entsperr-Schnittstelle von gnome-keyring in oo7, einschließlich
UnlockWithMasterPassword. ↩︎