Faccio login sul mio portatile con una YubiKey. PIN, tocco, desktop. Nessuna password digitata.

Poi parte la prima app che vuole un segreto salvato e GNOME tira fuori una finestra: «An application wants access to the keyring ‘Login’, but it is locked.» A ogni login. Stessa finestra, stessa domanda, una password che mi era appena stato detto che non mi serviva.

Nessun pezzo singolo è rotto. Ogni parte fa quello per cui è stata costruita. Il guaio è che il portachiavi è stato progettato partendo dal presupposto che un login comporti sempre una password, e un login senza password rompe quel presupposto senza dirlo a nessuno.

Perché un login con la chiave lascia a secco il portachiavi

Il portachiavi di login è dove il desktop conserva i segreti che gli consegnano le app: chiavi del Wi-Fi, chiavi di archiviazione del browser, i token che client di chat, gestori di password e app per videoconferenze usano per restare connessi. Sta su disco cifrato con la tua password di login, e la Secret Service API1 è il modo in cui le app chiedono quello che c’è dentro.

Di solito non lo vedi mai. Digiti la password nella schermata di login, lo stack PAM la verifica sull’account, e un modulo del portachiavi più giù nello stesso stack raccoglie in silenzio quella stessa password e la usa per aprire il portachiavi prima ancora che il desktop abbia finito di disegnarsi. Una password, due lavori.

Il mio stack comincia con questa riga:

auth        sufficient        pam_u2f.so cue

sufficient vuol dire che una YubiKey andata a buon fine chiude l’autenticazione lì su due piedi. È esattamente ciò che Yubico documenta per il login senza password2. Funziona. Vuol dire anche che il passo della password non viene mai eseguito, quindi nello stack non c’è nessuna password che il modulo del portachiavi possa raccogliere. Il portachiavi resta bloccato finché qualcosa non lo chiede, e quel qualcosa è la prima app che parte.

Due modi di entrare, e cosa consegna ciascuno al portachiaviDue modi di entrare, e cosa consegna ciascuno al portachiaviIl portachiavi si apre solo con una password. Un login YubiKey non ne produce mai una, quindi la fornisce lo script.Login con passwordpam_unix verifica la passwordpam_oo7 passa la stessa password a oo7-daemonil portachiavi di login si decifra con quellaportachiavi aperto, nessuna richiestaLogin YubiKey (PIN + tocco)pam_u2f è sufficient, quindi chiude lo stacknessun passo password, nessuna passworda oo7-daemon non arriva nientebloccato, richiesta al primo usoScript di avvio automaticoPIN + tocco, la chiave dà l'hmac-secretdecifra la password salvata, sblocca il portachiaviLe app che leggono il portachiavi aspettano che si apra prima di partire, così nessuna può far comparire prima la richiesta.
Un login con password consegna al portachiavi l’unica cosa con cui può aprirsi. Un login con la chiave non gli consegna niente. Lo script di avvio automatico a destra è la soluzione che questo post descrive.

Le soluzioni abituali, e quanto costa ciascuna

Le risposte comuni sono quattro. Ognuna rinuncia a qualcosa.

SoluzioneCosa ottieniCosa costa
Digitare la password alla richiestaNiente da costruireLa richiesta, a ogni login. La chiave non ti ha risparmiato niente
Password del portachiavi vuotaRichiesta sparitaOgni segreto salvato sta su disco in chiaro
Password e chiave al loginVera autenticazione a due fattori, il portachiavi si apre da soloDigitare la password a ogni login, cioè proprio ciò che la chiave doveva evitare
Password sigillata nel TPM, sbloccata al loginNessuna richiesta, niente da digitareChiunque ottenga una sessione su quella macchina ottiene i segreti. Nessun PIN, nessuna chiave coinvolta
hmac-secret della YubiKey (questo post)Nessuna richiesta, PIN + tocco, il login con password funziona ancoraUn secondo PIN e tocco dopo il login, e uno script da curare

