先读类型#
auth.go ↗ 的 LoginInput 包含 phone、code、password、type、username。一个类型兼容普通验证码/密码和管理员表单,实际方法先验证登录方式。Claims 额外保存 uid/admin,并嵌入标准 issuer、audience、sub、jti、iat、exp。
type=1 才执行验证码登录;type=2 执行密码登录;其他值400。管理员单独入口调用 adminLogin,数据库还要求 role=admin。普通手机号格式为 1 加10位数字,不能拿内部 admin:... 标识走普通登录。
SendCode 分四步看#
先检查手机号,crypto/rand 取 [0,1000000) 整数并补足六位。codeHash 用 JWTSecret 做 HMAC-SHA256,摘要绑定 phone 和 code。数据库 UPSERT 只在 sent_at 距今至少60秒时更新,否则 RowsAffected=0 返回429。
开发环境明确记录并返回本地教学验证码。生产构造 {phone,code},发送到配置的 HTTPS webhook,携带 bearer 适配器 token,8秒超时且禁止自动重定向,避免凭证被带去陌生地址。上游失败后删除“相同 phone 且相同 digest”的记录;必须带 digest 条件,否则迟到的失败可能删掉下一次新验证码。
验证码登录为何用事务#
Login 开始事务,在同一连接中读取摘要、过期和尝试次数,验证成功后删除验证码;接着查询用户,不存在则创建;最后插入 session 并签 token,然后提交。这样两次相同验证码并发登录不会都成功消费。
失败尝试要真正保存次数,所以错误分支 UPDATE attempts 后会 Commit 再返回业务错误。若一看到验证码错误就直接 return,defer Rollback 会把 attempts 回滚,攻击者就能无限试。这是阅读事务控制流时最值得停下来思考的一处。
密码登录与建立 token#
密码登录读取 password_hash,用 bcrypt.CompareHashAndPassword 验证。用户从未设置密码时哈希为空,比较失败,必须先用验证码。被黑名单/删除账号在发会话之前被拒绝。
issueToken 用 crypto/rand 生成 session ID,有效期5天,签 HS256,然后把 (jti,user_id,expires_at) 写进 sessions。签名成功但数据库事务失败时不会返回 token;客户端只在提交成功后拿到有效凭证。方法同时清理过期 session。
Authenticate 的双重条件#
验 JWT 的算法、issuer、audience、exp 后,数据库必须存在匹配 jti/uid 的有效 session,用户正常且未删。角色取 users.role,不因为 token 里写 admin=true 就直接授予权限。这个数据库读取让每次请求增加一次成本,换来立即退出和停用会话的能力。
如果未来改成纯无状态 JWT,可以降低查询,但退出和封禁就需要撤销机制或等待过期。不能保留“立刻失效”的产品承诺却删除会话检查。
更新密码和生命周期#
ChangePassword 先限制8~72字节,bcrypt 在事务之前计算,避免持锁期间做昂贵哈希。事务内更新哈希、删其他 session;当前 jti 保留。Logout 只删当前 jti。ModerateUser 在更新状态时删除所有 session 并记 audit_log。
练习:分别解释“用户改密码”“管理员拉黑”“用户点退出”会删哪些 sessions;运行 AuthRevocation 和 CodeReplay 测试验证你的结论。