Entro no meu portátil com uma YubiKey. PIN, toque, ambiente de trabalho. Nenhuma palavra-passe escrita.
Depois arranca a primeira aplicação que quer um segredo guardado e o GNOME atira-me uma caixa: «An application wants access to the keyring ‘Login’, but it is locked.» Em cada login. A mesma caixa, a mesma pergunta, uma palavra-passe que me tinham acabado de dizer que eu não precisava.
Nenhuma peça está avariada. Cada parte está a fazer aquilo para que foi construída. O problema é que o keyring foi desenhado partindo do princípio de que um login envolve sempre uma palavra-passe, e um login sem palavra-passe quebra esse pressuposto sem avisar ninguém.
Porque é que um login com chave deixa o keyring à fome
O keyring de sessão é onde o ambiente de trabalho guarda os segredos que as aplicações lhe entregam: chaves de Wi-Fi, chaves de armazenamento do browser, os tokens que os clientes de chat, os gestores de palavras-passe e as aplicações de videoconferência usam para se manterem autenticados. Fica no disco cifrado com a tua palavra-passe de login, e a Secret Service API1 é a forma como as aplicações pedem o que está lá dentro.
Normalmente nunca o vês. Escreves a palavra-passe no ecrã de login, a pilha PAM verifica-a contra a conta, e um módulo de keyring mais abaixo na mesma pilha apanha discretamente essa mesma palavra-passe e usa-a para abrir o keyring antes de o teu ambiente de trabalho ter sequer acabado de se desenhar. Uma palavra-passe, dois trabalhos.
A minha pilha começa com esta linha:
auth sufficient pam_u2f.so cue
sufficient quer dizer que uma YubiKey bem-sucedida termina a autenticação ali mesmo. É exatamente o que a Yubico documenta para o login sem palavra-passe2. Funciona. Também quer dizer que o passo da palavra-passe nunca corre, por isso não há palavra-passe na pilha para o módulo de keyring apanhar. O keyring fica trancado até alguma coisa o pedir, e essa coisa é a primeira aplicação que arrancar.
As soluções habituais, e o que cada uma custa
Há quatro respostas comuns para isto. Cada uma delas abdica de alguma coisa.
| Solução | O que ganhas | O que custa |
|---|---|---|
| Escrever a palavra-passe no pedido | Nada para construir | O pedido, em cada login. A chave não te poupou nada |
| Palavra-passe do keyring em branco | O pedido desaparece | Todos os segredos guardados ficam no disco sem cifra |
| Palavra-passe e chave no login | Dois fatores a sério, o keyring abre-se sozinho | Escrever a palavra-passe em cada login, que era para isso que servia a chave |
| Palavra-passe selada no TPM, desbloqueada no login | Sem pedido, sem escrever | Quem conseguir uma sessão nessa máquina fica com os segredos. Sem PIN, sem chave envolvida |
| hmac-secret da YubiKey (este artigo) | Sem pedido, PIN + toque, o login com palavra-passe continua a funcionar | Um segundo PIN e toque depois do login, e um script para manter |
A palavra-passe em branco é aquela em que acaba a maioria das discussões nos fóruns, e é a pior de todas. O caminho do TPM é respeitável, mas o TPM nunca te pergunta nada, por isso o que ele protege é um disco arrancado do portátil, não uma sessão onde alguém se sentou enquanto foste fazer um chá. Eu queria o keyring ligado à mesma coisa a que o meu login está ligado: a chave, e o PIN que vem com ela.
A chave consegue guardar um segredo
Uma chave FIDO2 faz mais do que dizer sim ou não. A norma CTAP 2.1 tem uma extensão chamada 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.
A forma como funciona é bastante simples. Quando crias uma credencial, a chave gera valores aleatórios e guarda-os dentro de si. Mais tarde envias-lhe um salt, e ela devolve um HMAC desse salt com o seu valor escondido como chave. A mesma credencial, o mesmo salt, a mesma resposta todas as vezes. Outra chave, nada.
O pormenor que interessa aqui: a chave guarda dois desses valores escondidos, CredRandomWithUV e CredRandomWithoutUV3. UV é a verificação do utilizador, que nesta chave quer dizer o PIN. Pede com o PIN e recebes um segredo. Pede só com um toque e recebes um completamente diferente. Portanto o PIN não é uma verificação aparafusada à frente do segredo. Faz parte do segredo.
| Entrada | Onde vive | Sozinha dá-te |
|---|---|---|
| ID da credencial e salt | ~/.local/share/yubikey-keyring/, ficheiros simples | Nada. Não são secretos |
| Palavra-passe do keyring cifrada | A mesma pasta, password.enc | Nada sem o segredo de decifra |
| Valor escondido da credencial | Dentro da YubiKey, nunca sai de lá | Nada sem o salt e um toque |
| PIN | A tua cabeça | Escolhe o segredo com PIN. PIN errado, nenhum segredo, e a chave conta a tentativa |
As quatro juntas devolvem a palavra-passe da conta. Tira qualquer uma e ficas no pedido, que é onde terias ficado de qualquer forma.
O que construí com o Claude
A palavra-passe do keyring é a palavra-passe da minha conta, de propósito. Isso mantém o login com palavra-passe a funcionar da forma normal: escreve-a no ecrã de login e a pilha PAM abre o keyring sozinha, sem script envolvido. É o caminho da YubiKey que precisa de ajuda.
| Peça | Trabalho |
|---|---|
yubikey-keyring-setup | Uma vez só. Cria a credencial FIDO2 na chave com hmac-secret ativo. Precisa do PIN e de um toque |
yubikey-keyring-reset | Pede a palavra-passe da conta, verifica-a contra a conta real com unix_chkpwd antes de mexer em seja o que for, cifra-a com o segredo protegido por PIN, faz cópia de segurança do keyring antigo e cria o novo |
yubikey-keyring-unlock | Corre no login. Diálogo de PIN, toque, decifrar, desbloquear. Duas tentativas de PIN, depois desiste e deixa-te o pedido normal |
wait-for-keyring | Envolve as entradas de arranque automático de todas as aplicações que leem o keyring. Segura cada uma até 60 segundos, até o keyring estar aberto |
O segredo sai do fido2-assert4 com -h para o hmac-secret, -p para o toque e -v para o PIN. A palavra-passe é cifrada com OpenSSL, AES-256 com 200 000 rondas de PBKDF2 sobre o segredo derivado. No login, a palavra-passe só viaja por um pipe. O segredo derivado e, durante um reset, a palavra-passe escrita ficam por instantes num diretório temporário privado em /tmp, que no Fedora é tmpfs em RAM, e são apagados assim que são usados. Nenhum deles vai alguma vez parar a uma linha de comandos onde o ps o pudesse ver.
O wait-for-keyring é a peça que as pessoas saltariam. Não o faças. A ordem do arranque automático não é garantida, e se uma aplicação pedir o seu token um segundo antes de eu ter acabado de escrever o PIN, o GNOME levanta o pedido antigo por cima do meu, e a solução parece avariada quando não está.
Os scripts são teus para levar: yubikey-keyring.zip, SHA-256 9b3670cf0f38c1b93e7738d2f68abef0380786d918491973e3ebefa5143e6263. Contém os scripts, um instalador, um README e o ambiente de teste descrito abaixo. Não tem nenhuma credencial, salt ou palavra-passe. Esses são criados na tua própria máquina quando corres o setup. Lê o README e depois corre test/run.sh antes de deixares qualquer parte disto chegar perto do teu keyring real.
O que a construção revelou
Isto era para ser uma hora de trabalho. A maior parte da noite foi para coisas que a documentação não menciona.
O daemon tinha mudado debaixo de mim
Todos os guias que li para este problema falam com o gnome-keyring-daemon, e todos me teriam mandado na direção errada, porque o processo que respondia na minha máquina era o oo7-daemon 0.7.0, uma beta. O portátil tinha passado para o Fedora 45 nessa mesma noite, uma transação dnf de 5464 passos, e o oo7 tinha chegado com ela.
O oo7 é uma implementação em Rust do Secret Service, com o seu próprio servidor e o seu próprio módulo PAM5. Para seu mérito, implementa a interface D-Bus privada do gnome-keyring para desbloquear com uma palavra-passe, por isso as ferramentas existentes continuam a funcionar. Essa interface chama-se org.gnome.keyring.InternalUnsupportedGuiltRiddenInterface6. O nome diz-te quanto confiar nela. Funciona, testei-a, e mesmo assim conto que um dia mude.
A primeira palavra-passe que escreves torna-se a palavra-passe do keyring
Esta explicou a noite inteira.
Quando o oo7 arranca e não encontra nenhum ficheiro de keyring, não cria um: mostra às aplicações um placeholder trancado chamado login, e a primeira palavra-passe que alguém use para desbloquear esse placeholder torna-se a palavra-passe do keyring, embora o ficheiro em si só seja escrito quando uma aplicação guarda o seu primeiro segredo.
O meu ficheiro de keyring foi criado às 20:45, e o seu primeiro item veio de uma aplicação que tinha arrancado uns segundos antes. Portanto, às 20:45 escrevi qualquer coisa num pedido que queria tirar da frente, e isso tornou-se a palavra-passe. Nada do que tentei depois o abriu. O código de desbloqueio também não tinha culpa: provei isso num keyring descartável com uma palavra-passe conhecida, que trancou, desbloqueou e foi apagado sem problemas.
Depois verifiquei o placeholder num daemon descartável. Antes de o ficheiro existir, qualquer palavra-passe o desbloqueia, incluindo uma errada. Por isso nada te diz, no momento, que acabaste de definir uma palavra-passe. Descobres no login seguinte, quando a palavra-passe certa, tanto quanto sabes, é recusada.
| Estado | Desbloquear com qualquer palavra-passe | O que é escrito |
|---|---|---|
| Sem ficheiro de keyring, placeholder visível | Funciona | Nada ainda |
| Primeiro item guardado | n/a | Ficheiro criado, cifrado com o que foi escrito |
| Todos os logins seguintes | Só funciona a palavra-passe das 20:45 | n/a |
Por isso deixei de andar atrás disso. O reset faz cópia de segurança do keyring antigo, desbloqueia o placeholder com a palavra-passe da conta e guarda logo um item marcador, para que o ficheiro seja escrito ali mesmo, com uma palavra-passe que eu conheço.
As ferramentas FIDO2 só aceitam um PIN de um terminal
O fido2-cred e o fido2-assert leem o PIN do terminal de controlo e de mais lado nenhum. Um script arrancado no login não tem terminal. Por isso há um pequeno wrapper que corre a ferramenta num pseudo-terminal, espera pela palavra PIN na saída e escreve o PIN vindo de um diálogo. Vinte linhas de Python. Não é bonito, mas faz o trabalho e o PIN nunca toca num ficheiro nem numa lista de argumentos.
Testa-o num sítio onde não te possa fazer mal
A coisa mais útil que o Claude Code fez foi recusar-se a confiar no script de reset no meu keyring real. Correu primeiro o fluxo todo contra um segundo oo7-daemon numa sessão D-Bus privada (dbus-run-session), com um diretório pessoal descartável, um keyring antigo falso e uma palavra-passe de teste com £, @, " e # lá dentro.
A primeira execução falhou. Ainda bem. O reset moveu o keyring antigo para a cópia de segurança, reiniciou o daemon, viu o placeholder login do oo7, tomou-o por um keyring real e parou. Na minha máquina, isso ter-me-ia deixado sem keyring nenhum e com uma cópia de segurança para restaurar à mão. O script agora desbloqueia o placeholder em vez de o recusar, e se alguma coisa falhar depois de feita a cópia de segurança, repõe sozinho o keyring antigo.
A própria verificação de segurança do Claude Code também travou uma versão anterior do reset no keyring real até eu a ter confirmado. Irritante na altura. Decisão acertada.
| Teste, no daemon descartável | Resultado |
|---|---|
| Reset a partir de um pedido no terminal, keyring antigo com cópia de segurança | Passa |
| Palavra-passe antiga contra o keyring novo | Recusada |
| Daemon novo, como no login | Arranca trancado |
| Palavra-passe errada | Recusada |
| Palavra-passe correta, o mesmo caminho de um login com palavra-passe | Desbloqueia |
| Daemon novo, PIN + toque pelo script de desbloqueio | Desbloqueia |
| Script de desbloqueio com o keyring já aberto | Sai logo, sem pedir toque |
Depois mais uma vez na coisa real, com o keyring trancado à mão e o script de desbloqueio corrido da mesma forma que o login o corre: PIN, toque, aberto.
As arestas por limar
É uma configuração que funciona, não um produto acabado, e estas são as partes que conheço.
- Duas entradas de PIN por login com chave. Uma no ecrã de login para o PAM, outra para o keyring. São pedidos separados à chave e a chave não os junta. Um keyring só com toque poupava um, à custa de o PIN não proteger nada depois do login.
- Muda a palavra-passe da conta e a cópia guardada fica desatualizada. O script de desbloqueio diz isso numa notificação em vez de falhar em silêncio. Corre o reset outra vez e fica resolvido.
- Perde a chave e voltas a escrever a palavra-passe. Nada se perde, porque a palavra-passe continua a ser a palavra-passe da conta.
- Algumas aplicações reescrevem os seus próprios ficheiros de arranque automático. Se uma delas voltar a levantar o pedido, é por isso, e o wrapper tem de ser reposto.
- O oo7 é uma beta, e a chamada de desbloqueio passa por uma interface com «Unsupported» no nome. Cada atualização do oo7 merece um login de teste antes de confiares nela.
Fecho
O keyring nunca esteve avariado. A chave também não. Foram construídos sobre pressupostos diferentes do que é um login, e ninguém a montante os ligou. O login sem palavra-passe está documentado pela Yubico, vem nos perfis authselect do Fedora e liga-se com uma flag de funcionalidade. Nada disso te diz que, no momento em que o usas, todos os segredos que o teu ambiente de trabalho guarda ficam trancados atrás de uma palavra-passe que já não estás a escrever.
Como tal, a lacuna cai sobre quem está sentado à máquina, e a solução só é tão boa quanto o que essa pessoa percebe de onde o segredo vive de facto. A resposta fácil, uma palavra-passe em branco, é aquela para onde a maioria das pessoas é empurrada, e troca uma caixa de diálogo por um ficheiro sem cifra com todos os tokens que tens. Isso não é uma solução. Isso é desistir em silêncio.
A forma certa esteve lá o tempo todo. A chave consegue guardar um segredo, a norma di-lo com todas as letras, e o PIN pode fazer parte desse segredo em vez de ser uma porta à frente dele. Levou uma noite e um ambiente de teste a ligar tudo. Não devia ter precisado de nenhum dos dois.
freedesktop.org, Secret Service API Draft — a API D-Bus que as aplicações de ambiente de trabalho usam para guardar e obter segredos, implementada tanto pelo gnome-keyring como pelo oo7. ↩︎
Yubico, pam-u2f — «For a passwordless experience, where the authenticator PIN can be used in place of the user password», com a linha de exemplo
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», e «The authenticator generates two random 32-byte values (called CredRandomWithUV and CredRandomWithoutUV)». ↩︎ ↩︎
Yubico, libfido2 fido2-assert manual — a ferramenta de linha de comandos usada para pedir uma asserção, com as opções de hmac-secret, presença do utilizador e PIN. ↩︎
linux-credentials/oo7 on GitHub — «server: org.freedesktop.secrets server implementation» e «pam: PAM integration for the server implementation». ↩︎
código-fonte do oo7, server/src/gnome/internal.rs — a implementação no oo7 da interface interna de desbloqueio do gnome-keyring, incluindo
UnlockWithMasterPassword. ↩︎