Repository Public
1import { z } from "zod";2import { ApiError, body, clientIp } from "../http";3import { rateLimit } from "../ratelimit";4import {5 assertCsrf, assertSameOrigin, authenticationOptions, clearSessionCookie, currentUser, listPasskeys, listSessions, loginWithRecoveryCode,6 reauthOptions, recoveryCodesLeft, regenerateRecoveryCodes, registrationOptions, renamePasskey, revokePasskey, revokeSession, setupTokenInfo,7 verifyAuthentication, verifyReauth, verifyRegistration, type UserContext,8} from "../auth";9import { audit } from "../audit";10import type { RouteDef } from "./router";1112const anyJson = z.record(z.string(), z.unknown());13const ceremony = z.object({ challengeId: z.string().uuid(), response: anyJson });1415/** Signed-in user of a passkey-management route: full session (not a recovery-code one) + CSRF. */16async function manager(req: Request): Promise<UserContext> {17 const u = await currentUser();18 if (!u) throw new ApiError(401, "unauthenticated", "Sign in required");19 if (u.method === "recovery_code") throw new ApiError(403, "passkey_required", "Enrol a passkey to continue");20 if (req.method !== "GET") assertCsrf(req, u);21 return u;22}2324/**25 * /api/auth/* — WebAuthn ceremonies (options and verification are separate routes; every challenge is bound to26 * the browser or session that asked for it and consumed once) and the administrator's own credentials.27 * Every route is rate-limited per client address.28 */29export const authRoutes: RouteDef<{ ip: string }>[] = [30 ["GET", "session", async () => {31 const u = await currentUser();32 if (!u) return { authenticated: false };33 return { authenticated: true, csrfToken: u.csrfToken, limited: u.method === "recovery_code", reauthAt: u.reauthAt, user: { id: u.userId, displayName: u.displayName, locale: u.locale } };34 }],3536 // First setup / recovery, with a one-time token issued from the server's shell.37 ["POST", "setup/info", async ({ req, ctx }) => {38 assertSameOrigin(req); await rateLimit(`auth:${ctx.ip}`, 30, 600);39 return setupTokenInfo((await body(req, z.object({ setupToken: z.string().min(20).max(200) }))).setupToken);40 }],41 ["POST", "register/options", async ({ req, ctx }) => {42 assertSameOrigin(req); await rateLimit(`auth:${ctx.ip}`, 30, 600);43 const b = await body(req, z.object({ setupToken: z.string().max(200).optional() }));44 const user = b.setupToken ? null : await currentUser();45 if (user) assertCsrf(req, user);46 return registrationOptions({ setupToken: b.setupToken, user });47 }],48 ["POST", "register/verify", async ({ req, ctx }) => {49 assertSameOrigin(req); await rateLimit(`auth:${ctx.ip}`, 30, 600);50 const b = await body(req, ceremony.extend({ name: z.string().max(60).optional(), setupToken: z.string().max(200).optional() }));51 const user = b.setupToken ? null : await currentUser();52 if (user) assertCsrf(req, user);53 return verifyRegistration({ challengeId: b.challengeId, response: b.response as never, name: b.name, setupToken: b.setupToken, user }, req);54 }],5556 ["POST", "login/options", async ({ req, ctx }) => { assertSameOrigin(req); await rateLimit(`auth:${ctx.ip}`, 30, 600); return authenticationOptions(req); }],57 ["POST", "login/verify", async ({ req, ctx }) => {58 assertSameOrigin(req); await rateLimit(`auth:${ctx.ip}`, 30, 600);59 const b = await body(req, ceremony);60 return verifyAuthentication({ challengeId: b.challengeId, response: b.response as never }, req);61 }],62 ["POST", "recovery", async ({ req, ctx }) => {63 assertSameOrigin(req); await rateLimit(`recovery:${ctx.ip}`, 5, 900);64 return loginWithRecoveryCode((await body(req, z.object({ code: z.string().min(8).max(60) }))).code, req);65 }],6667 ["POST", "reauth/options", async ({ req, ctx }) => { await rateLimit(`auth:${ctx.ip}`, 30, 600); return reauthOptions(await manager(req)); }],68 ["POST", "reauth/verify", async ({ req, ctx }) => {69 await rateLimit(`auth:${ctx.ip}`, 30, 600);70 const u = await manager(req); const b = await body(req, ceremony);71 return verifyReauth(u, { challengeId: b.challengeId, response: b.response as never }, req);72 }],7374 ["GET", "passkeys", async ({ req }) => { const u = await manager(req); return { passkeys: await listPasskeys(u.userId), recoveryCodesLeft: await recoveryCodesLeft(u.userId), sessions: await listSessions(u) }; }],75 ["PATCH", "passkeys/:id", async ({ req, params }) => { const u = await manager(req); return renamePasskey(u, z.string().uuid().parse(params.id), (await body(req, z.object({ name: z.string().min(1).max(60) }))).name); }],76 ["DELETE", "passkeys/:id", async ({ req, params }) => revokePasskey(await manager(req), z.string().uuid().parse(params.id), req)],77 ["POST", "recovery-codes", async ({ req }) => regenerateRecoveryCodes(await manager(req), req)],78 ["DELETE", "sessions/:id", async ({ req, params }) => {79 const u = await manager(req);80 if (!(await revokeSession(z.string().uuid().parse(params.id), u.userId))) throw new ApiError(404, "not_found");81 await audit({ userId: u.userId, actor: "admin", action: "session.revoked", entityId: params.id, ip: clientIp(req) });82 return { ok: true };83 }],8485 ["POST", "logout", async ({ req }) => {86 assertSameOrigin(req);87 const u = await currentUser();88 if (u) { assertCsrf(req, u); await revokeSession(u.sessionId, u.userId); await audit({ userId: u.userId, actor: "admin", action: "logout", ip: clientIp(req) }); }89 await clearSessionCookie();90 return { ok: true };91 }],92];93