ykoxide: a minha caixa de ferramentas da YubiKey virou um binário em Rust

Também disponível em inglês: ykoxide: my YubiKey toolbox, rewritten as a single Rust binary.

Na série sobre YubiKey eu saí do 2FA por obrigação, passei por sudo, SSH e GPG, e acabei na criptografia de arquivos com age. Os scripts daquela fase ficaram no yubikey-shell-toolkit. Funcionam, mas dependem de ykman, age e openssl instalados.

O ykoxide é a reescrita em Rust: um único binário, o ykox, sem nenhuma dessas dependências em tempo de execução. Ele lê os arquivos e a configuração que os scripts criaram, então o que você já criptografou continua abrindo.

O que ele faz

age em um slot PIV, interoperável com o age-plugin-yubikey, nos dois sentidos
criptografia de arquivo com o slot OTP em HMAC-SHA1 challenge-response
criptografia de arquivo com FIDO2 hmac-secret (experimental)
assinatura SSHSIG, com chave FIDO2 (sk) ou slot PIV, verificável com ssh-keygen -Y verify
relatório do dispositivo e backup da configuração em JSON, sem segredos

O uso básico:

ykox info                        # a chave foi detectada?
ykox age setup                   # extrai (ou gera) a identidade age da chave
ykox age encrypt secret.txt      # secret.txt.age
ykox age decrypt secret.txt.age
ykox sign report.pdf             # report.pdf.sig

Com mais de uma YubiKey conectada, --serial <N> escolhe qual usar. A exceção é o FIDO2, cuja interface HID não informa o serial.

Instalação

cargo install ykoxide --locked   # compila do fonte
cargo binstall ykoxide           # baixa o binário do release

Os tarballs para Linux x86_64 e aarch64 também estão nos releases, com SHA256SUMS e, a partir da 0.1.1, atestado de proveniência do build. As tags são assinadas com GPG.

Em tempo de execução precisa do pcscd rodando (sudo systemctl enable --now pcscd.socket). No Arch, instale também pcsclite e ccid; no Fedora, pcsc-lite e pcsc-lite-ccid. Para compilar, os headers de PC/SC e udev.

O que foi testado

Ainda é pré-1.0, e o README diz com todas as letras o que foi exercitado em hardware:

Sistemas: Fedora 44 e Omarchy 4.0.3 (base Arch), ambos x86_64.
Chaves: YubiKey 5 NFC (firmware 5.2.6) e YubiKey 5C (firmware 5.4.3).
Conferido contra as ferramentas de referência: os arquivos age interoperam com o age-plugin-yubikey, a resposta HMAC bate com o ykman otp calculate e os arquivos .yk.enc do toolkit antigo decifram.
O FIDO2 só funciona de ponta a ponta a partir da 0.1.2. As versões anteriores falhavam com CTAP2_ERR_UNSUPPORTED_OPTION em tokens sem verificação de usuário própria, o que inclui a série 5. O formato é próprio do ykox e não interopera com o age-plugin-fido2-hmac.
Não foram exercitados em hardware: age setup --generate, uma Security Key e o aarch64 com chave (o binário é compilado e testado no CI, mas nunca rodou contra uma).

Dois avisos de segurança que valem repetir aqui. O ykox protege o material de chave, não o texto claro: malware no host que lê o arquivo já decifrado continua sendo problema seu. E o formato legado .yk.enc não é autenticado, uma chave errada passa uma vez em 256. Prefira sempre o .yk.age.

A série de YubiKey no blog

Se chegou aqui sem o contexto, a ordem é esta:

Em inglês:

O código está em github.com/Esl1h/ykoxide e o pacote em crates.io. Licença MIT.