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.
Los arreglos habituales, y lo que cuesta cada uno
Hay cuatro respuestas habituales a esto. Todas renuncian a algo.
| Arreglo | Lo que consigues | Lo que cuesta |
|---|---|---|
| Teclear la contraseña en el aviso | Nada que montar | El aviso, en cada inicio de sesión. La llave no te ha ahorrado nada |
| Contraseña del llavero en blanco | Se acabó el aviso | Todos los secretos guardados quedan en disco sin cifrar |
| Contraseña y llave al iniciar sesión | Doble factor de verdad, el llavero se abre solo | Teclear 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ón | Sin aviso, sin teclear | Quien 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 funcionando | Un 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.
| Entrada | Dónde vive | Por sí sola te da |
|---|---|---|
| ID de credencial y salt | ~/.local/share/yubikey-keyring/, ficheros en claro | Nada. No son secretos |
| Contraseña del llavero cifrada | La misma carpeta, password.enc | Nada sin el secreto para descifrarla |
| Valor oculto de la credencial | Dentro de la YubiKey, nunca sale de ella | Nada sin el salt y un toque |
| PIN | Tu cabeza | Selecciona 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.
| Pieza | Trabajo |
|---|---|
yubikey-keyring-setup | Una sola vez. Crea la credencial FIDO2 en la llave con hmac-secret activado. Necesita el PIN y un toque |
yubikey-keyring-reset | Pide 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-unlock | Se 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-keyring | Envuelve 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.
| Estado | Desbloquear con cualquier contraseña | Lo que se escribe |
|---|---|---|
| Sin fichero de llavero, provisional a la vista | Funciona | Nada todavía |
| Primer elemento guardado | n/a | Fichero creado, cifrado con lo que se tecleara |
| Cada inicio de sesión posterior | Solo funciona la contraseña de las 20:45 | n/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 desechable | Resultado |
|---|---|
| Reinicio desde un aviso de terminal, copia del llavero viejo hecha | Pasa |
| Contraseña vieja contra el llavero nuevo | Rechazada |
| Daemon recién arrancado, como al iniciar sesión | Arranca bloqueado |
| Contraseña incorrecta | Rechazada |
| Contraseña correcta, por el mismo camino que un inicio con contraseña | Desbloquea |
| Daemon recién arrancado, PIN + toque a través del script de desbloqueo | Desbloquea |
| Script de desbloqueo con el llavero ya abierto | Sale 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.
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. ↩︎
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. ↩︎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)». ↩︎ ↩︎
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. ↩︎
linux-credentials/oo7 on GitHub — «server: org.freedesktop.secrets server implementation» y «pam: PAM integration for the server implementation». ↩︎
oo7 source, server/src/gnome/internal.rs — la implementación de oo7 de la interfaz interna de desbloqueo de gnome-keyring, incluido
UnlockWithMasterPassword. ↩︎