什么是 JWT?结构、签名与安全使用
三个用点分隔的 base64url 片段——头部、载荷与签名。了解每一部分证明了什么、没证明什么,以及会把 JWT 变成安全漏洞的五个错误。
你将学到什么
- 读懂 JWT,说出它的三个部分
- 解释签名能证明什么——以及不能证明什么
- 正确使用标准声明(exp、iss、aud、sub)
- 判断什么时候 JWT 胜过服务器端会话(以及什么时候不如)
- 避开五种经典的 JWT 安全错误
- 什么是 JWT
- 结构解析:三个部分
- 签名与验证如何工作
- 标准声明
- 什么时候用 JWT——什么时候不用
- 常见错误
- 试一试:JWT 解码器
- 常见问题
什么是 JWT
A JSON Web Token(JWT) 是一种在两方之间传递已签名声明的紧凑、URL 安全的方式。它长这样:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IlZhbGV2IiwiYWRtaW4iOnRydWUsImlhdCI6MTUxNjIzOTAyMn0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
三段内容,用点分隔: header.payload.signature。服务器在你登录后创建一个发给你,之后你每次请求都要把它带回去——通常放在 Authorization: Bearer <token> 请求头里。服务器验证签名后就信任里面的声明,无需查数据库。这种“无需查询”的特性正是 JWT 的全部意义——同时我们也会看到,它也是主要的弱点。
结构解析:三个部分
每个部分都是 经 Base64URL 编码的 JSON (Base64 的变体,其中 +// 被替换为 -/_ ,且去掉了填充,所以它能在 URL 中完好使用)。把上面的例子解码后,你会得到:
// Header — how the token is signed
{ "alg": "HS256", "typ": "JWT" }
// Payload — the claims (statements about the user)
{ "sub": "1234567890", "name": "Valev", "admin": true, "iat": 1516239022 }
// Signature — HMAC-SHA256 over header.payload, with a secret key| 部分 | 内容 | 保密吗? |
|---|---|---|
| 头部 | 签名算法(alg)和类型(typ) | 不是——任何人都能读 |
| 负载 | 声明:你是谁、你能做什么、何时过期 | 不是——任何人都能读 |
| 签名 | 头部 + 负载的哈希,用密钥加签 | 是——只有签发者才能生成 |
签名与验证如何工作
要生成签名,签发者取 base64url(header) + "." + base64url(payload) 并对它签名:
HMAC-SHA256(secret, header + "." + payload) // HS256: shared secret RS256: sign with a private key, verify with a public key
验证是同样的计算反过来做:服务器用自己的密钥对收到的头部和负载重新计算签名,再比对。如果负载中哪怕一个字符被改过——比如把 "admin": false 改成 true ——签名就对不上了,令牌会被拒绝。
有两类算法值得了解。 对称式(HS256):用同一个共享密钥签名和验证——简单,但拿到密钥的人都能伪造令牌,所以只有签发者能持有它。 非对称式(RS256/ES256):私钥签名,公钥验证——验证者可以是另一个服务,这就是“用 Google 登录”这类联合登录的工作方式。
标准声明
| 声明 | 含义 | 为什么重要 |
|---|---|---|
iss | 签发者——谁创建了这个令牌 | 拒绝陌生人签发的令牌 |
sub | 主题——这是谁的令牌(用户 ID) | 应用据此行事的身份 |
aud | 受众——令牌是给哪个服务的 | 防止一个应用的令牌被拿到另一个应用里用 |
exp | 过期时间——此后令牌失效的 Unix 时间 | 限制令牌被盗后的损失 |
iat | 签发时间 | 发现密码修改之前签发的令牌 |
nbf | 生效时间 | 之后才生效的令牌 |
除此之外,应用还会添加自己的声明——角色、权限、显示名称。请保持负载小巧:令牌每次请求都会发送,所以一个 5 KB 的令牌就是每次调用都要交的税。
什么时候用 JWT——什么时候不用
当验证必须在不查询数据库的情况下完成,或者跨越不共享会话存储的服务时,JWT 就大放异彩:API、微服务和单点登录。验证者只需要密钥。
它在一个重要方面会输: 你没法轻易撤销它。 服务器端会话可以在用户登出或修改密码的瞬间删除;JWT 在过期之前一直有效,因为没有什么东西可删。标准的缓解措施是设置很短的过期时间(按分钟算,而不是按天),再加上刷新令牌——一种只发给登录端点、用来换取新的短期 JWT 的长期令牌——或者用撤销列表,但那又悄悄把 JWT 本想避免的数据库查询带回来了。
经验法则:如果你只有一个应用和一个数据库,经典的会话 cookie 更简单、更安全。当你有多个服务,或者令牌必须跨越信任边界时,再用 JWT。
常见错误
- 信任客户端解码出的令牌。 解码什么都证明不了——只有签名验证才算数。解码出的负载里的
admin: true只是一项声明,不是事实——只有签名验证通过后才算数。 - 接受
alg: none. 未签名的令牌必须拒绝。至今仍接受它的库,是 JWT 历史上最古老的漏洞——而且现在还会出现。 - 密钥太弱或已泄露。 用 HS256 加上密钥
secret几秒钟就能伪造。请使用足够长、随机的密钥,定期轮换,绝不要把它提交进代码库。 - 没有过期时间(
exp). )。被盗的令牌就永远有效。请设置一个较短的exp,并使用刷新令牌。 - 把密钥放进负载里。 Base64URL 不是加密——任何人都能读。见上面的提示框。
- 把令牌存在 localStorage 里。 任何跨站脚本(XSS)漏洞都能让攻击者读到它。HttpOnly cookie 是浏览器令牌更安全的存放处。
试一试:JWT 解码器
把一个令牌粘贴到 JWT 解码器里,看它拆分成头部、负载和人类可读的日期——这是最快理解本指南所讲结构的方法。
继续学习
常见问题
JWT 是加密过的吗?
不是。标准的 JWT(JWS)是签名的,不是加密的——负载是 Base64URL,任何人都能解码。加密是另一种独立的格式 JWE,用于内容本身必须保密的场景。
用户登出时,我如何撤销 JWT?
你没法直接删除它——它在 exp 到期之前一直有效。实际可行的办法是:短期过期加刷新令牌,或者在服务器端维护一个已撤销令牌 ID(jti 声明)的黑名单,在敏感接口上检查。
JWT 和会话 cookie——我该选哪个?
单个应用加数据库,选会话 cookie:更简单、可即时撤销。API 和微服务,验证者无法共享会话存储,或者令牌要跨越服务边界时,选 JWT。很多系统两者都用:浏览器用会话,服务间调用用 JWT。
JWT 在浏览器里应该存在哪里?
存在 HttpOnly、Secure、SameSite 的 cookie 里——JavaScript 读不到它,所以 XSS 偷不走。localStorage 很方便,但页面上的任何脚本都能读,包括被注入的脚本。
没有密钥能解码 JWT 吗?
可以——解码头部和负载完全不需要密钥;只有验证签名才需要。这就是为什么 JWT 解码器工具能立刻显示令牌内容,也是为什么你绝不能把密钥放进负载里。