# 安全与会话：哪些输入可信

前一站：[迁移清单](migration.md) · 接着读：[认证源码](../03-development/auth.md)

## 身份来自签名和数据库

前端能解码 JWT 读取 admin 字段，用于安排页面，但解码不等于验证。Go 固定 HS256、issuer、audience，强制检查 exp，再使用 jti/userId 查询 sessions 与 users。数据库角色才决定 Actor.Admin。伪造 body.userId、修改 token 中 admin=true 或修改 localStorage 都不会赋予管理权限。

退出删除当前 session；改密码删除同人其他 session；黑名单/软删除删除所有 session。重新启用账号只恢复状态，不恢复旧会话。开发密钥放在 data/.jwt-secret，生产必须提供至少 32 字节随机 JWT_SECRET，不能把默认字符串提交到代码。

## 验证码与密码

六位码使用 crypto/rand 生成，不是可预测的数学随机。数据库存基于服务密钥的 HMAC 摘要；五分钟有效，每号码 60 秒发送间隔，最多五次错误；成功使用后删除，不能重放。开发环境返回 debugCode 并写终端，生产只调用 HTTPS 短信 webhook、不回传也不记录验证码。

密码只存 bcrypt 哈希，更新限制 8～72 字节。bcrypt 的 72 字节限制按编码后的字节而非汉字个数。服务启动校验管理员哈希格式；首次建管理员后普通重启不会用环境默认密码覆盖已有哈希。生产设置初始管理员哈希应在空库初始化前完成。

## 对象级权限

修改/删除/私密/置顶笔记只允许作者。评论可由评论作者、笔记作者或管理员删除。关注禁止自己关注自己，目标必须是正常普通用户。写入前检查对象存在、未软删、作者可用与可见性。匿名不能点赞，但可以读正常公开内容。

私密笔记仅作者读取，评论和回复接口重复检查所属笔记，防止绕过详情直接访问评论。被停用用户的内容从公开列表和相关计数中隐藏。管理员统计中的“已删除用户”有独立字段，不能把它当正常用户总数显示。

## 输入与输出

SQL 占位符防注入；搜索转义 LIKE 通配符；排序列只从枚举选择，不拼用户输入。ID 限制在 JavaScript 安全整数。文字长度使用 rune，枚举类型检查；错误返回业务说明，服务器日志记录内部错误。前端以 JSX 文本展示标题和昵称，不插入不可信 HTML。

文件名用 24 字节随机值生成，不使用用户提交的路径。读取前 512 字节判断 MIME，只允许 JPEG/PNG/WebP/GIF/MP4，头像不能是视频，不接受 SVG/HTML。文件大小受限，临时 multipart 文件在请求结束清理。当前只做内容类型识别，不是完整恶意软件扫描、解码重编码或视频转码系统。

## 当前明确的限制

浏览器 token 放 localStorage，仍需防御同源 XSS；生产使用 HTTPS 并严格管理第三方脚本。当前不实现 HttpOnly Cookie + CSRF 双重协议。上传 URL 为公开随机地址，私密笔记权限不等于私密媒体授权。限流在单进程内，远端 IP 来自 RemoteAddr，不信任任意 X-Forwarded-For；反向代理部署时多个访客可能共享代理配额，需有明确可信代理设计再扩展。

本项目没有实现运营级内容审核、举报处置、病毒扫描、短信供应商账户管理、验证码人机验证和账户恢复平台。公网部署前应按目标产品补齐，而不是因为本地测试通过就假定具备这些能力。

验收：用普通用户 token 请求管理员接口应 403；退出后用旧 token 应 401；B 请求 A 的私密笔记和评论应 404。为什么用 404？减少向无权限者暴露对象是否存在的信息。
