ล็อกอินบัญชีทดสอบใน CI

ให้ e2e ใน CI ได้ session ของ บัญชีทดสอบ เอง โดยไม่ต้องมีคนคัดลอก cookie — ใช้ createTestSession จาก @suphark/auth-client/testing (≥ 0.8.0)

ทำไมปลอดภัย

คำขอต้องผ่านทุกด่านพร้อมกัน และทุกด่านปิดเป็นค่าเริ่มต้น:

1. สวิตช์ของแพลตฟอร์มเปิดอยู่ และสวิตช์ของแอปเปิดอยู่
2. แอปเป็น แอป dev (redirect URI ทุกตัวเป็น localhost) — แอป production เปิดไม่ได้เด็ดขาด
3. บัญชีอยู่ในรายชื่อบัญชีทดสอบของแอป ไม่มีสิทธิ์ผู้ดูแลแพลตฟอร์ม และไม่เป็นสมาชิกองค์กร production
4. ใช้ได้เฉพาะองค์กรชนิด SANDBOX ที่ติดตั้งแอปนี้ — token ใช้ได้กับแอปนี้เท่านั้น ไม่มี Management API ไม่มี refresh token

session อายุ 15 นาที ทุกครั้งที่ออกหรือถูกปฏิเสธบันทึก audit (test_login.issued / test_login.denied)

ตั้งค่าครั้งเดียว

1. ผู้ดูแลแพลตฟอร์ม: เปิดสวิตช์และเตรียมองค์กรทดสอบ

   แพลตฟอร์ม → ตั้งค่า → "ล็อกอินบัญชีทดสอบของ CI" → เปิด (ยืนยันตัวตนซ้ำ) แล้วสร้างองค์กรทดสอบและตั้ง environment เป็น SANDBOX

2. ผู้ดูแลองค์กรทดสอบ: ติดตั้งแอปและเชิญบัญชีทดสอบ

   ติดตั้งแอป ให้ role ที่ e2e ต้องใช้ แล้วเชิญบัญชีทดสอบเป็นสมาชิก — ตั้งนโยบาย MFA ขององค์กรนี้เป็น "ไม่บังคับ"

3. เจ้าของแอป: ลงทะเบียนแอป dev

   ชื่อ <แอป>-dev redirect เป็น http://localhost:… ทั้งหมด (ดู แอป dev กับ production)

4. เจ้าของแอป: เปิดล็อกอินทดสอบ

   หน้าแอป → ตั้งค่า → "ล็อกอินทดสอบ (CI)" → เปิดสวิตช์และใส่อีเมลบัญชีทดสอบ (ตรวจบัญชีให้ตอนบันทึก)

env ที่ CI ต้องมี (เก็บเป็น secret)

Playwright

import fs from "node:fs";
import { createTestSession } from "@suphark/auth-client/testing";

export default async function globalSetup() {
  const s = await createTestSession({
    issuer: process.env.PI_AUTH_ISSUER!,
    clientId: process.env.PI_AUTH_CLIENT_ID!, // แอป dev ที่เปิดล็อกอินทดสอบไว้
    clientSecret: process.env.PI_AUTH_CLIENT_SECRET!,
    sessionSecret: process.env.PI_AUTH_SESSION_SECRET!,
    email: process.env.PI_AUTH_TEST_EMAIL!,
    cookieName: "my-app.session", // = session.cookieName ใน createPiAuth
    appUrl: "http://localhost:3000",
  });
  fs.writeFileSync("e2e/.auth/state.json", JSON.stringify(s.storageState));
}
// playwright.config.ts: globalSetup + use: { storageState: "e2e/.auth/state.json" }

• session ไม่มี refresh — ชุดทดสอบที่ยาวเกิน 15 นาทีให้เรียก createTestSession ซ้ำ (เช่น fixture ต่อ worker)
• ใช้ใน runtime ของแอปจริงไม่ได้ (ปฏิเสธเมื่อ NODE_ENV=production)
• เคยเก็บ cookie ของคนจริงเป็น secret ของ CI → ลบ secret นั้น และ sign out session นั้นทิ้ง

ถูกปฏิเสธ

error บอกเหตุผล (test-user grant denied: <เหตุผล> / TestSessionError.message):