// N10 (PLAN-API.md D1) — auth ของ /api/note/external/* (ผู้เรียก: backend e-Court, // server-to-server ไม่มี browser) // - API Key เดียวใน env EXTERNAL_API_KEY ส่งผ่าน header "x-api-key" // - เทียบแบบ timing-safe: hash SHA-256 ทั้งสองค่าแล้ว timingSafeEqual // (digest ยาว 32 ไบต์เท่ากันเสมอ — กัน timing + length leak) // - env ไม่ตั้ง/ว่าง = ปฏิเสธทุก request (fail closed) — ไม่มี mode เปิดฟรี // - ข้อความ 401 ของ "ไม่ใส่ key" กับ "key ผิด" เป็นอันเดียวกัน (กัน enumerate) // - ห้าม log ค่า key / header ดิบ // // ห้าม import อะไรที่ลาก @/db มาด้วย (db/index.ts throw ตอน import เมื่อไม่มี // DATABASE_URL) — unit test ของไฟล์นี้ต้องรันได้โดยไม่ต้องตั้งค่า DB เลย import { createHash, timingSafeEqual } from "node:crypto"; /** Response ผิดพลาดของ API ภายนอกทุกกรณี — JSON {"error": "<ไทย>"} ตาม D2 */ export function externalApiError(message: string, status: number): Response { return new Response(JSON.stringify({ error: message }), { status, headers: { "content-type": "application/json; charset=utf-8" }, }); } /** * คืน null เมื่อผ่าน / คืน Response 401 เมื่อไม่ผ่าน — route เรียกเป็นอย่างแรก * ก่อนแตะ DB ทุกครั้ง (PLAN-API.md D3) */ export function requireExternalApiKey(req: Request): Response | null { // เทียบกับค่า trim แล้ว — key สุ่มไม่ควรมี whitespace อยู่แล้ว และกัน // trailing newline จาก K8s secret / docker env_file ทำ 401 ทั้งระบบตามผู้เรียก // ที่ส่ง key ถูก (header เองก็ strip OWS รอบค่า ผู้เรียกส่ง whitespace ครอบไม่ได้) const envKey = process.env.EXTERNAL_API_KEY?.trim(); if (envKey === undefined || envKey === "") { return externalApiError("API ยังไม่ได้ตั้งค่าคีย์", 401); } const provided = req.headers.get("x-api-key"); if (provided === null || provided === "") { return externalApiError("API key ไม่ถูกต้อง", 401); } const providedHash = createHash("sha256").update(provided).digest(); const envHash = createHash("sha256").update(envKey).digest(); return timingSafeEqual(providedHash, envHash) ? null : externalApiError("API key ไม่ถูกต้อง", 401); }