Inicio sesión en mi portátil con una YubiKey. PIN, toque, escritorio. Ninguna contraseña tecleada.

Entonces arranca la primera aplicación que quiere un secreto guardado y GNOME saca un cuadro: «An application wants access to the keyring ‘Login’, but it is locked.» En cada inicio de sesión. El mismo cuadro, la misma pregunta, una contraseña que acababan de decirme que no necesitaba.

No hay ninguna pieza rota. Cada parte hace lo que se construyó para hacer. El problema es que el llavero se diseñó suponiendo que un inicio de sesión siempre implica una contraseña, y un inicio de sesión sin contraseña rompe esa suposición sin avisar a nadie.

Por qué entrar con la llave deja al llavero sin nada

El llavero de inicio de sesión es donde el escritorio guarda los secretos que le entregan las aplicaciones: claves de Wi-Fi, claves de almacenamiento del navegador, los tokens que usan los clientes de chat, los gestores de contraseñas y las aplicaciones de videoconferencia para seguir con la sesión iniciada. Está en disco cifrado con tu contraseña de inicio de sesión, y la API Secret Service1 es la forma en que las aplicaciones piden lo que hay dentro.

Normalmente nunca lo ves. Tecleas tu contraseña en la pantalla de inicio, la pila PAM la comprueba contra la cuenta, y un módulo de llavero más abajo en esa misma pila recoge sin hacer ruido esa misma contraseña y la usa para abrir el llavero antes de que tu escritorio haya terminado de dibujarse. Una contraseña, dos trabajos.

Mi pila empieza con esta línea:

auth        sufficient        pam_u2f.so cue

sufficient significa que una YubiKey correcta termina la autenticación ahí mismo. Es exactamente lo que Yubico documenta para el inicio de sesión sin contraseña2. Funciona. También significa que el paso de la contraseña nunca se ejecuta, así que no hay ninguna contraseña en la pila que el módulo del llavero pueda recoger. El llavero se queda bloqueado hasta que algo lo pide, y ese algo es la aplicación que arranque primero.

Dos formas de entrar, y lo que cada una le da al llaveroDos formas de entrar, y lo que cada una le da al llaveroEl llavero solo se abre con una contraseña. Entrar con YubiKey nunca la produce, así que la pone el script.Inicio con contraseñapam_unix comprueba la contraseñapam_oo7 pasa la misma contraseña a oo7-daemonel llavero se descifra con ellallavero abierto, sin avisoInicio con YubiKey (PIN + toque)pam_u2f es sufficient, así que cierra la pilano hay paso de contraseña, no existe ningunaa oo7-daemon no le llega nadallavero bloqueado, aviso al primer usoScript de autoarranquePIN + toque, la llave devuelve el hmac-secretdescifra la contraseña guardada, abre el llaveroLas apps que leen el llavero esperan a que se abra, así que ninguna puede sacar el aviso antes.
Un inicio de sesión con contraseña le da al llavero lo único con lo que puede abrirse. Uno con la llave no le da nada. El script de autoarranque de la derecha es el montaje que describe este artículo.

Los arreglos habituales, y lo que cuesta cada uno

Hay cuatro respuestas habituales a esto. Todas renuncian a algo.

ArregloLo que consiguesLo que cuesta
Teclear la contraseña en el avisoNada que montarEl aviso, en cada inicio de sesión. La llave no te ha ahorrado nada
Contraseña del llavero en blancoSe acabó el avisoTodos los secretos guardados quedan en disco sin cifrar
Contraseña y llave al iniciar sesiónDoble factor de verdad, el llavero se abre soloTeclear la contraseña en cada inicio de sesión, que es justo para lo que estaba la llave
Contraseña sellada en el TPM, desbloqueada al iniciar sesiónSin aviso, sin teclearQuien consiga una sesión en esa máquina se lleva los secretos. Sin PIN, sin llave de por medio
hmac-secret de la YubiKey (este artículo)Sin aviso, PIN + toque, el inicio con contraseña sigue funcionandoUn segundo PIN y toque tras iniciar sesión, y un script que cuidar

