All checks were successful
Deploy eCourt Note Web to Server / Validate Database Schema (Drizzle) (push) Successful in 3s
Deploy eCourt Note Web to Server / Build Web Docker Image (push) Successful in 1m17s
Deploy eCourt Note Web to Server / Deploy eCourt Note Web to Server (push) Successful in 4s
Deploy eCourt Note Web to Server / Notify Deployment Status (push) Successful in 1s
- Split `verifyAddinTicket` into two functions: `verifyAddinTicketHmac` (ignores expiration) and `verifyAddinTicket` (checks expiration). - Add `hasVersionByUser` function to check if a document has been previously worked on by a user, allowing expired tickets to be accepted if the user has a history with the document. - Update OpenAPI specification to reflect changes in ticket expiration handling. - Introduce new scripts for installing and uninstalling the Word add-in on Windows and macOS, providing a streamlined process for sideloading the add-in. - Enhance tests for ticket verification to cover new functionality regarding expired tickets and user history.
114 lines
6.1 KiB
TypeScript
114 lines
6.1 KiB
TypeScript
// PLAN-DOCVER.md §auth — POST /api/documents/token ออก access_token ของกลุ่ม docver
|
|
// ทางเข้า 2 ทาง (PLAN-ADDIN-AUTH.md §3 — header x-api-key เป็นตัวตั้ง):
|
|
// 1) e-Court server-to-server: header "x-api-key" เทียบ env DOCVER_API_KEY
|
|
// (fail closed เมื่อ env ไม่ตั้ง/ว่าง) + body claims ตรง ๆ (เดิมทุกอย่าง)
|
|
// 2) add-in ใน Word: ไม่มี x-api-key + body {ticket_data, HmacSha256} — server
|
|
// ตรวจ HMAC ด้วย env ฝั่ง server (ADDIN_TICKET_SECRET → SECRET →
|
|
// "super_secret", lib/addin-ticket.ts) แล้วออก token จาก claims ของ ticket
|
|
// (secret ตัวเซ็น JWT ไม่มีทางไปอยู่ใน bundle ของ add-in) — ticket หมดอายุ
|
|
// ยังออกให้ต่อเมื่อ fid นี้เคยมี version โดย uid เดียวกัน (requirement ขั้น 7)
|
|
// ทั้งสองทางออก JWT HS256 เซ็นด้วย env DOCVER_TOKEN_SECRET อายุตาม env
|
|
// DOCVER_TOKEN_TTL_SECONDS (default 3600) แล้วนำไปแนบ Authorization: Bearer กับ
|
|
// endpoint อื่นของกลุ่ม (lib/docver-token.ts) · segment คงที่ "token" ไม่ชน [docId]
|
|
// (Next ให้ static ชนะ) และ middleware ยกเว้น api/documents/* อยู่แล้ว
|
|
import { docverError } from "@/lib/document-versioning";
|
|
import {
|
|
addinTicketSecret,
|
|
parseTicketTokenBody,
|
|
ticketToDocverClaims,
|
|
verifyAddinTicketHmac,
|
|
} from "@/lib/addin-ticket";
|
|
import { hasVersionByUser } from "@/lib/docver-store";
|
|
import { isTicketExpired } from "@/utils/docver-ticket";
|
|
import {
|
|
issueDocverToken,
|
|
parseTokenRequestBody,
|
|
requireDocverApiKey,
|
|
type DocverTokenClaims,
|
|
} from "@/lib/docver-token";
|
|
|
|
export const runtime = "nodejs";
|
|
export const dynamic = "force-dynamic";
|
|
|
|
/** 401 ของทางเข้า ticket — ข้อความเดียวทุกสาเหตุ (HMAC ผิด/รูปผิด/หมดอายุ/ไม่ส่งมา) กัน oracle */
|
|
const TICKET_DENIED = "ticket ไม่ถูกต้องหรือหมดอายุ";
|
|
|
|
export async function POST(request: Request) {
|
|
return request.headers.get("x-api-key") !== null
|
|
? postWithApiKey(request)
|
|
: postWithTicket(request);
|
|
}
|
|
|
|
/** ทางเข้า 1 (เดิม) — e-Court server-to-server */
|
|
async function postWithApiKey(request: Request): Promise<Response> {
|
|
const apiKeyFail = requireDocverApiKey(request);
|
|
if (apiKeyFail !== null) return apiKeyFail;
|
|
|
|
let raw: unknown;
|
|
try {
|
|
raw = await request.json();
|
|
} catch {
|
|
return docverError("body ต้องเป็น JSON", 400);
|
|
}
|
|
const parsed = parseTokenRequestBody(raw);
|
|
if (!parsed.ok) return docverError(parsed.error, 400);
|
|
return issueToken(parsed.claims);
|
|
}
|
|
|
|
/** ทางเข้า 2 — add-in ส่ง ticket ที่ e-Court stamp มากับไฟล์ */
|
|
async function postWithTicket(request: Request): Promise<Response> {
|
|
let raw: unknown;
|
|
try {
|
|
raw = await request.json();
|
|
} catch {
|
|
return docverError("body ต้องเป็น JSON", 400);
|
|
}
|
|
const parsed = parseTicketTokenBody(raw);
|
|
if (!parsed.ok) {
|
|
// missing = ไม่มี ticket มาเล่น ๆ (401 เดียวกับตอน verify ไม่ผ่าน)
|
|
// invalid = รูป body ผิดจริง ๆ ให้ 400 ตาม convention กัน typo เงียบ ๆ
|
|
return docverError(parsed.error, parsed.kind === "invalid" ? 400 : 401);
|
|
}
|
|
// ตรวจ HMAC ก่อนเสมอ (ตัวตนของผู้ถือไฟล์) — exp ไม่ใช่เกณฑ์ตัดสิทธิ์ ณ จุดนี้
|
|
const verified = verifyAddinTicketHmac(parsed.ticketData, parsed.hmacHex, addinTicketSecret());
|
|
if (!verified.ok) return docverError(TICKET_DENIED, 401);
|
|
|
|
// ticket หมดอายุ → ยังออก token ให้ต่อเมื่อ "เอกสารนี้เคยทำงานโดย uid เดียวกัน"
|
|
// (requirement ขั้น 7: กลับมาทำเอกสารเดิมผ่านได้แม้ ticket หมดอายุ — พิสูจน์จาก
|
|
// document_versions ของกลุ่มนี้เอง) · DB พัง = fail closed เป็น 401 เหมือนไม่มีสิทธิ์
|
|
if (isTicketExpired(verified.ticket.exp)) {
|
|
let workedBefore = false;
|
|
try {
|
|
workedBefore = await hasVersionByUser(verified.ticket.fid, verified.ticket.uid);
|
|
} catch {
|
|
workedBefore = false;
|
|
}
|
|
if (!workedBefore) return docverError(TICKET_DENIED, 401);
|
|
}
|
|
return issueToken(ticketToDocverClaims(verified.ticket));
|
|
}
|
|
|
|
/** ออก JWT ของ claims ที่ผ่านการยืนยันแล้วจากทั้งสองทาง — ส่วนกลาง */
|
|
async function issueToken(claims: DocverTokenClaims): Promise<Response> {
|
|
// ความผิด config ฝั่ง server ไม่ใช่ความผิดของผู้เรียก — ไม่ตั้ง = 500 (ห้าม log ค่า secret)
|
|
const secret = process.env.DOCVER_TOKEN_SECRET?.trim();
|
|
// const secret =
|
|
// "487023dd1c1c4d6a07475e96b1cc300fec1e68ac9c2dd7d5ac9b1bf75da1053e";
|
|
|
|
if (secret === undefined || secret === "") {
|
|
return docverError("DOCVER_TOKEN_SECRET ยังไม่ถูกตั้งค่า", 500);
|
|
}
|
|
const ttlRaw = Number(process.env.DOCVER_TOKEN_TTL_SECONDS);
|
|
const ttlSeconds =
|
|
Number.isFinite(ttlRaw) && ttlRaw > 0 ? Math.floor(ttlRaw) : 3600;
|
|
|
|
const accessToken = issueDocverToken(claims, secret, ttlSeconds);
|
|
return new Response(
|
|
JSON.stringify({
|
|
access_token: accessToken,
|
|
token_type: "Bearer",
|
|
expires_in: ttlSeconds,
|
|
}),
|
|
{ headers: { "content-type": "application/json; charset=utf-8" } },
|
|
);
|
|
}
|