File size: 3,225 Bytes
1302ebc
 
 
 
 
 
 
a23faa4
1302ebc
 
 
a58f822
 
1302ebc
 
151f613
 
1302ebc
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
cac73cf
 
 
 
 
1302ebc
 
 
f5af762
 
 
 
 
 
 
a23faa4
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
/**
 * Session 與 cookie 工具(OAuth 登入用)。
 *
 * - 不自存密碼(登入走 OAuth),故這裡只負責「登入後的 session token」與 cookie 讀寫。
 * - session token = 32 bytes 隨機值(不可猜),存後端、放進 httpOnly cookie;JS 讀不到 → 防 XSS 竊取。
 * - cookie 手動序列化/解析(OAuth state 與 session 皆為隨機值,毋須簽章),不引入額外相依。
 */
import { randomBytes, timingSafeEqual } from "node:crypto";

export const SESSION_COOKIE = "wcg_session";
export const STATE_COOKIE = "wcg_oauth_state";
/** 登入後要返回的站內路徑(短效,與 state 同生命週期)。 */
export const NEXT_COOKIE = "wcg_oauth_next";
/** session 有效期:30 天。 */
export const SESSION_TTL_SEC = 60 * 60 * 24 * 30;
/** OAuth state cookie 短效期:30 分鐘(夠走完授權往返;使用者在 Google 同意頁逗留也不易過期)。 */
export const STATE_TTL_SEC = 60 * 30;

/** 產生不可猜的隨機 token(base64url,無需 URL 編碼)。 */
export function newToken(): string {
  return randomBytes(32).toString("base64url");
}

export interface CookieOpts {
  maxAgeSec?: number;
  httpOnly?: boolean;
  secure?: boolean;
  sameSite?: "Strict" | "Lax" | "None";
  path?: string;
}

/** 序列化成單一 Set-Cookie 字串。 */
export function serializeCookie(name: string, value: string, opts: CookieOpts = {}): string {
  const parts = [`${name}=${encodeURIComponent(value)}`];
  if (opts.maxAgeSec !== undefined) parts.push(`Max-Age=${Math.floor(opts.maxAgeSec)}`);
  parts.push(`Path=${opts.path ?? "/"}`);
  if (opts.httpOnly) parts.push("HttpOnly");
  if (opts.secure) parts.push("Secure");
  if (opts.sameSite) parts.push(`SameSite=${opts.sameSite}`);
  return parts.join("; ");
}

/** 立即過期的 cookie(登出/清 state 用)。 */
export function clearCookie(name: string, secure: boolean): string {
  return serializeCookie(name, "", { maxAgeSec: 0, httpOnly: true, secure, sameSite: "Lax" });
}

/** 解析 Cookie 請求標頭成 name→value。 */
export function parseCookies(header: string | undefined): Record<string, string> {
  const out: Record<string, string> = {};
  if (!header) return out;
  for (const part of header.split(";")) {
    const idx = part.indexOf("=");
    if (idx < 0) continue;
    const k = part.slice(0, idx).trim();
    if (!k) continue;
    try {
      out[k] = decodeURIComponent(part.slice(idx + 1).trim());
    } catch {
      // 壞的 percent-encoding 不該讓任一 auth/admin 路由噴 500;忽略該 cookie 即可。
    }
  }
  return out;
}

/** 從 Authorization 標頭取 Bearer token(Activity 用,無 cookie 時的身分憑證);無則 null。 */
export function parseBearer(header: string | undefined): string | null {
  if (!header) return null;
  const m = /^Bearer\s+(.+)$/i.exec(header.trim());
  return m ? m[1]!.trim() : null;
}

/** 定速字串比對(防 token 比對的時序側信道);長度不同直接 false。 */
export function safeEqual(a: string, b: string): boolean {
  const ab = Buffer.from(a, "utf8");
  const bb = Buffer.from(b, "utf8");
  if (ab.length !== bb.length) return false;
  return timingSafeEqual(ab, bb);
}