La contraseña en blanco es en la que acaban la mayoría de los hilos de foro, y es la peor de todas. La vía del TPM es respetable, pero el TPM nunca te pregunta nada, así que lo que protege es un disco sacado del portátil, no una sesión ante la que alguien se ha sentado mientras te hacías un té. Yo quería el llavero atado a lo mismo a lo que está atado mi inicio de sesión: la llave, y el PIN que va con ella.

La llave puede guardar un secreto

Una llave FIDO2 hace más que decir sí o no. El estándar CTAP 2.1 tiene una extensión llamada hmac-secret, que «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.

Su funcionamiento es bastante sencillo. Cuando creas una credencial, la llave genera valores aleatorios y se los guarda dentro. Más tarde le mandas un salt, y te devuelve un HMAC de ese salt con su valor oculto como clave. Misma credencial, mismo salt, misma respuesta siempre. Otra llave, nada.

El detalle que importa aquí: la llave guarda dos de esos valores ocultos, CredRandomWithUV y CredRandomWithoutUV3. UV es la verificación del usuario, que en esta llave significa el PIN. Pregunta con el PIN y obtienes un secreto. Pregunta solo con un toque y obtienes otro completamente distinto. Así que el PIN no es una comprobación atornillada delante del secreto. Es parte del secreto.

EntradaDónde vivePor sí sola te da
ID de credencial y salt~/.local/share/yubikey-keyring/, ficheros en claroNada. No son secretos
Contraseña del llavero cifradaLa misma carpeta, password.encNada sin el secreto para descifrarla
Valor oculto de la credencialDentro de la YubiKey, nunca sale de ellaNada sin el salt y un toque
PINTu cabezaSelecciona el secreto con PIN. PIN incorrecto, ningún secreto, y la llave cuenta el intento

Las cuatro juntas devuelven la contraseña de la cuenta. Quita cualquiera y estás en el aviso, que es donde habrías estado de todos modos.

Lo que monté con Claude

La contraseña del llavero es mi contraseña de la cuenta, a propósito. Así el inicio de sesión con contraseña sigue funcionando de la forma normal: la tecleas en la pantalla de inicio y la pila PAM abre el llavero por sí sola, sin script de por medio. El camino de la YubiKey es el que necesita ayuda.

PiezaTrabajo
yubikey-keyring-setupUna sola vez. Crea la credencial FIDO2 en la llave con hmac-secret activado. Necesita el PIN y un toque
yubikey-keyring-resetPide la contraseña de la cuenta, la comprueba contra la cuenta real con unix_chkpwd antes de tocar nada, la cifra con el secreto condicionado al PIN, hace copia del llavero viejo y crea el nuevo
yubikey-keyring-unlockSe ejecuta al iniciar sesión. Diálogo del PIN, toque, descifrar, desbloquear. Dos intentos con el PIN, y luego se rinde y te deja el aviso normal
wait-for-keyringEnvuelve las entradas de autoarranque de todas las aplicaciones que leen el llavero. Retiene cada una hasta 60 segundos, hasta que el llavero está abierto

El secreto sale de fido2-assert4 con -h para hmac-secret, -p para el toque y -v para el PIN. La contraseña se cifra con OpenSSL, AES-256 con 200 000 rondas de PBKDF2 sobre el secreto derivado. Al iniciar sesión la contraseña solo viaja por una tubería. El secreto derivado y, durante un reinicio, la contraseña tecleada pasan un momento en un directorio temporal privado bajo /tmp, que en Fedora es tmpfs en RAM, y se borran en cuanto se usan. Ninguno de los dos va nunca en una línea de comandos donde ps pudiera verlo.

wait-for-keyring es la pieza que la gente se saltaría. No lo hagas. El orden de autoarranque no está garantizado, y si una aplicación pide su token un segundo antes de que yo haya terminado de teclear el PIN, GNOME saca el aviso de siempre encima del mío, y el arreglo parece roto cuando no lo está.

Los scripts son tuyos: yubikey-keyring.zip, SHA-256 9b3670cf0f38c1b93e7738d2f68abef0380786d918491973e3ebefa5143e6263. Contiene los scripts, un instalador, un README y el arnés de pruebas descrito más abajo. No hay ninguna credencial, salt ni contraseña dentro. Esos se crean en tu propia máquina cuando ejecutas la configuración. Lee el README, y luego ejecuta test/run.sh antes de dejar que nada de esto se acerque a tu llavero real.

