← 返回笔记列表

密码登录的三个细节:哈希、枚举与限流

发布于 来自 半盏灯 最近更新

  • Go
  • 认证
  • bcrypt
  • 安全

bcrypt:工作因子与那个 72 字节上限

密码存储用 bcrypt 一类带盐的慢哈希,工作因子由配置控制,常见取值 12;启动时校验范围(如 10~14)。调高更安全,但登录会更慢 —— 上线前应该在目标机器上实测一次哈希耗时,而不是照抄别人的数字。

hash, err := hasher.Hash(plain)          // 超过 72 字节直接拒绝,不静默截断
ok := hasher.Verify(hash, plain)         // 哈希非法时也消耗一次真实计算
if hasher.NeedsRehash(hash) { /* 登录成功时顺带升级工作因子 */ }

72 字节是 bcrypt 的硬限制,超长部分会被静默丢弃。稳妥的做法是把这个上限写成显式配置,且注册与登录共用同一套长度规则:Hash 直接拒绝,而不是让用户以为自己那串 100 字符的密码真的全部参与了校验。

Verify 在哈希非法时仍做一次真实计算,是为了抹平响应时间差 —— 否则损坏的哈希行会变成「这个账号数据异常」的计时探针。NeedsRehash 则让工作因子可以渐进升级:不需要一次性重置全站密码。

反账号枚举:让错误长得一样

登录时「账号不存在」和「密码错误」返回完全相同的错误码与文案,密码重置入口在账号不存在时静默成功,校验阶段与「验证码错误」返回同一错误。

return ErrInvalidCredentials.WithMessagef("账号或密码错误,还可尝试 %d 次", remaining)
入口 对外表现 防的是什么
登录 不存在 / 密码错 → 同一 code + 同一文案 脚本批量探测哪些账号存在
重置密码 账号不存在也返回「已发送」 用重置接口枚举注册用户
审计 内部仍区分真实原因 排查时不能只剩一句「失败」

这是显式取舍:防的是自动化探测,代价是用户自己也分不清「没注册」和「打错密码」。计时侧信道同样不可能完全消除,能做的是把差异压到不足以支撑批量判断。

双维度限流:只按一边都会被绕开

登录限流的两个维度必须同时存在:

const (
    DimensionAccount = "account" // 防针对单一账号的爆破
    DimensionIP      = "ip"      // 防同一 IP 撞库大量账号
)

pipe := cache.Pipeline()
incr := pipe.Incr(ctx, failureKey)
pipe.Expire(ctx, failureKey, window)   // 每次失败都续期 → 滑动窗口
if _, err := pipe.Exec(ctx); err != nil { return 0, false, err }

只按账号限流,攻击者用 1 个 IP 对 10 万个账号各错 1 次,永远不触发;只按 IP 限流,代理池轮换 IP 就能对单个账号无限尝试。计数与过期时间用 Pipeline 一次往返完成,避免两次 RTT 之间进程崩溃留下一个永不过期的键。

一组常见的默认参数:

参数 常见默认 含义
失败次数阈值 5 窗口内触发锁定的次数
滑动窗口长度 15m 计数窗口
锁定时长 15m 触发后的冻结时间
工作因子 12 密码哈希成本
密码最大字节数 72 bcrypt 输入上限

还有个容易漏的细节:账号维度的键要先归一化(去空格 + 转小写),并且统一按用户名或邮箱主键归一,否则大小写变形、或在用户名 / 邮箱 / 手机号之间切换,都能把计数打散。

缓存不可用时要说清降到了哪里

登录失败是高频写,落库会成为攻击者的放大器;多实例部署又要求计数共享,所以计数放 Redis 这类共享缓存。但缓存应该允许显式关闭,此时降级行为要写清楚:

  • 账号维度退化为数据库字段(失败次数 / 锁定截止时间),能力仍在;
  • IP 维度无法限流,记录 WARN —— 不假装它还在工作;
  • access token 黑名单整体失效,已吊销令牌只能等自然过期(默认 15 分钟)。

区别在于「显式关闭」与「配了却连不上」:后者是环境故障,启动时 fail-fast 直接失败,而不是静默降级让安全能力无声失效。健康检查里也应显式标出「缓存已关闭」,方便确认当前跑在哪一档。

出参与日志的边界

安全规则集中在密码模块与认证服务层,接口层只负责翻译错误码。几条必须守住的线:

  • 响应体不出现密码、哈希、完整令牌;统一错误响应把内部细节只写进服务端日志;
  • 访问日志不记录请求体(密码就在里面),日志脱敏覆盖手机号与令牌;
  • 联系方式在服务层脱敏:本人完整,他人 a***[email protected] / 138****0000;
  • 敏感动作(登录失败、锁定、改密、令牌重放)写审计表,只追加不修改。

审计写入失败只记 ERROR、绝不影响主流程 —— 登录不能因为审计表抖动就失败。但这条取舍必须写在注释里,否则后来人会以为漏了错误处理。

固定测试覆盖超长输入、弱口令黑名单、无效哈希、账号不存在、限流边界与缓存关闭分支,比在上线后靠日志发现要便宜得多。