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>
This commit is contained in:
@@ -1,7 +1,7 @@
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: 管理員登入
|
||||
後端 SHALL 提供 `POST /api/admin/login`(現有 AuthController 方法),驗證 email/password 並確認 role=admin,回傳 Bearer token。
|
||||
後端 SHALL 提供 `POST /api/admin/login`(現有 AuthController 方法),驗證 email/password 並確認 role=admin,回傳有效期 7 天的 Bearer token。
|
||||
|
||||
#### Scenario: 正確帳密登入
|
||||
- **WHEN** 管理員送出正確 email 與 password
|
||||
@@ -11,6 +11,10 @@
|
||||
- **WHEN** role 非 admin 的帳號嘗試呼叫此端點
|
||||
- **THEN** 回傳 HTTP 401,`{ status: false, message: "電子郵件或密碼錯誤" }`
|
||||
|
||||
#### Scenario: 超過登入頻率限制
|
||||
- **WHEN** 同一 IP 在 1 分鐘內送出超過 3 次登入請求
|
||||
- **THEN** 回傳 HTTP 429,帶有 `Retry-After` header
|
||||
|
||||
---
|
||||
|
||||
### Requirement: 管理員登出
|
||||
@@ -28,3 +32,16 @@
|
||||
#### Scenario: 取得個人資料
|
||||
- **WHEN** 已登入管理員送出 GET 請求
|
||||
- **THEN** 回傳 HTTP 200,包含 name / email / role / adminProfile(position / department)
|
||||
|
||||
---
|
||||
|
||||
### Requirement: 管理員 Bearer Token 有效期
|
||||
後端 SHALL 發行有效期為 7 天的管理員 Bearer Token,過期後需重新登入。
|
||||
|
||||
#### Scenario: Token 過期後管理員請求被拒絕
|
||||
- **WHEN** 管理員使用已過期(超過 7 天)的 token 送出 API 請求
|
||||
- **THEN** 回傳 HTTP 401,token 視為無效
|
||||
|
||||
#### Scenario: 有效期內 token 正常通過認證
|
||||
- **WHEN** 管理員使用未過期的 token 送出 API 請求
|
||||
- **THEN** 請求正常通過認證,回傳對應資源
|
||||
|
||||
@@ -0,0 +1,20 @@
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: 登入頻率限制
|
||||
後端 SHALL 對所有登入端點套用 IP-based 頻率限制,超過限制時回傳 HTTP 429。Member 與 Provider 每 IP 每分鐘最多 5 次;Admin 因影響範圍更廣,限制為每 IP 每分鐘最多 3 次。
|
||||
|
||||
#### Scenario: Member / Provider 正常登入不受影響
|
||||
- **WHEN** 同一 IP 在 1 分鐘內對 `/api/member/login` 或 `/api/provider/login` 送出 5 次以內的請求
|
||||
- **THEN** 請求正常處理,回傳對應的登入結果(200 成功或 401 失敗)
|
||||
|
||||
#### Scenario: Member / Provider 超過頻率限制
|
||||
- **WHEN** 同一 IP 在 1 分鐘內送出第 6 次 member 或 provider 登入請求
|
||||
- **THEN** 回傳 HTTP 429,並帶有 `Retry-After` header 指示等待時間
|
||||
|
||||
#### Scenario: Admin 超過頻率限制
|
||||
- **WHEN** 同一 IP 在 1 分鐘內送出第 4 次 `/api/admin/login` 請求
|
||||
- **THEN** 回傳 HTTP 429,並帶有 `Retry-After` header 指示等待時間
|
||||
|
||||
#### Scenario: 頻率限制重置
|
||||
- **WHEN** 頻率限制觸發後等待 1 分鐘
|
||||
- **THEN** 該 IP 的請求計數重置,可再次正常送出登入請求
|
||||
@@ -75,6 +75,27 @@
|
||||
- **WHEN** 使用者點擊「以 Google 登入」按鈕
|
||||
- **THEN** 瀏覽器導航至後端 `GET /api/auth/google/redirect`,開始 OAuth 流程
|
||||
|
||||
#### Scenario: 超過登入頻率限制
|
||||
- **WHEN** 同一 IP 在 1 分鐘內送出超過 5 次登入請求
|
||||
- **THEN** 前端顯示適當的錯誤訊息(對應後端回傳的 HTTP 429)
|
||||
|
||||
---
|
||||
|
||||
### Requirement: Google OAuth Callback 處理
|
||||
前端 SHALL 在 `/auth/callback` 路由讀取 URL fragment(`#token=<value>`)取得 Sanctum token,完成 OAuth 登入後將 token 存入 localStorage 並導航至 `/courses`。token 不得透過 URL query string 傳遞。
|
||||
|
||||
#### Scenario: OAuth callback 成功取得 token
|
||||
- **WHEN** 後端 OAuth callback redirect 到 `/auth/callback#token=<token>`
|
||||
- **THEN** 前端從 `window.location.hash` 解析 token,呼叫 `/api/member/profile` 取得使用者資料,呼叫 `auth.setAuth()` 儲存認證狀態,並導航至 `/courses`
|
||||
|
||||
#### Scenario: OAuth callback 缺少 token
|
||||
- **WHEN** redirect 到 `/auth/callback` 但 hash 中無 `token` 參數
|
||||
- **THEN** 前端導航至 `/login?error=oauth_failed`,顯示錯誤訊息
|
||||
|
||||
#### Scenario: URL 中不留存 token
|
||||
- **WHEN** callback 頁面成功處理 token 後
|
||||
- **THEN** 瀏覽器網址列不顯示 token(使用 `history.replaceState` 清除 hash)
|
||||
|
||||
---
|
||||
|
||||
### Requirement: 註冊頁
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: 教練帳號登入
|
||||
後端 SHALL 提供 `POST /api/provider/login`,驗證 email/password 並回傳 Sanctum Bearer token,僅限 role=provider 帳號。
|
||||
後端 SHALL 提供 `POST /api/provider/login`,驗證 email/password 並回傳 Sanctum Bearer token,僅限 role=provider 帳號。回傳的 token 有效期為 7 天。
|
||||
|
||||
#### Scenario: 正確帳密登入成功
|
||||
- **WHEN** 教練送出正確的 email 與 password
|
||||
@@ -15,6 +15,10 @@
|
||||
- **WHEN** role=member 的帳號嘗試呼叫 `/api/provider/login`
|
||||
- **THEN** 回傳 HTTP 403,`{ status: false, message: "此帳號非教練角色" }`
|
||||
|
||||
#### Scenario: 超過登入頻率限制
|
||||
- **WHEN** 同一 IP 在 1 分鐘內送出超過 5 次登入請求
|
||||
- **THEN** 回傳 HTTP 429,帶有 `Retry-After` header
|
||||
|
||||
---
|
||||
|
||||
### Requirement: 教練帳號註冊
|
||||
@@ -54,3 +58,16 @@
|
||||
#### Scenario: 更新成功
|
||||
- **WHEN** 教練送出合法的更新資料
|
||||
- **THEN** 回傳 HTTP 200,`{ status: true, message: "資料已更新", data: { ...profile } }`
|
||||
|
||||
---
|
||||
|
||||
### Requirement: Bearer Token 有效期
|
||||
後端 SHALL 發行有效期為 7 天的 Sanctum Bearer Token,過期後使用者必須重新登入。
|
||||
|
||||
#### Scenario: Token 過期後請求被拒絕
|
||||
- **WHEN** 教練使用已過期(超過 7 天)的 token 送出 API 請求
|
||||
- **THEN** 回傳 HTTP 401,token 視為無效
|
||||
|
||||
#### Scenario: 有效期內 token 正常運作
|
||||
- **WHEN** 教練使用未過期的 token 送出 API 請求
|
||||
- **THEN** 請求正常通過認證
|
||||
|
||||
Reference in New Issue
Block a user