鉴权体系 的十种打开方式:工程实践笔记
前阵子把一套老系统的鉴权从“能登录就行”往“能维护”上收,结果越收越发现,鉴权这玩意儿不是选个框架就完事。同一个问题,放在单体、网关、服务网格里,答案都不一样。下面这十种,是我这几年真写过、踩过、又爬出来的打开方式,顺序不代表先进程度,只代表我脑子里翻出来的顺序。
1. Session + Cookie:老派,但先把 SameSite 配明白
Session 方案最大的好处是心智负担低,登录态在服务端,想踢人踢人,想加权限加权限。坑一般在 Cookie 属性上:HttpOnly、Secure、SameSite 少一个都可能在某个浏览器里翻车。跨站场景用 SameSite=None 就必须带 Secure,不然浏览器直接不认。CSRF 也别省,别以为用了 JSON 就没事。
Set-Cookie: SESSION=xxxx; HttpOnly; Secure; SameSite=Lax; Path=/
如果 Session 放 Redis,记得加前缀和 TTL,别让测试环境的 key 和生产混在一起。
2. JWT:无状态不等于无脑
JWT 适合做短期的身份凭证,但别把一堆权限全塞进去,最后 token 比请求体还大。验签只是第一步,exp、iss、aud 都得验,算法也要固定死,别让 alg:none 或者 HS/RS 混淆钻空子。吊销是 JWT 的老大难,实际做法一般是短过期 + refresh token,再加一个用户级版本号或黑名单。下面这种写法比只验签名靠谱:
jwt.verify(token, publicKey, {
algorithms: ['RS256'],
issuer: 'https://auth.example.com',
audience: 'api'
})
密钥别硬编码,轮换的时候留一个旧 key 的过渡期,不然半夜全站 401。
3. OAuth2 / OIDC:登录外包出去,回调地址别放飞
接第三方登录或者公司统一身份,OIDC 基本是标配。授权码模式加 PKCE,前端别存 client_secret,state 和 nonce 该用就用。回调地址白名单要严格,别搞正则 .*,不然哪天被拿去当跳板都不知道。还有一个坑:OIDC 的 userinfo 和 ID Token 里的信息可能不一致,别两处混着用。
4. API Key:简单可以,别把 key 放 URL
服务对服务、脚本调用,API Key 确实省事。但 key 放 query string 里,日志、浏览器历史、代理都会帮你记下来。放 Header 里:
Authorization: Api-Key xxxx
服务端存哈希,别存明文;按 key 做限流和审计;支持轮换,最好能同时存在新旧两个 key 一段时间。测试环境和生产环境的 key 别用同一个,别问我怎么知道的。
5. HMAC 签名:开放平台和回调的保命符
支付回调、开放平台这类场景,光有 token 不够,还得防篡改和重放。常用做法是把 method、path、timestamp、nonce、body hash 拼成规范串再签名。坑在于 body 只能读一次,框架里记得缓存原始 body,别签完名后面拿不到了。时间戳窗口别放太大,nonce 要能去重。签名串大概长这样:
POST\n/api/callback\n1710000000\nabc123\nsha256(body)
验签失败就统一返回 401,别把失败原因写太细。
6. mTLS:内部服务不是“内网就安全”
内部服务之间上 mTLS,比共享密钥靠谱,但证书轮换和 SAN 校验要处理好。别为了图省事把 verify 关掉,那基本等于没做。调试的时候可以用:
openssl s_client -connect svc:8443 -cert client.pem -key client-key.pem -CAfile ca.pem
证书过期这事一定要有监控,最好提前一个月报警。还有,mTLS 只解决“连接双方是谁”,权限模型还得单独做。
7. RBAC / ABAC:角色别爆炸,权限要能解释
RBAC 起步快,但角色一多就变成“角色爆炸”,最后没人知道某个角色到底能干啥。资源级权限可以往 ABAC 或者策略引擎上收,至少做到“谁能对哪个资源做什么”能解释清楚。缓存权限结果的时候注意失效,尤其是给用户加角色之后。默认拒绝,显式允许,别反过来。
8. 网关统一鉴权:拦截做在入口,身份头别让外部带进来
网关统一做鉴权能省掉一堆重复代码。Nginx 的 auth_request 就够用:
location /api/ {
auth_request /_auth;
auth_request_set $user $upstream_http_x_user;
proxy_set_header X-User $user;
}
坑是:外部请求如果自己带了 X-User,你得在入口先清掉,再透传网关注入的头;内网请求也不能默认全信。鉴权子请求的超时要配,不然上游一抖,全站跟着卡。
9. 服务间鉴权:别用一套共享密钥跑全公司
服务间调用要么用 client credentials 拿短 token,要么上 SPIFFE/服务网格做身份。共享密钥的坏处是一处泄漏、处处失守,轮换还特别痛苦。token 里加 audience,别让 A 服务的 token 能直接调 B 服务。重试的时候注意幂等,别鉴权失败也猛重试,把认证服务打挂。
10. 临时凭证 / STS:能发短的就别发长的
对象存储上传、云 API 调用、数据库临时访问,能用 STS 就别发长期 AK。按需申请、最小权限、短 TTL,再配合审计日志。前端上传用预签名 URL,别把长期密钥塞到客户端。STS token 也有过期时间,别把它缓存到连接池里然后第二天全报错。该刷新就刷新,失败路径想清楚,比事后查日志强。
评论
还没有评论。
发表评论
提交后评论将经过自动审核,审核通过后公开展示。