认证服务的纵深防御:中间件、Cookie 与审计
中间件顺序即安全边界
RequestID → AccessLog → Recovery → CORS → Audit → [RateLimit] → [Auth] → [RBAC] → handler
每层只做一类工作,顺序不是随便排的:链路 ID 必须最先生成,日志与审计才能串起来;Recovery 要在任何业务中间件之前兜住 panic;鉴权必须晚于 CORS,否则跨域预检会被 401 挡掉。
| 中间件 | 关键取舍 |
|---|---|
RequestID |
只接受合法 UUID,避免把注入内容写进日志 |
AccessLog |
健康检查不记录;4xx 不触发告警,避免把探测流量当故障 |
Recovery |
堆栈只进日志;客户端断连记 WARN 而不返回 500 |
RateLimit |
按「已登录用户 / 未登录 IP」计数;缓存异常时放行并记 WARN |
Auth |
校验按成本从低到高排 |
RBAC |
角色快照 vs 即时权限,两种粒度分开 |
Audit |
按路由声明写接口级审计,与业务层审计不重复 |
错误响应只暴露业务错误码,内部细节留在受控日志;日志记路径、状态、耗时、链路 ID,不记请求体(密码就在里面)、不记完整令牌与验证码。
CORS 不是身份认证
这是最常被混为一谈的两件事:CORS 是浏览器的跨域读取策略,既不是身份认证,也不是服务器端授权。
- 允许来源精确枚举,凭证模式下禁止
*(refresh token 走 Cookie,请求带凭证); - 支持
https://*.example.com这种单层子域通配,只允许最左侧完整标签位,不做任意后缀匹配; - 可信代理白名单之外的
X-Forwarded-For一律不采信,否则客户端可以伪造 IP 绕过登录限流。
应该写一条断言覆盖「相似域名攻击」:
https://example.com.evil.test不能被*.example.com的通配规则命中。这类缺陷肉眼很难看出来,必须写成断言。
Cookie 与 CSRF:HttpOnly 不等于防伪造
浏览器会自动附带 Cookie,所以 HttpOnly 只能降低脚本读取凭证的风险,挡不住跨站请求伪造。常见的组合是:
cookie:
name: refresh_token
domain: .example.com # 前导点 = 包含全部子域;本地 localhost 必须留空
path: /auth # 收窄路径,其它接口不会顺带携带
same_site: lax # 跨站 POST 不携带 Cookie
secure: true # 生产强制
access token 走 Authorization 头(不自动附带),refresh 走 HttpOnly Cookie,写操作再叠加 Origin 校验 + 双提交;缺少来源信息时明确策略,而不是默认放行。前端刷新只需一次带凭证的 POST,JS 根本读不到 Cookie 内容。
顺带一个 Windows 上的坑:Go 输出 UTF-8 而中文终端默认代码页 936,日志中文乱码要
chcp 65001;用空字符串关闭某个环境变量时,某些 shell 会把它当成「删除变量」,改用一个显式的关闭值更稳。
Auth 按成本从低到高
Bearer 解析 → RS256 验签(本地公钥,零网络)
→ jti / 令牌族黑名单(一次缓存 EXISTS)
→ 密码版本号比对 → 注入身份
把便宜的、纯本地的检查放在前面,能在恶意流量打进来时少碰下游。缓存故障时黑名单放行(可用性优先)并记 WARN,这是明确的取舍:不能因为缓存抖动就让全站 401,但要让运维知道此刻撤销能力是降级的。
RBAC 的两种粒度
| 方式 | 数据来源 | 适用 | 代价 |
|---|---|---|---|
| 按角色校验 | 令牌里的 roles,零查询 |
低风险路由、菜单渲染 | 权限变更有滞后 |
| 按权限校验 | 查库,授权即时生效 | 敏感操作 | 每请求一次查询 |
超管角色走旁路,避免新库还没有权限数据时把管理员自己锁在外面。别把两者混成一条规则:用令牌快照去做敏感授权,撤销会一直滞后到令牌过期。
审计与每条降级路径
审计回答「谁在何时对什么做了什么、结果如何」,与普通访问日志分开,记录登录失败、令牌重放、改密、授权变更等事件,只追加不修改,不保存可复用的秘密。
一个真实踩过的取值坑:结果过滤是 1=成功、2=失败,不是直觉上的 0/1;枚举取值要和模型定义核对,传 0 不会报错,只会查出空结果。
最后把每条降级路径写明理由:限流放行优先可用性但必须告警;黑名单放行同样优先可用性;而一次性登录票据、关键身份校验在缓存不可用时拒绝请求。不写下来的降级,迟早会被后来的人当成 bug「修好」。