La password vuota è quella con cui finisce la maggior parte delle discussioni sui forum, ed è la peggiore del mucchio. La strada del TPM è rispettabile, ma il TPM non ti chiede mai niente, quindi quello che protegge è un disco estratto dal portatile, non una sessione davanti a cui qualcuno si è seduto mentre tu ti facevi un tè. Volevo il portachiavi legato alla stessa cosa a cui è legato il mio login: la chiave, e il PIN che la accompagna.

La chiave può custodire un segreto

Una chiave FIDO2 fa più che dire sì o no. Lo standard CTAP 2.1 ha un’estensione chiamata hmac-secret, che «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.

Il funzionamento è abbastanza semplice. Quando crei una credenziale, la chiave genera dei valori casuali e li tiene dentro di sé. Più tardi le mandi un salt, e lei ti restituisce un HMAC di quel salt con il suo valore nascosto come chiave. Stessa credenziale, stesso salt, stessa risposta ogni volta. Chiave diversa, niente.

Il dettaglio che conta qui: la chiave custodisce due di quei valori nascosti, CredRandomWithUV e CredRandomWithoutUV3. UV è la user verification, che su questa chiave vuol dire il PIN. Chiedi con il PIN e ottieni un segreto. Chiedi con il solo tocco e ne ottieni uno completamente diverso. Quindi il PIN non è un controllo avvitato davanti al segreto. Fa parte del segreto.

ElementoDove viveDa solo ti dà
ID della credenziale e salt~/.local/share/yubikey-keyring/, file in chiaroNiente. Non sono segreti
Password del portachiavi cifrataStessa cartella, password.encNiente senza il segreto per decifrarla
Valore nascosto della credenzialeDentro la YubiKey, non ne esce maiNiente senza il salt e un tocco
PINLa tua testaSeleziona il segreto con PIN. PIN sbagliato, nessun segreto, e la chiave conta il tentativo

Tutti e quattro insieme restituiscono la password dell’account. Togline uno qualsiasi e sei alla richiesta, che è dove saresti stato comunque.

Cosa ho costruito con Claude

La password del portachiavi è la mia password dell’account, di proposito. Così il login con password continua a funzionare nel modo normale: la digiti nella schermata di login e lo stack PAM apre il portachiavi da solo, nessuno script coinvolto. È la strada della YubiKey quella che ha bisogno di aiuto.

PezzoLavoro
yubikey-keyring-setupUna volta sola. Crea la credenziale FIDO2 sulla chiave con hmac-secret attivo. Servono il PIN e un tocco
yubikey-keyring-resetChiede la password dell’account, la verifica sull’account reale con unix_chkpwd prima di toccare qualsiasi cosa, la cifra con il segreto vincolato al PIN, fa il backup del vecchio portachiavi e crea quello nuovo
yubikey-keyring-unlockGira al login. Finestra del PIN, tocco, decifra, sblocca. Due tentativi per il PIN, poi rinuncia e ti lascia la richiesta normale
wait-for-keyringAvvolge le voci di avvio automatico di ogni app che legge il portachiavi. Le trattiene fino a 60 secondi finché il portachiavi non è aperto

Il segreto esce da fido2-assert4 con -h per hmac-secret, -p per il tocco e -v per il PIN. La password è cifrata con OpenSSL, AES-256 con 200.000 iterazioni di PBKDF2 sul segreto derivato. Al login la password viaggia solo dentro una pipe. Il segreto derivato e, durante un reset, la password digitata stanno per poco in una directory temporanea privata sotto /tmp, che su Fedora è un tmpfs in RAM, e vengono cancellati appena usati. Nessuno dei due finisce mai su una riga di comando dove ps potrebbe vederlo.

wait-for-keyring è il pezzo che la gente salterebbe. Non farlo. L’ordine di avvio automatico non è garantito, e se un’app chiede il suo token un secondo prima che io abbia finito di digitare il PIN, GNOME tira su la vecchia richiesta sopra la mia, e la soluzione sembra rotta quando non lo è.

Gli script sono tuoi da prendere: yubikey-keyring.zip, SHA-256 9b3670cf0f38c1b93e7738d2f68abef0380786d918491973e3ebefa5143e6263. Contiene gli script, un installer, un README e il banco di prova descritto più sotto. Dentro non ci sono credenziali, salt o password. Quelli si creano sulla tua macchina quando lanci il setup. Leggi il README, poi lancia test/run.sh prima di lasciare che una qualsiasi parte si avvicini al tuo vero portachiavi.

