← 返回笔记列表

双令牌与 RS256:在本地验签和撤销能力间取平衡

发布于 来自 半盏灯 最近更新

  • Go
  • JWT
  • RS256
  • 认证

为什么是 RS256 而不是 HS256

HS256 是对称密钥:验签方必须持有和签发方相同的密钥。放到多业务站的场景里,任何一个业务站被攻破,攻击者就能伪造全站通行证。

RS256 下认证中心独占私钥,业务站只拿公钥(通过 JWKS 端点暴露)本地验签,公钥泄漏也无从伪造令牌。这是选型时最该先写清楚的一条。

const Algorithm = "RS256"
const (
    TokenTypeAccess  TokenType = "access"
    TokenTypeRefresh TokenType = "refresh"
)

必须显式限定算法:解析时用 WithValidMethods([]string{"RS256"}) 并校验签名方法类型,否则攻击者把 header 的 alg 改成 none 或 HS256、拿公钥当 HMAC 密钥,就能构造出「合法」签名。

载荷里每个声明都有用途

type Claims struct {
    TokenType       TokenType `json:"typ"`             // access / refresh
    Roles           []string  `json:"roles,omitempty"`
    Scopes          []string  `json:"scope,omitempty"`
    AppID           string    `json:"app_id,omitempty"`
    PasswordVersion int64     `json:"ver,omitempty"`    // 改密即踢下线
    FamilyID        string    `json:"fam,omitempty"`    // 整族吊销
    RegisteredClaims                                   // iss/sub/aud/exp/iat/jti
}
声明 作用 不校验会怎样
typ 区分 access / refresh 长效 refresh 被当成 access 直接调业务接口
iss / aud 签发者与受众 别的系统签发的令牌被本站接受
exp 必须存在 缺 exp 的令牌永久有效
jti 唯一标识 无法主动吊销、无法做重放检测
ver 密码版本号 改密后旧令牌还能用
fam 令牌族 只能逐个吊销,漏掉同族其它 access token
kid 公钥指纹 密钥轮换时全站 401

WithExpirationRequired() 让缺 exp 的令牌直接被拒;时钟偏差容忍 30 秒,覆盖多实例之间的机器时间漂移。

业务站验签的五条硬约束

_, err := ParseWithClaims(tokenString, claims,
    func(t *Token) (any, error) { return keyFor(ctx, kid) },
    WithValidMethods([]string{"RS256"}),  // 防算法混淆
    WithIssuer(issuer),
    WithAudience(audience),
    WithLeeway(30*time.Second),
)
if claims.Typ != "access" { return nil, fmt.Errorf("令牌类型错误") }

各语言验签实现的共同点只有五条:限定 RS256、校验 iss 与 aud、校验 typ、按 kid 取公钥、容忍 30 秒漂移。少任何一条都有对应攻击手法,而且这类缺陷在功能测试里全绿,只在线上被利用。

密钥轮换:先发公钥,再换私钥

JWT 头带 kid,JWKS 响应带 Cache-Control: public, max-age=3600。业务站启动时预热一次公钥,遇到未知 kid 时强制刷新一次再判定失败 —— 否则一次正常的密钥轮换会让所有业务站集体 401。

openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out private.pem
openssl rsa -in private.pem -pubout -out public.pem

轮换时先发布新公钥、再切换签名私钥,并保留旧公钥直到其签发的令牌全部过期。启动时还应校验公私钥是否配对,不匹配直接拒绝启动(部署事故比运行时 401 好排查)。切忌在启动时自动生成密钥:那等于每次发布都换密钥,也就是每次发布全站登出。

公钥不要写死在代码里:轮换时那份常量会成为最难找的故障源。JWKS 端点短暂不可用时,应继续使用已缓存的公钥,而不是让业务跟着一起挂。

本地验签省下的调用,要用撤销能力还回去

常见配置是 access 15 分钟、refresh 7 天,且要保证 refresh 的有效期大于 access。access token 短有效期本身是第一道撤销机制;需要「立刻下线」时再叠加:

手段 覆盖范围 代价
短 access 有效期 所有令牌 刷新更频繁
jti 黑名单 单个 access token 每个请求一次缓存查询
令牌族黑名单 同族全部 access token 多键 EXISTS 合并为一次往返
密码版本号 该用户全部令牌 需要比对数据库当前值

角色声明也不宜无限膨胀,且要接受「权限变更后短时间内仍是旧快照」这个事实;真正敏感的操作走查库取即时权限,而不是信令牌里的 roles。

检查清单:拒绝 alg=none 与非预期算法、严格校验 iss / aud / exp / typ、私钥不进镜像与日志、令牌不出现在 URL 里。把密钥轮换、时钟偏差和撤销语义当作接口设计的一部分,而不是上线后的补丁。