小蓝书 Go
系统架构

安全与会话:哪些输入可信

前一站:迁移清单 · 接着读:认证源码

身份来自签名和数据库#

前端能解码 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?减少向无权限者暴露对象是否存在的信息。

— 本篇阅读完毕 —
来源:小蓝书 Go / docs / 02-architecture/security.md 下载原文
输入关键词,在三个知识库中搜索
支持正文检索 · 直接定位章节Esc 关闭