# 登录与权限源码：从验证码到可撤销会话

前置：[安全边界](../02-architecture/security.md) · 接着读：[笔记与搜索](notes-search.md)

## 先读类型

[auth.go](../../internal/service/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 测试验证你的结论。
