mirror of
https://github.com/azaion/admin.git
synced 2026-06-21 11:51:09 +00:00
Oleksandr Bezdieniezhnykh
1e1ded73f5
Add RFC 6238 TOTP enrollment, two-step /login flow, recovery codes, and
the amr=["pwd","mfa"] claim that propagates through refresh-token rotation.
- New endpoints: /users/me/mfa/{enroll,confirm,disable} and /login/mfa.
- /login short-circuits to a 5-min ES256 step-1 token (audience-pinned
azaion-mfa-step2) when the user has MFA enabled; real access+refresh
pair is minted only after /login/mfa.
- mfa_secret encrypted at rest via ASP.NET Core IDataProtector
(purpose=Azaion.Mfa.Secret.v1; key folder configurable via
DataProtection:KeysFolder for production persistence).
- Recovery codes (10 single-use, base32, ~80-bit entropy) hashed with
SHA-256 and stored as JSONB; constant-time compare on lookup.
- RFC 6238 §5.2 replay defense via mfa_last_used_window per user.
- Sessions carry mfa_authenticated so /token/refresh re-stamps the
amr claim correctly across the entire 30-day refresh window.
- New audit events: enroll, confirm, disable, login-success/failed,
recovery-used.
- Schema: env/db/10_users_mfa.sql adds users.mfa_* columns and
sessions.mfa_authenticated; mfa_recovery_codes mapped as BinaryJson
in AzaionDbSchemaHolder; disable path uses raw parameterised SQL to
avoid LinqToDB null-literal type-inference on jsonb columns.
E2E: 6 new tests in MfaLoginTests cover all six AC; full suite
82 passed / 0 failed / 3 intentional skips.
Co-authored-by: Cursor <cursoragent@cursor.com>
29 lines
1.5 KiB
SQL
29 lines
1.5 KiB
SQL
-- AZ-534 (Epic AZ-529): TOTP-based 2FA at credential login.
|
|
--
|
|
-- mfa_secret holds the base32 TOTP shared secret encrypted at rest via the
|
|
-- ASP.NET Core IDataProtector ("Azaion.Mfa.Secret" purpose). The column type
|
|
-- stays text because the protected payload is base64.
|
|
--
|
|
-- mfa_recovery_codes is a JSONB array of objects { hash: <argon2id>, used_at: <ts|null> }.
|
|
-- One-time-use is enforced by setting used_at on consumption; the row is rewritten
|
|
-- transactionally with the rest of the login.
|
|
--
|
|
-- mfa_last_used_window prevents replay of a TOTP code within its 30-second
|
|
-- step. We persist the last accepted RFC 6238 time-step counter (long); a
|
|
-- re-presented code matches that counter and is rejected.
|
|
|
|
ALTER TABLE public.users
|
|
ADD COLUMN IF NOT EXISTS mfa_enabled boolean NOT NULL DEFAULT false,
|
|
ADD COLUMN IF NOT EXISTS mfa_secret text NULL,
|
|
ADD COLUMN IF NOT EXISTS mfa_recovery_codes jsonb NULL,
|
|
ADD COLUMN IF NOT EXISTS mfa_enrolled_at timestamp NULL,
|
|
ADD COLUMN IF NOT EXISTS mfa_last_used_window bigint NULL;
|
|
|
|
-- AZ-534 — pin the authentication-methods-reference (RFC 8176) to the session
|
|
-- so refresh-token rotations (AZ-531) inherit the original auth strength. A user
|
|
-- who logs in with MFA stays "amr=[pwd,mfa]" for the entire refresh chain even if
|
|
-- they later disable MFA; conversely, enabling MFA mid-session does NOT silently
|
|
-- upgrade the in-flight session.
|
|
ALTER TABLE public.sessions
|
|
ADD COLUMN IF NOT EXISTS mfa_authenticated boolean NOT NULL DEFAULT false;
|