代码术语:bearer

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
前一修订版
代码术语:bearer [2026/10/13 22:45] – 新建 Bearer(持有者令牌)术语页 张叶安代码术语:bearer [2026/10/13 22:45] (当前版本) – 补充本页思维导图 张叶安
行 38: 行 38:
 </code> </code>
  
-注意:'''OAuth2 的 ''token_type'' 决定这个令牌用哪个 scheme 携带**,''Bearer'' 是最常见的那一个。方案名**大小写不敏感**(''bearer'' / ''BEARER'' 等价),但惯例统一写 ''Bearer''。+注意:**OAuth2 的 ''token_type'' 决定这个令牌用哪个 scheme 携带**,''Bearer'' 是最常见的那一个。方案名**大小写不敏感**(''bearer'' / ''BEARER'' 等价),但惯例统一写 ''Bearer''。
  
 ===== 三、三种传递方式 ===== ===== 三、三种传递方式 =====
行 215: 行 215:
  
 返回:[[代码术语]] 返回:[[代码术语]]
 +
 +```mdk height=560 color=#4f46e5
 +# Bearer 持有者令牌
 +## 字面含义
 +- bearer = 持票人
 +- 不记名凭证:谁拿来谁能用
 +- 令牌本身就是全部证明
 +- 推论:必须 HTTPS、寿命短、可撤销
 +## 两个语境
 +- HTTP scheme:Authorization: Bearer <token>
 +- OAuth2 token_type: "Bearer"
 +- 方案名大小写不敏感
 +## 三种传递方式
 +- 请求头(推荐)
 +- 表单体:只允许 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
 +- 令牌有效期过长
 +- 复制粘贴混进换行空格
 +```
  

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • 代码术语/bearer.1791902737.txt.gz
  • 最后更改: 2026/10/13 22:45
  • 由 张叶安