Lo que destapó el montaje

Esto iba a ser cosa de una hora. La mayor parte de la tarde se fue en cosas que la documentación no menciona.

El daemon había cambiado sin que me enterara

Todas las guías que he leído para este problema hablan con gnome-keyring-daemon, y todas me habrían mandado en la dirección equivocada, porque el proceso que respondía en mi máquina era oo7-daemon 0.7.0, una beta. El portátil había pasado a Fedora 45 esa misma tarde, una transacción de dnf de 5 464 pasos, y oo7 había llegado con ella.

oo7 es una implementación en Rust del Secret Service, con su propio servidor y su propio módulo PAM5. Hay que reconocerle que implementa la interfaz D-Bus privada de gnome-keyring para desbloquear con una contraseña, así que las herramientas existentes siguen funcionando. Esa interfaz se llama org.gnome.keyring.InternalUnsupportedGuiltRiddenInterface6. El nombre te dice cuánto fiarte de ella. Funciona, lo he probado, y aun así esperaría que cambie algún día.

La primera contraseña que teclees se convierte en la del llavero

Esto explicó toda la tarde.

Cuando oo7 arranca y no encuentra ningún fichero de llavero, no crea uno: muestra a las aplicaciones un llavero provisional bloqueado llamado login, y la primera contraseña que alguien use para desbloquear ese provisional se convierte en la contraseña del llavero, aunque el fichero en sí solo se escribe cuando una aplicación guarda su primer secreto.

Mi fichero de llavero se creó a las 20:45, y su primer elemento vino de una aplicación que había arrancado unos segundos antes. Así que a las 20:45 tecleé algo en un aviso que quería quitarme de en medio, y eso se convirtió en la contraseña. Nada de lo que probé después lo abrió. El código de desbloqueo tampoco tenía la culpa: lo demostré con un llavero desechable con una contraseña conocida, que se bloqueó, se desbloqueó y se borró limpiamente.

Después comprobé el provisional en un daemon desechable. Antes de que exista el fichero, cualquier contraseña lo desbloquea, incluida una incorrecta. Así que nada te dice en ese momento que acabas de fijar una contraseña. Te enteras en el siguiente inicio de sesión, cuando la contraseña correcta, hasta donde tú sabes, es rechazada.

EstadoDesbloquear con cualquier contraseñaLo que se escribe
Sin fichero de llavero, provisional a la vistaFuncionaNada todavía
Primer elemento guardadon/aFichero creado, cifrado con lo que se tecleara
Cada inicio de sesión posteriorSolo funciona la contraseña de las 20:45n/a

Así que dejé de perseguirlo. El reinicio hace copia del llavero viejo, desbloquea el provisional con la contraseña de la cuenta y guarda en el acto un elemento marcador para que el fichero se escriba ahí mismo, con una contraseña que conozco.

Las herramientas FIDO2 solo aceptan un PIN desde un terminal

fido2-cred y fido2-assert leen el PIN del terminal de control y de ningún otro sitio. Un script arrancado al iniciar sesión no tiene terminal. Así que hay un pequeño envoltorio que ejecuta la herramienta bajo un pseudoterminal, espera a que aparezca la palabra PIN en su salida, y teclea el PIN que viene de un diálogo. Veinte líneas de Python. No es bonito, pero hace el trabajo y el PIN nunca toca un fichero ni una lista de argumentos.

Pruébalo donde no te pueda hacer daño

Lo más útil que hizo Claude Code fue negarse a fiarse del script de reinicio sobre mi llavero real. Primero ejecutó todo el flujo contra un segundo oo7-daemon en una sesión D-Bus privada (dbus-run-session), con un directorio personal desechable, un llavero viejo falso y una contraseña de prueba con £, @, " y # dentro.

