CFDivePlatform/openspec/specs/login-rate-limiting/spec.md at d1fe3d41387695f7c4520fd43c74a4faf80f3ddf

a620906209/CFDivePlatform

Files

T

a620906209 88a81aac41 docs(openspec): 同步 login-rate-limiting 規格門檻至實作值 10/min

規格原寫 5/min，實作與測試（commit 0dabc4e）皆為 throttle:10,1，
以實作為準消除規格漂移，並註記放寬理由（帳號鎖定已涵蓋暴力破解防護）。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-06-11 17:37:19 +08:00

1.2 KiB

Raw Blame History

ADDED Requirements

Requirement: 登入頻率限制

後端 SHALL 對所有登入端點套用 IP-based 頻率限制，超過限制時回傳 HTTP 429。Member 與 Provider 每 IP 每分鐘最多 10 次（原定 5 次；帳號鎖定機制上線後已涵蓋暴力破解防護，放寬以容納共享 IP 場景，與實作 throttle:10,1 一致）；Admin 因影響範圍更廣，限制為每 IP 每分鐘最多 3 次。

Scenario: Member / Provider 正常登入不受影響

WHEN 同一 IP 在 1 分鐘內對 /api/member/login 或 /api/provider/login 送出 10 次以內的請求
THEN 請求正常處理，回傳對應的登入結果（200 成功或 401 失敗）

Scenario: Member / Provider 超過頻率限制

WHEN 同一 IP 在 1 分鐘內送出第 11 次 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 的請求計數重置，可再次正常送出登入請求

1.2 KiB Raw Blame History