Cosa è venuto fuori lavorandoci

Doveva essere un’ora di lavoro. Gran parte della serata se n’è andata in cose che la documentazione non menziona.

Il daemon era cambiato sotto i miei piedi

Ogni guida che ho letto su questo problema parla con gnome-keyring-daemon, e ognuna mi avrebbe mandato nella direzione sbagliata, perché il processo che rispondeva sulla mia macchina era oo7-daemon 0.7.0, una beta. Il portatile era passato a Fedora 45 poco prima quella stessa sera, una transazione dnf da 5.464 passi, e oo7 era arrivato con lei.

oo7 è un’implementazione in Rust del Secret Service, con il suo server e il suo modulo PAM5. Va detto a suo merito che implementa l’interfaccia D-Bus privata di gnome-keyring per lo sblocco con password, così gli strumenti esistenti continuano a funzionare. Quell’interfaccia si chiama org.gnome.keyring.InternalUnsupportedGuiltRiddenInterface6. Il nome ti dice quanto fidarti. Funziona, l’ho provata, e mi aspetto comunque che un giorno cambi.

La prima password che digiti diventa la password del portachiavi

Questa ha spiegato l’intera serata.

Quando oo7 parte e non trova un file di portachiavi non ne crea uno, mostra alle app un segnaposto bloccato chiamato login, e la prima password che qualcuno usa per sbloccare quel segnaposto diventa la password del portachiavi, anche se il file vero e proprio viene scritto solo quando un’app salva il suo primo segreto.

Il mio file di portachiavi è stato creato alle 20:45, e il suo primo elemento veniva da un’app partita pochi secondi prima. Quindi alle 20:45 ho digitato qualcosa in una richiesta che volevo togliermi di torno, e quello è diventato la password. Niente di ciò che ho provato dopo l’ha aperto. Nemmeno il codice di sblocco aveva colpa: l’ho dimostrato su un portachiavi usa e getta con una password nota, che si è bloccato, sbloccato e cancellato senza problemi.

Poi ho controllato il segnaposto su un daemon usa e getta. Prima che il file esista, qualsiasi password lo sblocca, anche una sbagliata. Quindi in quel momento niente ti dice che hai appena impostato una password. Lo scopri al login successivo, quando la password giusta, per quanto ne sai tu, viene rifiutata.

StatoSblocco con una password qualsiasiCosa viene scritto
Nessun file di portachiavi, segnaposto mostratoRiesceAncora niente
Primo elemento salvaton/dFile creato, cifrato con quello che è stato digitato
Ogni login successivoFunziona solo la password delle 20:45n/d

Così ho smesso di inseguirlo. Il reset fa il backup del vecchio portachiavi, sblocca il segnaposto con la password dell’account, e salva subito un elemento marcatore così il file viene scritto lì su due piedi, con una password che conosco.

Gli strumenti FIDO2 accettano il PIN solo da un terminale

fido2-cred e fido2-assert leggono il PIN dal terminale di controllo e da nessun’altra parte. Uno script avviato al login non ha un terminale. Quindi c’è un piccolo wrapper che lancia lo strumento sotto uno pseudo-terminale, aspetta la parola PIN nel suo output, e ci digita il PIN preso da una finestra di dialogo. Venti righe di Python. Non è bello, ma fa il suo lavoro e il PIN non tocca mai un file o una lista di argomenti.

Provalo dove non può farti male

La cosa più utile che ha fatto Claude Code è stata rifiutarsi di fidarsi dello script di reset sul mio vero portachiavi. Ha eseguito tutto il flusso prima su un secondo oo7-daemon in una sessione D-Bus privata (dbus-run-session), con una home usa e getta, un vecchio portachiavi finto e una password di prova con dentro £, @, " e #.

La prima esecuzione è fallita. Bene. Il reset ha spostato il vecchio portachiavi nel suo backup, ha riavviato il daemon, ha visto il segnaposto login di oo7, l’ha preso per un portachiavi vero e si è fermato. Sulla mia macchina mi avrebbe lasciato senza alcun portachiavi e con un backup da ripristinare a mano. Ora lo script sblocca il segnaposto invece di rifiutarlo, e se qualcosa fallisce dopo che il backup è stato fatto, rimette a posto da solo il vecchio portachiavi.