La primera ejecución falló. Bien. El reinicio movió el llavero viejo a su copia, reinició el daemon, vio el login provisional de oo7, lo tomó por un llavero real y se paró. En mi máquina eso me habría dejado sin llavero alguno y con una copia que restaurar a mano. Ahora el script desbloquea el provisional en lugar de rechazarlo, y si algo falla después de hacer la copia, vuelve a poner el llavero viejo él solo.

La propia comprobación de seguridad de Claude Code también paró una versión anterior del reinicio sobre el llavero real hasta que lo confirmé. Un fastidio en el momento. Decisión acertada.

Prueba, en el daemon desechableResultado
Reinicio desde un aviso de terminal, copia del llavero viejo hechaPasa
Contraseña vieja contra el llavero nuevoRechazada
Daemon recién arrancado, como al iniciar sesiónArranca bloqueado
Contraseña incorrectaRechazada
Contraseña correcta, por el mismo camino que un inicio con contraseñaDesbloquea
Daemon recién arrancado, PIN + toque a través del script de desbloqueoDesbloquea
Script de desbloqueo con el llavero ya abiertoSale al instante, sin pedir toque

Y luego una vez más en el de verdad, con el llavero bloqueado a mano y el script de desbloqueo ejecutado igual que lo ejecuta el inicio de sesión: PIN, toque, abierto.

Las aristas

Es un montaje que funciona, no un producto terminado, y estas son las partes que conozco.

  • Dos entradas de PIN por cada inicio con la llave. Una en la pantalla de inicio para PAM, otra para el llavero. Son peticiones separadas a la llave y la llave no las combina. Un llavero solo con toque ahorraría una, a costa de que el PIN no proteja nada después de iniciar sesión.
  • Cambia la contraseña de la cuenta y la copia guardada se queda obsoleta. El script de desbloqueo lo dice en una notificación en lugar de fallar en silencio. Vuelve a ejecutar el reinicio y listo.
  • Pierde la llave y vuelves a teclear la contraseña. No se pierde nada, porque la contraseña sigue siendo la de la cuenta.
  • Algunas aplicaciones reescriben sus propios ficheros de autoarranque. Si alguna vuelve a sacar el aviso, esa es la razón, y hay que volver a poner el envoltorio.
  • oo7 es una beta, y la llamada de desbloqueo pasa por una interfaz con «Unsupported» en el nombre. Cada actualización de oo7 merece un inicio de sesión de prueba antes de fiarse de ella.

Cierre

El llavero nunca estuvo roto. La llave tampoco. Se construyeron sobre suposiciones distintas sobre qué es un inicio de sesión, y nadie aguas arriba las juntó. El inicio de sesión sin contraseña lo documenta Yubico, viene en los perfiles de authselect de Fedora y se activa con un solo indicador de función. Nada de todo eso te dice que, en el momento en que lo usas, todos los secretos que guarda tu escritorio se quedan bloqueados tras una contraseña que ya no tecleas.

Así que el hueco le cae a quien esté sentado delante de la máquina, y el arreglo es tan bueno como lo que esa persona entienda sobre dónde vive de verdad el secreto. La respuesta fácil, una contraseña en blanco, es a la que se manda a la mayoría de la gente, y cambia un cuadro de diálogo por un fichero sin cifrar con todos los tokens que tienes. Eso no es un arreglo. Eso es rendirse en silencio.

La forma correcta estuvo ahí todo el tiempo. La llave puede guardar un secreto, el estándar lo dice con todas las letras, y el PIN puede ser parte de ese secreto en lugar de una puerta delante de él. Conectarlo costó una tarde y un arnés de pruebas. No debería haber hecho falta ninguna de las dos cosas.


  1. freedesktop.org, Secret Service API Draft — la API D-Bus que usan las aplicaciones de escritorio para guardar y recuperar secretos, y que implementan tanto gnome-keyring como oo7. ↩︎

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

  4. Yubico, libfido2 fido2-assert manual — la herramienta de línea de comandos usada para pedir una aserción, con las opciones de hmac-secret, presencia del usuario y PIN. ↩︎

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

  6. oo7 source, server/src/gnome/internal.rs — la implementación de oo7 de la interfaz interna de desbloqueo de gnome-keyring, incluido UnlockWithMasterPassword. ↩︎