Files
CFDivePlatform/openspec/changes/archive/2026-06-02-auth-p0-hardening/specs/admin-auth/spec.md
T
a620906209 cb9c9a9385 security(auth): P0 認證安全強化
- Token 過期時間設為 7 天(sanctum.php expiration)
- prune-expired 每日排程清除過期 token 記錄
- Google OAuth redirect 改用 URL fragment(#token=)避免 token 出現在 server log
- SocialAuthController env() 改 config() 修正 config:cache 下 redirect 失效問題
- 登入端點加 rate limiting:member/provider throttle:5,1,admin throttle:3,1
- axios/coachAxios 加 401 response interceptor,token 過期自動登出
- 修正 migration SQLite 相容性(MODIFY COLUMN),Feature tests 從 7 通過恢復至 41
- 新增 AuthRateLimitTest(5 tests)驗證各角色頻率限制行為

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-02 01:54:40 +08:00

1.3 KiB
Raw Blame History

MODIFIED Requirements

Requirement: 管理員登入

後端 SHALL 提供 POST /api/admin/login(現有 AuthController 方法),驗證 email/password 並確認 role=admin,回傳有效期 7 天的 Bearer token。

Scenario: 正確帳密登入

  • WHEN 管理員送出正確 email 與 password
  • THEN 回傳 HTTP 200{ status: true, data: { user, token, token_type: "Bearer" } }

Scenario: 非 admin 角色帳號嘗試登入

  • WHEN role 非 admin 的帳號嘗試呼叫此端點
  • THEN 回傳 HTTP 401{ status: false, message: "電子郵件或密碼錯誤" }

Scenario: 超過登入頻率限制

  • WHEN 同一 IP 在 1 分鐘內送出超過 3 次登入請求
  • THEN 回傳 HTTP 429,帶有 Retry-After header

ADDED Requirements

Requirement: 管理員 Bearer Token 有效期

後端 SHALL 發行有效期為 7 天的管理員 Bearer Token,過期後需重新登入。

Scenario: Token 過期後管理員請求被拒絕

  • WHEN 管理員使用已過期(超過 7 天)的 token 送出 API 請求
  • THEN 回傳 HTTP 401token 視為無效

Scenario: 有效期內 token 正常通過認證

  • WHEN 管理員使用未過期的 token 送出 API 請求
  • THEN 請求正常通過認證,回傳對應資源