差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
| jwt [2026/10/12 16:06] – 补充 HttpOnly Cookie 与 JWT 搭配方式、整体设计清单与参数基线 张叶安 | jwt [2026/10/12 17:17] (当前版本) – 把未生效的 %%credentials%% 改为等宽标记(方案 A) 张叶安 | ||
|---|---|---|---|
| 行 118: | 行 118: | ||
| - 前端**完全不用碰令牌**,刷新页面也不掉登录态 | - 前端**完全不用碰令牌**,刷新页面也不掉登录态 | ||
| - 代价:天然存在 CSRF 面,必须配 SameSite + CSRF token + Origin 校验 | - 代价:天然存在 CSRF 面,必须配 SameSite + CSRF token + Origin 校验 | ||
| - | - 跨域前后端分离时更麻烦:需要 | + | - 跨域前后端分离时更麻烦:需要 |
| **方案 B:refresh 放 HttpOnly Cookie,access 放内存(SPA 主流做法)** | **方案 B:refresh 放 HttpOnly Cookie,access 放内存(SPA 主流做法)** | ||
| 行 195: | 行 195: | ||
| ==== 六、传输、跨域与网关 ==== | ==== 六、传输、跨域与网关 ==== | ||
| - | | + | - 全程 HTTPS;Cookie 一律带 '' |
| - | - 在网关 / 边缘统一验签,内部服务复用身份;不要让每个微服务各实现一遍 | + | - 在网关 / 边缘统一验签,内部服务复用身份;不要让每个微服务各实现一遍 |
| - | - 跨域时前端要带凭据(%%credentials: | + | - 跨域时前端要带凭据('' |
| - | - 令牌**不要放 URL query**:会进浏览器历史、Referer 和服务器日志 | + | - 令牌**不要放 URL query**:会进浏览器历史、Referer 和服务器日志 |
| ==== 七、常见攻击与对策对照 ==== | ==== 七、常见攻击与对策对照 ==== | ||
| 行 233: | 行 233: | ||
| 一张图回顾全篇(可缩放、拖拽、点击折叠): | 一张图回顾全篇(可缩放、拖拽、点击折叠): | ||
| - | ```mdk height=460 color=# | + | ```mdk height=560 color=# |
| # JWT 鉴权 | # JWT 鉴权 | ||
| ## 是什么 | ## 是什么 | ||
| 行 241: | 行 241: | ||
| ## 三段结构 | ## 三段结构 | ||
| - Header 算法与类型 | - Header 算法与类型 | ||
| - | - Payload 声明 claims | + | - Payload 声明 claims(明文) |
| - | - Signature 签名 | + | - Signature 签名(不可伪造) |
| ## 鉴权流程 | ## 鉴权流程 | ||
| - 登录校验通过 | - 登录校验通过 | ||
| 行 249: | 行 249: | ||
| - 服务端验签 + 查过期 | - 服务端验签 + 查过期 | ||
| ## 对比 Session | ## 对比 Session | ||
| - | - 无状态 vs 服务端存储 | + | - 无状态 vs 服务端存状态 |
| - 易扩展 vs 易失效 | - 易扩展 vs 易失效 | ||
| - | - 载荷大 vs 只传 | + | - 载荷大 vs 只传 |
| ## 典型用途 | ## 典型用途 | ||
| - API 鉴权 Bearer | - API 鉴权 Bearer | ||
| - 单点登录 SSO | - 单点登录 SSO | ||
| - 一次性票据 | - 一次性票据 | ||
| - | ## 安全要点 | + | - 信息交换 |
| - | - 拒绝 | + | ## 令牌存哪 |
| - | - 设置 | + | - localStorage:最方便、泄露面最大 |
| - | - 不放敏感数据 | + | - 内存变量:刷新即丢,适合 access |
| - | - 撤销需黑名单 | + | - Cookie:自动携带,服务端控制力最强 |
| - | - 密钥妥善保管 | + | - HttpOnly 防偷读,不防盗用 |
| + | ## Cookie 属性 | ||
| + | - HttpOnly + Secure | ||
| + | - SameSite Strict / Lax / None | ||
| + | - Domain / Path / Max-Age | ||
| + | - __Host- 前缀 | ||
| + | ## 两种搭配方案 | ||
| + | - 方案 A:access 与 refresh 都放 Cookie,简单但须防 CSRF | ||
| + | - 方案 B:refresh 放 Cookie + access 放内存,业务请求免疫 CSRF | ||
| + | - refresh 一律只放 HttpOnly Cookie | ||
| + | ## 设计清单 | ||
| + | - claims:iss / sub / aud / exp / jti,最小必要 | ||
| + | - access 5~15 分钟,refresh 7~30 天 | ||
| + | - 刷新即轮换 + 令牌族 | ||
| + | - 单服务 HS256,多服务 RS256 + JWKS | ||
| + | - 固定算法白名单,拒绝 none | ||
| + | - 撤销:黑名单 / 版本号 / 会话表 | ||
| + | - 校验顺序:来源 → alg → 验签 → exp → iss/aud | ||
| + | - 网关统一验签,令牌不放 | ||
| + | ## 常见攻击 | ||
| + | - XSS 窃取 → HttpOnly + CSP + 输出转义 | ||
| + | - CSRF → SameSite + CSRF token + Origin 校验 | ||
| + | - 算法混淆 → 固定算法白名单 | ||
| + | - kid 注入 → 服务端白名单键表 | ||
| + | - 重放 / 日志泄露 → 短 exp + 脱敏 | ||
| + | ## 参数基线 | ||
| + | - access 15 分钟,refresh 14 天 | ||
| + | - HMAC ≥ 32 字节,RSA ≥ 2048 位 | ||
| + | - 时钟容差 30~60 秒 | ||
| + | - 令牌来源二选一,别混用 | ||
| ``` | ``` | ||