#28: stop enrolment from silently replacing a secret the authenticator already has

Enrolling a second factor could reach a state where the authenticator showed
perfectly valid codes and every one of them was rejected, with the only
feedback being "TOTP verification failed".

The browser holds the enrolment secret in component state alone. Reloading the
settings page - or leaving and coming back - brought the "enable" button back,
and pressing it called the enrol endpoint again, which deleted the pending row
and stored a brand new secret. The entry already saved in the authenticator
then belonged to a secret the server no longer had. Nothing about that is
visible from either side: the app generates codes correctly, the server
compares them correctly, and they are for different keys.

Enrolment now resumes. The endpoint returns the pending secret if there is
one, so the QR shown after a reload is the same one already scanned and
rescanning is harmless. Starting over is still possible - ?reset=1, exposed in
the settings screen - because someone who deleted the entry from their app
needs a secret they can actually generate codes for. A pending row that can no
longer be decrypted is replaced rather than resumed, since nobody could ever
confirm it.

Also: the submitted code now has every non-digit stripped rather than just
surrounding whitespace. Authenticators display the code grouped as "123 456",
and a value typed or pasted with that space failed the six-character length
check before it was ever compared - which, to someone reading the right number
off their phone, looks like the server being wrong. The inputs sanitise as you
type for the same reason.

Ruled out first, rather than guessed at: the algorithm passes all six RFC 6238
reference vectors, base32 round-trips, and the deployment's clock is exactly in
sync with real time, so neither the implementation nor drift explains it.

Verified: the resume test fails without the change and passes with it; 47 auth
tests green against a real Postgres.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Lucas RayanandClaude Opus 5 committed 2026-08-03 09:47:59 -03:00
1 parent de16efe874
commit 57198e0263
11 files changed
+189 -25

No files matched your search

+1
View File
@@ -205,6 +205,7 @@
"signatureSaved": "Signature saved.",
"signatureTitle": "Email signature",
"sixDigitCode": "Six-digit code",
"startOverMfa": "Lost the entry? Start over with a new key",
"subtitle": "Two-factor authentication, filters, auto-reply and your signature.",
"title": "Settings",
"twoFactorIntro": "Protect your account with Google Authenticator, Aegis, Authy or 1Password.",
+1
View File
@@ -205,6 +205,7 @@
"signatureSaved": "Firma guardada.",
"signatureTitle": "Firma de correo",
"sixDigitCode": "Código de seis dígitos",
"startOverMfa": "¿Perdió el registro? Empiece de nuevo con una clave nueva",
"subtitle": "Verificación en dos pasos, filtros, respuesta automática y su firma.",
"title": "Configuración",
"twoFactorIntro": "Proteja su cuenta con Google Authenticator, Aegis, Authy o 1Password.",
+1
View File
@@ -205,6 +205,7 @@
"signatureSaved": "Assinatura salva.",
"signatureTitle": "Assinatura de e-mail",
"sixDigitCode": "Código de seis dígitos",
"startOverMfa": "Perdeu o registro? Recomece com uma nova chave",
"subtitle": "Verificação em duas etapas, filtros, resposta automática e sua assinatura.",
"title": "Configurações",
"twoFactorIntro": "Proteja sua conta com o Google Authenticator, Aegis, Authy ou 1Password.",