Skip to content

Fix #23: rate-limit and lock out repeated failed logins - #37

Open
xiaoyao-666-coder wants to merge 2 commits into
zhengdaodeguL:mainfrom
xiaoyao-666-coder:fix/issue-23-login-rate-limit
Open

xiaoyao-666-coder wants to merge 2 commits into
zhengdaodeguL:mainfrom
xiaoyao-666-coder:fix/issue-23-login-rate-limit

Conversation

@xiaoyao-666-coder

Copy link
Copy Markdown

问题

登录接口无任何限流/锁定,可无限爆破:同一账号连续错误密码 40 次仍返回 401,无任何延迟、锁定或 429;换不存在的账号也一样。对一个已知用户名 + 密码字典可无限尝试,失败响应时间恒定,弱口令账号在“无限次 + 恒定成本”下没有保护。(注:issue 描述有两处与代码不符,以代码为准——auth.py 里没有 time.sleep(0.1),方法名是 verify_credentials 不是 authenticate;main.py 里也不存在 issue 所说的全局限流中间件,只有 CORS 和防缓存中间件,登录之前是完全无上限的。)

修复

  • 存储选进程内存,不用 Redis:API 是单 uvicorn worker(backend/Dockerfile 无 --workers),进程内状态即覆盖整个部署;Redis 在本项目是可选的(REDIS_URL 可缺省、会话存储会回退内存),把登录安全绑在它上面会在 Redis 宕机或未配置时 fail-open。代价是重启后锁定状态丢失,验收标准允许这一点;将来若改多 worker 部署,需换共享存储。
  • 两个维度独立计数:账号维度 5 次失败 → 锁定 15 分钟;IP 维度 20 次失败 → 锁定 15 分钟。窗口 15 分钟、锁定时长 15 分钟、阈值均可由环境变量调(MEDGUIDE_LOGIN_MAX_FAILED_ATTEMPTS、MEDGUIDE_LOGIN_MAX_FAILED_ATTEMPTS_PER_IP、MEDGUIDE_LOGIN_ATTEMPT_WINDOW_SECONDS、MEDGUIDE_LOGIN_LOCKOUT_SECONDS,越界值钳制不报错),未引入新依赖、未改 compose。
  • 状态码选 429 + Retry-After 头:锁定期间直接拒绝,文案统一为“登录尝试过于频繁,请稍后再试”,已知/未知账号完全相同,不透露账号是否存在。
  • 防枚举:不存在的账号与已知账号一样计数、一样锁定;verify_credentials 本来就对未知用户用 dummy salt/hash 跑满 PBKDF2,失败耗时与已知账号一致。
  • 锁定期间的尝试不延长锁定:否则攻击者持续 hammer 可把合法用户永久锁在门外;锁满 15 分钟后状态清零。成功登录只清账号维度的失败记录,不清 IP 维度(共享地址下一个用户的成功不能掩盖另一个地址的攻击)。另有 10,000 个 key 的上限防随机用户名喷洒耗尽内存,超了淘汰最旧的 key。
  • IP 取址:只在直连方属于可信代理 CIDR(复用 HTTPS 门已有的 _trusted_proxy_networks())时才取 X-Forwarded-For 首项,否则用直连方地址——部署拓扑是浏览器 → Caddy → UI nginx → API,两级代理都会追加 XFF,首项即真实浏览器 IP;直连客户端伪造 XFF 既逃不掉限流也锁不到别人。
  • 注册接口未动。

验证

  • 后端:MEDGUIDE_MODE=test python -m pytest -q backend/tests 534 passed(基线 521 + 13 新)。覆盖:账号锁定与过期(假时钟)、锁定期间正确密码也被拒、成功登录清零计数、未知账号同等锁定、分账号隔离、IP 维度跨账号锁定、失败耗时不泄露账号存在(两者均 ≥5ms、比值 <3、状态与 body 完全相同)、XFF 仅信任可信代理、锁定不延长、key 上限、畸形用户名不崩。
  • 真实服务实测(uvicorn 跑在 127.0.0.1:8123,MEDGUIDE_MODE=test + 临时 auth 库,临时账号):注册 201;连续 10 次错密码 → [401, 401, 401, 401, 401, 429, 429, 429, 429, 429];锁定期间正确密码 → 429、{"detail": "登录尝试过于频繁,请稍后再试"}、Retry-After: 900;未知账号 7 次 → [401×5, 429, 429];另一账号注册 201、登录 200——与 round-2 复现的“40 次仍全是 401”对比,爆破已被挡住。服务器已停,临时库已删,未动任何真实账号。
  • 前端未动。

已知遗留

  • 锁定状态重启即失、多 worker 部署下每 worker 各自计数(见模块 docstring 的设计说明),这是内存方案的已知取舍。
  • 429 文案前端会直接展示,登录页的错误提示无需另改(未做浏览器实点确认)。

Closes #23

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[中] 登录接口无任何限流/锁定,可无限暴力破解

1 participant