Files
2026-07-08 16:15:37 +02:00

100 lines
3.8 KiB
TypeScript

// AK-P16a · OAuth state signing for the Google connect flow (CSRF + context).
//
// The OAuth callback at /integrations/google/oauth/callback is NOT tenant-scoped
// (Google redirects to a fixed URI), so the tenant + user travel inside a SIGNED
// `state` parameter rather than a cookie. We HMAC-SHA256 the JSON payload with
// CRYPTO_SECRET||SESSION_SECRET (same convention as admin-sso/state.server) and
// URL-safe-base64 encode it. 10-minute TTL bounds the replay window.
import { createHmac, timingSafeEqual } from "node:crypto";
import { loadRequiredWebConfig } from "@hivegrid/config";
const STATE_TTL_MS = 10 * 60 * 1000;
const PAYLOAD_VERSION = "v1";
export interface CalendarOAuthStatePayload {
readonly tenantId: string;
readonly userId: string;
readonly tenantSlug: string;
/** Epoch milliseconds. */
readonly createdAt: number;
}
export type VerifyStateResult =
| { readonly ok: true; readonly payload: CalendarOAuthStatePayload }
| { readonly ok: false; readonly reason: "malformed" | "bad-signature" | "expired" };
function getSecret(override?: string): string {
if (override) return override;
const { cryptoSecret, sessionSecret } = loadRequiredWebConfig();
const secret = cryptoSecret || sessionSecret;
if (!secret) {
throw new Error("CRYPTO_SECRET or SESSION_SECRET is required for calendar OAuth state.");
}
return secret;
}
function base64UrlEncode(input: string): string {
return Buffer.from(input, "utf8").toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
}
function base64UrlDecode(value: string): string {
const pad = value.length % 4 === 0 ? "" : "=".repeat(4 - (value.length % 4));
return Buffer.from(value.replace(/-/g, "+").replace(/_/g, "/") + pad, "base64").toString("utf8");
}
function sign(body: string, secret: string): string {
return Buffer.from(createHmac("sha256", secret).update(body).digest()).toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
}
/** Sign a fresh state token for the consent redirect. */
export function signCalendarOAuthState(
input: { tenantId: string; userId: string; tenantSlug: string },
options: { now?: () => number; secret?: string } = {},
): string {
const payload: CalendarOAuthStatePayload = {
tenantId: input.tenantId,
userId: input.userId,
tenantSlug: input.tenantSlug,
createdAt: options.now ? options.now() : Date.now(),
};
const body = base64UrlEncode(JSON.stringify({ v: PAYLOAD_VERSION, p: payload }));
return `${body}.${sign(body, getSecret(options.secret))}`;
}
/** Verify + decode a state token returned by Google. */
export function verifyCalendarOAuthState(state: string, options: { now?: () => number; secret?: string } = {}): VerifyStateResult {
const dot = state.lastIndexOf(".");
if (dot <= 0) {
return { ok: false, reason: "malformed" };
}
const body = state.slice(0, dot);
const sig = state.slice(dot + 1);
let secret: string;
try {
secret = getSecret(options.secret);
} catch {
return { ok: false, reason: "malformed" };
}
const expected = sign(body, secret);
const a = Buffer.from(sig);
const b = Buffer.from(expected);
if (a.length !== b.length || !timingSafeEqual(a, b)) {
return { ok: false, reason: "bad-signature" };
}
let decoded: { v: string; p: CalendarOAuthStatePayload };
try {
decoded = JSON.parse(base64UrlDecode(body)) as { v: string; p: CalendarOAuthStatePayload };
} catch {
return { ok: false, reason: "malformed" };
}
if (decoded.v !== PAYLOAD_VERSION || !decoded.p || typeof decoded.p.createdAt !== "number") {
return { ok: false, reason: "malformed" };
}
const now = options.now ? options.now() : Date.now();
if (now - decoded.p.createdAt > STATE_TTL_MS) {
return { ok: false, reason: "expired" };
}
return { ok: true, payload: decoded.p };
}