Skip to content

fix: keep a per-member floor so pruned removals stay removed - #735

Merged
rodrigopavezi merged 1 commit into
mainfrom
fix/recovery-store-floor
Nov 17, 2026
Merged

rodrigopavezi merged 1 commit into
mainfrom
fix/recovery-store-floor

Conversation

@rodrigopavezi

Copy link
Copy Markdown
Contributor

O que muda e por quê

Quatro itens da #444, cada um com o que foi feito e o efeito de segurança:

  • Uma cópia antiga de recovery.json traz de volta uma linha cuja lápide já foi podada (§110). Corrigido. O arquivo passa à versão 2, com floors: ao descartar um registro de remoção (30 dias ou teto de 32 por membro), o serviço guarda o gen dele como marca do membro. Quando o serviço une o arquivo à memória, uma entrada que só o arquivo tem sai quando o gen dela não passa da marca da memória. A marca do arquivo nunca tira uma entrada da memória: uma cópia de outra história, posta de volta com o serviço no ar, entra como união. Efeito: uma passkey extra ou um código removido não volta a abrir a conta por causa de uma cópia antiga do arquivo. Quem lê e grava o arquivo não muda, e ele continua guardando só o que o serviço não consegue abrir.
  • A perda do disco apaga as entradas (§110). Decidido: procedimento no README. Backup com o serviço no ar (o arquivo é sempre trocado inteiro); restauração com o serviço parado, só da cópia mais nova, e aviso aos membros para conferirem Ajustes › Passkeys e recuperação. Efeito: a cópia restaurada volta a ter as entradas removidas depois dela, por isso o aviso.
  • Só membros com vínculo Google cadastram entradas (§110). Já resolvido no código, que aceita qualquer conta vinculada; só docs/design.md, docs/app.md e docs/verification.md ainda falavam em vínculo Google. Efeito: nenhum.
  • A limpeza no Android depende do androidx.credentials 1.5.0 (§109). Decidido: versão exata no build.gradle, nunca abaixo de 1.5.0, com um teste que falha se a versão cair ou deixar de ser exata. Efeito: a limpeza das passkeys no Android não some numa troca de versão.

Compatibilidade: a versão 1 do arquivo continua sendo lida; a versão 2 é gravada na primeira escrita que muda algo. Uma versão anterior do serviço não lê a versão 2 e responde 503 em /account/recovery/* até a nova voltar (README).

A marca guarda a chave pública do membro sem prazo, também depois da exclusão (a chave já fica guardada na linha da conta excluída). A frase da Política de Privacidade sobre as entradas ("por 30 dias") muda no PR das passkeys extras, junto com a versão dos Termos.

Issue

Parte da #444.

Como verificar

  • node apps/cli/test/recovery-store.test.js (39 testes; os de regressão falham sem a marca).
  • node apps/app/test/passkeyPrfAndroid.test.js.
  • Detalhes em docs/verification/fix-recovery-store-floor.md.

Checklist

  • npm run lint, npm test -- --affected=origin/main e npm run demo passam
  • docs/protocol.md atualizado (formato do recovery.json)
  • Entrada do changelog em docs/changelog/fix-recovery-store-floor.md e verificação em docs/verification/fix-recovery-store-floor.md, sem editar o CHANGELOG.md nem acrescentar seção ao docs/verification.md
  • Textos para o usuário estão em pt-BR
  • Conferência no Android e no iOS não se aplica: a mudança é no serviço de conta e num teste que lê o build.gradle
  • Nenhum segredo, chave ou dado pessoal no diff

recovery.json moves to version 2 with floors: pruning a tombstone records
its gen for the member. When the holder merges the file into memory, a
row only the file holds is dropped when its gen is at or under memory's
floor for that member, so an older copy of the file no longer brings back
a removed passkey or recovery code. The file's floor never drops a row
memory holds. Version 1 is still read and becomes version 2 on the next
changing write.

Also pins the androidx.credentials guard in a test and documents the
backup and restore procedure for recovery.json.

Part of #444
@rodrigopavezi
rodrigopavezi requested a review from a team as a code owner November 17, 2026 11:01
@rodrigopavezi
rodrigopavezi merged commit 0f7cadc into main Nov 17, 2026
24 checks passed
@rodrigopavezi
rodrigopavezi deleted the fix/recovery-store-floor branch November 17, 2026 11:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant