差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 | 前一修订版 | ||
| 代码术语:bearer [2026/10/13 22:45] – 新建 Bearer(持有者令牌)术语页 张叶安 | 代码术语:bearer [2026/10/13 22:45] (当前版本) – 补充本页思维导图 张叶安 | ||
|---|---|---|---|
| 行 38: | 行 38: | ||
| </ | </ | ||
| - | 注意:''' | + | 注意:**OAuth2 的 '' |
| ===== 三、三种传递方式 ===== | ===== 三、三种传递方式 ===== | ||
| 行 215: | 行 215: | ||
| 返回:[[代码术语]] | 返回:[[代码术语]] | ||
| + | |||
| + | ```mdk height=560 color=# | ||
| + | # Bearer 持有者令牌 | ||
| + | ## 字面含义 | ||
| + | - bearer = 持票人 | ||
| + | - 不记名凭证:谁拿来谁能用 | ||
| + | - 令牌本身就是全部证明 | ||
| + | - 推论:必须 HTTPS、寿命短、可撤销 | ||
| + | ## 两个语境 | ||
| + | - HTTP scheme:Authorization: | ||
| + | - OAuth2 token_type: " | ||
| + | - 方案名大小写不敏感 | ||
| + | ## 三种传递方式 | ||
| + | - 请求头(推荐) | ||
| + | - 表单体:只允许 POST | ||
| + | - URL 查询参数:不建议使用 | ||
| + | - 同一请求只能用一种 | ||
| + | - 令牌语法 token68,不含空白字符 | ||
| + | ## 错误语义 | ||
| + | - 没带凭证 → 401,不带 error | ||
| + | - 无效或过期 → 401 invalid_token | ||
| + | - 用法不合规 → 401 invalid_request | ||
| + | - 范围不够 → 403 insufficient_scope | ||
| + | - 客户端只看 error 码 | ||
| + | ## 与其他方案对比 | ||
| + | - Basic:每次带密码 | ||
| + | - Digest:nonce + 摘要 | ||
| + | - Bearer:只证明持有 | ||
| + | - DPoP(RFC 9449):密钥绑定 | ||
| + | - mTLS(RFC 8705):证书绑定 | ||
| + | ## Bearer 与 JWT | ||
| + | - Bearer 管怎么带,JWT 管长什么样 | ||
| + | - 两者正交 | ||
| + | - 不透明令牌:可即时撤销,需查库 | ||
| + | - JWT:无状态,难撤销 | ||
| + | ## 安全要求 | ||
| + | - 全链路 HTTPS | ||
| + | - 不放 URL、不进日志 | ||
| + | - 短寿命 + refresh 轮换 | ||
| + | - 支持撤销与挂失 | ||
| + | - 高价值场景用发送者受限令牌 | ||
| + | - 不放 Cookie,避免 CSRF | ||
| + | ## 常见坑 | ||
| + | - 把 Bearer 当成 JWT | ||
| + | - 401 与 403 混用 | ||
| + | - 401 不带 WWW-Authenticate | ||
| + | - 相信客户端上报的 scope | ||
| + | - 令牌有效期过长 | ||
| + | - 复制粘贴混进换行空格 | ||
| + | ``` | ||