Anche il controllo di sicurezza di Claude Code ha fermato una versione precedente del reset sul portachiavi vero finché non l’ho confermata io. Irritante sul momento. Giusta scelta.

Test, sul daemon usa e gettaRisultato
Reset da una richiesta nel terminale, vecchio portachiavi salvatoSuperato
Vecchia password sul nuovo portachiaviRifiutata
Daemon nuovo, come al loginParte bloccato
Password sbagliataRifiutata
Password corretta, lo stesso percorso di un login con passwordSblocca
Daemon nuovo, PIN + tocco tramite lo script di sbloccoSblocca
Script di sblocco con il portachiavi già apertoEsce subito, nessun tocco richiesto

Poi un’altra volta sulla cosa vera, con il portachiavi bloccato a mano e lo script di sblocco lanciato come lo lancia il login: PIN, tocco, aperto.

Gli spigoli

È una configurazione che funziona, non un prodotto finito, e questi sono i pezzi che conosco.

  • Due inserimenti del PIN per ogni login con la chiave. Uno alla schermata di login per PAM, uno per il portachiavi. Sono richieste separate alla chiave e la chiave non le unisce. Un portachiavi con il solo tocco ne risparmierebbe uno, al prezzo di un PIN che dopo il login non protegge niente.
  • Cambia la password dell’account e la copia salvata diventa vecchia. Lo script di sblocco te lo dice con una notifica invece di fallire in silenzio. Rilancia il reset ed è sistemato.
  • Perdi la chiave e torni a digitare la password. Non si perde niente, perché la password è ancora quella dell’account.
  • Alcune app riscrivono i propri file di avvio automatico. Se una di loro tira di nuovo fuori la richiesta, è per questo, e il wrapper va rimesso.
  • oo7 è una beta, e la chiamata di sblocco passa da un’interfaccia con «Unsupported» nel nome. Ogni aggiornamento di oo7 merita un login di prova prima di farci affidamento.

Chiusura

Il portachiavi non è mai stato rotto. Nemmeno la chiave. Sono stati costruiti su presupposti diversi su cosa sia un login, e nessuno a monte li ha collegati. Il login senza password è documentato da Yubico, incluso nei profili authselect di Fedora e attivato con un solo feature flag. In niente di tutto questo c’è scritto che nel momento in cui lo usi, ogni segreto che il tuo desktop custodisce resta chiuso dietro una password che non digiti più.

Per questo il buco ricade su chi è seduto alla macchina, e la soluzione vale quanto la comprensione che quella persona ha di dove stia davvero il segreto. La risposta facile, una password vuota, è quella verso cui viene indirizzata la maggior parte della gente, e scambia una finestra di dialogo con un file non cifrato di ogni token che possiedi. Non è una soluzione. È arrendersi in silenzio.

La forma giusta c’era da sempre. La chiave può custodire un segreto, lo standard lo dice parola per parola, e il PIN può far parte di quel segreto invece di essere una porta davanti. Ci sono volute una serata e un banco di prova per collegarla. Non avrebbe dovuto servire né l’una né l’altro.


  1. freedesktop.org, Secret Service API Draft — l’API D-Bus che le app desktop usano per salvare e recuperare segreti, implementata sia da gnome-keyring sia da oo7. ↩︎

  2. Yubico, pam-u2f — «For a passwordless experience, where the authenticator PIN can be used in place of the user password», con la riga d’esempio 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», e «The authenticator generates two random 32-byte values (called CredRandomWithUV and CredRandomWithoutUV)». ↩︎ ↩︎

  4. Yubico, libfido2 fido2-assert manual — lo strumento da riga di comando usato per richiedere un’asserzione, con le opzioni per hmac-secret, presenza dell’utente e PIN. ↩︎

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

  6. oo7 source, server/src/gnome/internal.rs — l’implementazione in oo7 dell’interfaccia di sblocco interna di gnome-keyring, compresa UnlockWithMasterPassword. ↩︎