YubiKey als Login unter Linux Mint, Ubuntu und Debian einrichten
Mit einem YubiKey als Login unter Linux braucht ihr zum Anmelden nicht nur euer Passwort, sondern auch den Schlüssel am USB-Anschluss: Wer euer Passwort kennt, kommt ohne den YubiKey nicht ins System. Unter Linux Mint, Ubuntu, Kubuntu und Debian übernimmt das das PAM-Modul pam_u2f von Yubico, das mit jedem FIDO2- oder U2F-Schlüssel funktioniert. In dieser Anleitung registriert ihr einen Haupt- und einen Ersatzschlüssel, tragt das Modul so in die Anmeldung ein, dass es auch wirklich greift, und testet alles, bevor ihr euch abmeldet. Denn eine falsche Zeile in der PAM-Konfiguration sperrt nicht nur Angreifer aus, sondern zuverlässig auch euch selbst.

Was ihr für den YubiKey Linux Login braucht
- Einen YubiKey mit FIDO2 oder U2F, etwa den YubiKey 5 NFC oder den YubiKey 5C NFC.
- Einen zweiten Schlüssel als Ersatz. Geht der einzige Schlüssel verloren oder kaputt, kommt ihr nicht mehr ins System.
- Linux Mint, Ubuntu, Kubuntu oder Debian und ein Benutzerkonto mit
sudo-Rechten. - Einen Live-USB-Stick für den Notfall, falls doch etwas schiefgeht.
Pakete installieren
Öffnet ein Terminal und installiert das PAM-Modul und das Werkzeug zum Registrieren der Schlüssel:
sudo apt update && sudo apt install libpam-u2f pamu2fcfg
libpam-u2fenthält das PAM-Modulpam_u2f.so, das bei der Anmeldung den Schlüssel abfragt.pamu2fcfgregistriert einen Schlüssel und gibt die Zeile aus, die in die Schlüsseldatei gehört.
Die Pakete libpam-yubico und yubikey-personalization, die in manchen Anleitungen auftauchen, sind für das ältere Yubico-OTP-Verfahren gedacht und werden für diesen Weg nicht gebraucht.
YubiKey registrieren
Die registrierten Schlüssel landen in einer gemeinsamen Datei unter /etc/Yubico/u2f_keys. Das hat einen Vorteil gegenüber der Vorgabe im Home-Verzeichnis: Laut Yubico macht eine Schlüsseldatei in einem verschlüsselten Home-Verzeichnis die Anmeldung unmöglich, weil die Datei erst nach dem Login lesbar ist. Legt zuerst das Verzeichnis an:
sudo mkdir -p /etc/Yubico
Steckt den YubiKey ein und registriert ihn. Wichtig ist die Schreibweise: pamu2fcfg läuft als euer eigener Benutzer, nur das Schreiben in die Datei geschieht mit Root-Rechten über sudo tee:
pamu2fcfg | sudo tee /etc/Yubico/u2f_keys
Der Schlüssel beginnt zu blinken; tippt auf die Kontaktfläche, um die Registrierung zu bestätigen. Die Variante sudo pamu2fcfg > /etc/Yubico/u2f_keys funktioniert nicht: Die Umleitung mit > führt eure Shell ohne Root-Rechte aus, das Ergebnis ist Permission denied. Und liefe pamu2fcfg selbst mit sudo, würde der Schlüssel für root registriert, denn laut pamu2fcfg(1) gilt ohne Angabe der aktuelle Benutzer.
Ersatzschlüssel hinzufügen
Zieht den ersten Schlüssel ab, steckt den Ersatzschlüssel ein und hängt ihn an dieselbe Zeile an:
pamu2fcfg -n | sudo tee -a /etc/Yubico/u2f_keys
Die Option -n lässt den Benutzernamen weg, und weil pamu2fcfg keinen Zeilenumbruch ausgibt, landet der zweite Schlüssel auf derselben Zeile. Genau so verlangt es pam_u2f(8): eine Zeile pro Benutzer im Format benutzer:Schlüssel1:Schlüssel2. Prüft das Ergebnis:
cat /etc/Yubico/u2f_keys
Ihr seht genau eine Zeile, die mit eurem Benutzernamen beginnt, gefolgt von zwei durch Doppelpunkt getrennten Blöcken. Steht dort root: oder ist die Datei leer, wiederholt den Schritt.
Soll ein weiterer Benutzer auf demselben Rechner einen Schlüssel bekommen, braucht er eine eigene Zeile. Dafür zuerst einen Zeilenumbruch anhängen und dann mit -u den Benutzernamen angeben, im Beispiel anna:
echo | sudo tee -a /etc/Yubico/u2f_keys
pamu2fcfg -u anna | sudo tee -a /etc/Yubico/u2f_keys
PAM einrichten: die Zeile an die richtige Stelle
Öffnet zuerst ein zweites Terminal und darin eine Root-Shell, die ihr bis zum Schluss offen lasst:
sudo -i
Yubico rät ausdrücklich dazu, weil eine fehlerhafte PAM-Konfiguration einzelne oder alle Benutzer aussperren kann. Mit der offenen Root-Shell könnt ihr jeden Fehler sofort rückgängig machen.
Im ersten Terminal öffnet ihr die gemeinsame Anmeldekonfiguration:
sudo nano /etc/pam.d/common-auth
Geht ans Ende der Datei, unter die Zeile # end of pam-auth-update config, und fügt dort diese Zeile ein:
auth required pam_u2f.so authfile=/etc/Yubico/u2f_keys cue
authfile zeigt auf die Datei, die ihr eben angelegt habt; der Pfad muss Buchstabe für Buchstabe stimmen. cue blendet einen Hinweis ein, dass ihr den Schlüssel antippen sollt. Speichert mit Strg+O und beendet nano mit Strg+X.
Warum die Zeile ans Ende gehört
Am Anfang von common-auth steht die Passwortprüfung mit einer Sprunganweisung, auf Debian und Linux Mint etwa auth [success=1 default=ignore] pam_unix.so nullok, auf Ubuntu mit installiertem SSSD success=2. Ist das Passwort richtig, überspringt PAM die nächsten ein oder zwei Zeilen und landet auf pam_permit.so. Setzt ihr pam_u2f zwischen die Passwortprüfung und auth requisite pam_deny.so, wird beim Überspringen eure neue Zeile mitgezählt, und PAM landet bei richtigem Passwort auf pam_deny.so. Dann scheitert jede Anmeldung, auch sudo, mit und ohne Schlüssel. Wir haben das mit pamtester nachgestellt: An dieser Stelle schlägt die Anmeldung mit korrektem Passwort fehl, am Ende der Datei klappt sie nur mit Passwort und Schlüssel.
Die Datei selbst empfiehlt in ihren Kommentaren, eigene Module vor oder nach dem Block einzutragen, den pam-auth-update verwaltet. Welche Dienste common-auth einbinden, zeigt grep -l common-auth /etc/pam.d/*. Dazu gehören unter anderem login, su und sudo, je nach Desktop auch die grafische Anmeldung und die Bildschirmsperre. Wer den Schlüssel nur für sudo verlangen will, nimmt stattdessen den Weg aus Sudo-Befehle mit YubiKey absichern; beides zusammen führt dazu, dass ihr bei sudo zweimal tippen müsst.
Testen, solange die Root-Shell offen ist
Öffnet ein drittes Terminal, damit kein zwischengespeichertes sudo-Recht das Ergebnis verfälscht:
sudo -k
sudo true
- Mit eingestecktem Schlüssel: Passwort eingeben, der Schlüssel blinkt, antippen. Der Befehl muss ohne Fehlermeldung durchlaufen.
- Ohne Schlüssel:
sudo -kundsudo truewiederholen. Nach dem Passwort muss die Anmeldung scheitern. - Mit dem Ersatzschlüssel: dasselbe noch einmal, es muss wieder klappen.
- Sperrt den Bildschirm und entsperrt ihn mit Passwort und Schlüssel.
Klappt Schritt 1 nicht, entfernt die Zeile in der Root-Shell sofort wieder: nano /etc/pam.d/common-auth. Erst wenn alle vier Schritte funktionieren, schliesst ihr die Root-Shell und meldet euch ab.
Optional: Schlüssel antippen statt Passwort tippen
Wer sich lieber ohne Passwort anmeldet, setzt pam_u2f nicht ans Ende, sondern als erste auth-Zeile in common-auth, vor die Passwortprüfung, und mit sufficient statt required:
auth sufficient pam_u2f.so authfile=/etc/Yubico/u2f_keys cue
Ist der Schlüssel eingesteckt und wird angetippt, seid ihr ohne Passwort angemeldet. Fehlt er, fragt das System wie gewohnt nach dem Passwort. Nehmt entweder diese Zeile oder die vom Ende der Datei, nicht beide. Bedenkt dabei: Das ist kein zweiter Faktor mehr, sondern ein anderer. Wer euren Schlüssel in die Hände bekommt, kommt an eurem Rechner ohne Passwort hinein. Wer das abfedern will, ergänzt pinverification=1; dann verlangt der Schlüssel zusätzlich seine FIDO2-PIN, wie im Beispiel in pam_u2f(8).
Das Passwort ganz abzuschalten, indem ihr die Zeile mit pam_unix.so auskommentiert, ist keine gute Idee: Damit verschieben sich die Sprungziele des Blocks, und die Anmeldung scheitert je nach Aufbau der Datei vollständig.
Bevor ihr euch abmeldet
- Pfad prüfen: Der Pfad hinter
authfile=muss genau der sein, unter dem die Datei liegt.ls -l /etc/Yubico/u2f_keysmuss die Datei zeigen. Findetpam_u2fdie Datei nicht, scheitert die Anmeldung; im Test mitpamtesterlautete die MeldungAuthentication service cannot retrieve authentication info. - Benutzer prüfen: Die Zeile in der Datei muss mit eurem Benutzernamen beginnen, nicht mit
root. - Schlüssel erkannt?
lsusb | grep -i yubimuss den YubiKey auflisten. - Protokoll lesen:
journalctl -b | grep -i pam_u2fzeigt, was das Modul beim letzten Versuch gemeldet hat. - Ersatzschlüssel getestet und an einem anderen Ort aufbewahrt als der Hauptschlüssel.

Wenn ihr euch ausgesperrt habt
Ist die Root-Shell schon zu und die Anmeldung scheitert, startet den Rechner vom Live-USB-Stick, bindet die Systempartition ein und entfernt die pam_u2f-Zeile aus /etc/pam.d/common-auth auf der Festplatte. Wie ihr die Partition vom Live-System aus einbindet und mit chroot darin arbeitet, steht in Linux-Passwort zurücksetzen mit chroot. Ist die Festplatte mit LUKS verschlüsselt, müsst ihr sie vorher mit eurer Passphrase entsperren.
Fazit: Der YubiKey schützt den Login nur, wenn die PAM-Zeile richtig sitzt
Mit pam_u2f wird aus dem Login unter Linux eine echte Zwei-Faktor-Anmeldung: Passwort plus Schlüssel, für Anmeldung, Bildschirmsperre und sudo zugleich. Die Einrichtung ist in zehn Minuten erledigt, die Tücken liegen in drei Details: Die Schlüsseldatei muss für euren Benutzer und nicht für root geschrieben sein, der Pfad in der PAM-Zeile muss exakt stimmen, und die Zeile gehört ans Ende von common-auth, nicht zwischen die Sprünge. Wer das beachtet und mit offener Root-Shell testet, hat ein System, das ohne Schlüssel niemanden hereinlässt. Wer es nicht beachtet, auch.
Weitere Anleitungen mit dem YubiKey: Server-SSH-Zugang mit YubiKey absichern, Windows mit YubiKey einrichten und Nextcloud mit U2F und YubiKey absichern. Was Hardwareschlüssel von Passkeys unterscheidet, steht in Passkeys: Vor- und Nachteile. Fragen gehören in die Kommentare.
Hi, danke für das Guide Mario!
Kurze Anmerkung für „Permission denied“-Error beim Anlegen der Keydatei:
Für das Nutzen von 2FA per-user ist das Erstellen des Verzeichnisses ~/etc/Yubico mit „sudo“ für den eigenen Benutzer nicht zielführend.
Da muss man nachträglich noch mit „chown -R [user]:[user] ~/etc“ drüber bügeln, damit der Prozess dort schreiben kann.
Kann das sein, dass du im ersten Schritt /etc/Yubico anlegst und dann in deinen weiteren Schritten /etc/YubiKey angibst? Hast du da was durcheinander gebracht oder hab ich nen Denkfehler?