mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-18 08:02:12 +00:00
feat(security): add a TOTP and security-key setup hub
Introduce a dedicated /settings/security section that gathers every account-protection control in one place: TOTP enrolment (QR plus manual secret, confirm, recovery codes shown once with copy and download), WebAuthn security keys as a second factor (register, list with last-used, rename, step-up-gated removal), recovery-code count and regeneration, and primary passkey management. The second-factor WebAuthn path keeps its own credential store, separate from primary passkeys, and uses non-resident keys so an account can hold many. Relying-party resolution is shared with the passkey path. A status endpoint backs the hub; the step-up gate now recognises a registered security key as an active second factor so a WebAuthn-only account can still reach the gated actions.
This commit is contained in:
1 parent
6d053c3667
commit
402ea90d45
32 files changed
+3246
-401
No files matched your search
@@ -48,3 +48,66 @@ export const mfaVerifySchema = z
|
||||
description:
|
||||
"Complete a second-factor login challenge and receive the same token bundle the password path issues.",
|
||||
});
|
||||
|
||||
// ── WebAuthn security key (second factor) ────────────────────────────
|
||||
|
||||
/**
|
||||
* A SimpleWebAuthn-style ceremony response. Kept permissive at the wire
|
||||
* boundary — the cryptographic validation lives inside
|
||||
* `@simplewebauthn/server`; this just pins the envelope shape for OpenAPI and
|
||||
* the runtime `safeParse`.
|
||||
*/
|
||||
const webauthnCredentialSchema = z
|
||||
.object({
|
||||
id: z.string(),
|
||||
rawId: z.string(),
|
||||
type: z.literal("public-key"),
|
||||
response: z.record(z.string(), z.unknown()),
|
||||
authenticatorAttachment: z.enum(["platform", "cross-platform"]).optional(),
|
||||
clientExtensionResults: z.record(z.string(), z.unknown()).optional(),
|
||||
})
|
||||
.describe("SimpleWebAuthn ceremony response payload.");
|
||||
|
||||
/** A human label for a registered security key (settings + rename). */
|
||||
export const webauthnKeyNameSchema = z.string().trim().min(1).max(64);
|
||||
|
||||
/** Register a security key as a second factor (cookie session, settings). */
|
||||
export const mfaWebauthnRegisterVerifySchema = z
|
||||
.object({
|
||||
challengeId: z.string().min(1),
|
||||
credential: webauthnCredentialSchema,
|
||||
name: webauthnKeyNameSchema.optional(),
|
||||
})
|
||||
.meta({
|
||||
id: "MfaWebauthnRegisterVerifyRequest",
|
||||
description:
|
||||
"Finish registering a WebAuthn security key as a second factor.",
|
||||
});
|
||||
|
||||
/** Rename a registered security key. */
|
||||
export const mfaWebauthnRenameSchema = z
|
||||
.object({ name: webauthnKeyNameSchema })
|
||||
.meta({ id: "MfaWebauthnRenameRequest" });
|
||||
|
||||
/** Begin a mid-login security-key assertion: present the login MFA ticket. */
|
||||
export const mfaWebauthnLoginOptionsSchema = z
|
||||
.object({
|
||||
mfaTicket: z
|
||||
.string()
|
||||
.min(1)
|
||||
.describe("The opaque single-use ticket from the login response."),
|
||||
})
|
||||
.meta({ id: "MfaWebauthnLoginOptionsRequest" });
|
||||
|
||||
/** Complete a mid-login security-key assertion. */
|
||||
export const mfaWebauthnLoginVerifySchema = z
|
||||
.object({
|
||||
mfaTicket: z.string().min(1),
|
||||
challengeId: z.string().min(1),
|
||||
credential: webauthnCredentialSchema,
|
||||
})
|
||||
.meta({
|
||||
id: "MfaWebauthnLoginVerifyRequest",
|
||||
description:
|
||||
"Complete a second-factor login challenge with a WebAuthn security key and receive the same token bundle the password path issues.",
|
||||
});
|
||||
Reference in new issue
Block a user