代码术语:authorization

差别

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

到此差别页面的链接

后一修订版
前一修订版
代码术语:authorization [2026/10/13 21:54] – 创建 张叶安代码术语:authorization [2026/10/13 21:55] (当前版本) – 为 Authorization 词条添加思维导图 张叶安
行 1: 行 1:
-1+====== Authorization(授权) ====== 
 + 
 +**Authorization(授权)** 回答的是「**你能做什么**」,与之配对的 **Authentication(认证)** 回答的是「**你是谁**」。两者的英文缩写都以 ''auth'' 开头(''authn'' / ''authz''),代码里绝大多数的混淆都源自这一字之差。 
 + 
 +在实际项目中,这个词主要落在两个层面:一是 **HTTP 的 ''Authorization'' 请求头** —— 凭证的运输通道;二是 **权限判定模型**(ACL、RBAC、scope 等)。下面把它们分开讲清楚。 
 + 
 +===== 一、认证与授权:先划清边界 ===== 
 + 
 +^ 维度 ^ Authentication 认证 ^ Authorization 授权 ^ 
 +| 回答的问题 | 你是谁 | 你能做什么 | 
 +| 英文缩写 | authn | authz | 
 +| 典型输入 | 用户名 + 密码、OTP、指纹、令牌 | 身份 + 资源 + 动作 | 
 +| 判据 | 凭证是否真实有效 | 该身份对该资源的权限策略 | 
 +| 失败状态码 | **401** | **403** | 
 +| 常见实现 | 登录、JWT 验签、OIDC | RBAC、ACL、ABAC、OAuth2 scope | 
 + 
 +顺序是固定的:**先认证,再授权**。没有确定的身份,就无从判断权限。 
 + 
 +'''举例''':''alice'' 拿着有效令牌访问 ''/admin/users'',认证那一步完全通过(她确实是 alice),但授权那一步把她挡在门外,因为她的角色是普通用户 —— 这正是 **403** 的语义。 
 + 
 +===== 二、HTTP 请求头 Authorization ===== 
 + 
 +它是客户端**携带凭证**的标准位置,语法固定为: 
 + 
 +<code> 
 +Authorization = <auth-scheme> <credentials> 
 +</code> 
 + 
 +<code http> 
 +Authorization: Basic dXNlcjpwYXNzd29yZA== 
 +Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... 
 +Authorization: Digest username="alice", realm="api", nonce="...", response="..." 
 +</code> 
 + 
 +几条必须记住的实操口径: 
 + 
 +  * **scheme 名称大小写不敏感**,''Bearer'' 与 ''bearer'' 等价,但惯例统一写 ''Bearer''。 
 +  * **凭证必须走 HTTPS**。''Basic'' 只是 base64 编码、不是加密,明文传输等于直接把密码交出去。 
 +  * **不要把令牌放进 URL query**。它会进浏览器历史、''Referer'' 头和服务器访问日志,等于到处留副本;只能走请求头。 
 +  * **一个请求只用一种方案**。不要在同一个请求里塞多个 ''Authorization'' 头;确实需要多种凭证时,改用自定义头(如 ''X-API-Key'')分别承载。 
 +  * **共享缓存默认不吃带 ''Authorization'' 的响应**。做缓存或 CDN 时要注意这点,需要缓存就要显式声明(如 ''public'' / ''s-maxage'' / ''must-revalidate''),并配 ''Vary: Authorization''。 
 +  * **日志要脱敏**。''Authorization'' 头是典型的敏感字段,默认不能全量落盘。 
 + 
 +==== 为什么它天然免疫 CSRF ==== 
 + 
 +Cookie 由浏览器**自动携带**,所以能被跨站请求利用;而 ''Authorization'' 头**必须由前端代码显式设置**,跨站页面无法替受害者的浏览器加上这个头,于是业务请求不带 Cookie 就天然躲开了 CSRF。这就是 [[jwt|JWT]] 里「方案 B」把 access token 放内存、走请求头的原因。详细分析见 [[代码术语:一文讲清楚什么是csrf|CSRF]]。 
 + 
 +===== 三、常见 scheme 对照 ===== 
 + 
 +^ scheme ^ 规范 ^ 凭证形态 ^ 要点 ^ 
 +| ''Basic'' | RFC 7617 | ''base64(user:password)'' | 无状态、最简单;必须 HTTPS,适合内部服务或作为兜底 | 
 +| ''Bearer'' | RFC 6750 | 不透明令牌(JWT、OAuth2 access token) | 当前最主流;令牌本身就是凭证,泄露即可直接用 | 
 +| ''Digest'' | RFC 7616 | nonce + 摘要响应 | 不明文传密码,但实现复杂、易配错,实际已少见 | 
 +| ''Negotiate'' | RFC 4559 | Kerberos / NTLM | 企业 Windows 内网域认证 | 
 +| 自定义 | 各自规范 | AWS SigV4、HMAC 签名等 | 云服务常自带签名方案,会带上时间戳与签名防止重放 | 
 + 
 +===== 四、401 与 403:别用反了 ===== 
 + 
 +^ 状态码 ^ 含义 ^ 客户端该怎么做 ^ 
 +| **401** Unauthorized | 名字有误导,实际是**未认证或凭证无效**(缺失、过期、签名错) | 重新认证;响应**应当**带 ''WWW-Authenticate'' 说明认证方式 | 
 +| **403** Forbidden | 已认证,但**权限不足**,重试也不会变好 | 不要重复登录;提示无权限,或引导申请权限 | 
 +| **407** Proxy Auth Required | 是**代理**要求认证 | 用 ''Proxy-Authorization'' 头,由代理凭证解决 | 
 + 
 +<code http> 
 +HTTP/1.1 401 Unauthorized 
 +WWW-Authenticate: Bearer realm="api", error="invalid_token" 
 +</code> 
 + 
 +实践提醒:**把 403 写成 401,前端会陷入"疯狂刷新令牌"的死循环** —— 这是前后端联调里最常见的坑之一。而 ''401'' 不带 ''WWW-Authenticate'' 也是不规范的做法。 
 + 
 +===== 五、授权模型:权限怎么判 ===== 
 + 
 +^ 模型 ^ 思路 ^ 典型场景 ^ 
 +| **ACL** 访问控制列表 | 资源上直接挂「谁可以访问」的名单 | 文件系统、共享文档、少量主体 | 
 +| **RBAC** 基于角色的访问控制 | 用户 → 角色 → 权限,中间隔一层角色 | 后台管理系统,最通用 | 
 +| **ABAC** 基于属性的访问控制 | 按主体 / 资源 / 环境的属性动态求值 | 细粒度与动态规则(部门、时间、IP、金额) | 
 +| **ReBAC** 基于关系的访问控制 | 按关系图判定(谁是文档的协作者) | 协作类产品、Google Zanzibar 一系 | 
 +| **OAuth2 scope** | 把权限**委托**给第三方应用,只授予其中一部分 | 第三方登录、开放平台 | 
 +| **PBAC** 基于策略 | 用策略语言统一表达规则(如 OPA / Rego) | 多服务统一鉴权、合规要求高的系统 | 
 + 
 +要点: 
 + 
 +  * **OAuth2 的 scope 表达的是「授权范围」**,而 OIDC 才补上「认证」那一层 —— 别把 ''scope'' 当成权限清单的全部。 
 +  * JWT 里的 ''role'' / ''scope'' 只是**携带授权信息的载体**,判定必须由服务端按策略做,绝不能相信客户端传来的角色。字段设计见 [[jwt|JWT]]。 
 +  * **权限检查要集中**:写成统一中间件或策略服务,而不是散落在各个 handler 里。 
 + 
 +===== 六、代码里怎么写 ===== 
 + 
 +前端携带凭证: 
 + 
 +<code javascript> 
 +// 只放请求头,绝不拼进 URL 
 +await fetch("/api/orders", { 
 +  method: "POST", 
 +  headers: { 
 +    "Content-Type": "application/json", 
 +    Authorization: `Bearer ${accessToken}`, 
 +  }, 
 +  body: JSON.stringify({ productId: 42 }), 
 +}); 
 +</code> 
 + 
 +服务端:先用 ''Authorization'' 完成**认证**,再做**授权**判定: 
 + 
 +<code javascript> 
 +app.use((req, res, next) => { 
 +  const header = req.get("authorization") || ""; 
 +  const [scheme, token] = header.split(" "); 
 + 
 +  if (scheme?.toLowerCase() !== "bearer" || !token) { 
 +    // 未认证 → 401,并告知认证方式 
 +    res.set("WWW-Authenticate", 'Bearer realm="api", error="invalid_token"'); 
 +    return res.status(401).json({ error: "unauthorized" }); 
 +  } 
 + 
 +  try { 
 +    req.user = verifyJwt(token);   // 验签 + 校验 exp / iss / aud 
 +  } catch { 
 +    res.set("WWW-Authenticate", 'Bearer realm="api", error="invalid_token"'); 
 +    return res.status(401).json({ error: "invalid token" }); 
 +  } 
 +  next(); 
 +}); 
 + 
 +// 授权:认证通过之后,再判断「这个身份能不能做这件事」 
 +function requireRole(role) { 
 +  return (req, res, next) => { 
 +    if (!req.user?.roles?.includes(role)) return res.status(403).end(); 
 +    next(); 
 +  }; 
 +} 
 + 
 +app.delete("/admin/users/:id", requireRole("admin"), deleteUserHandler); 
 +</code> 
 + 
 +===== 七、常见坑 ===== 
 + 
 +^ 坑 ^ 说明 ^ 
 +| 把 403 当 401 用 | 前端会不停刷新令牌陷入死循环;403 重试无意义 | 
 +| 401 不带 ''WWW-Authenticate'' | 不符合规范,客户端无法得知该用哪种认证方式 | 
 +| ''Basic'' 不走 HTTPS | base64 只是编码,等于明文广播密码 | 
 +| 令牌放 URL query | 进入历史、''Referer''、日志,泄露面成倍扩大 | 
 +| 用请求头传递却仍配 Cookie | 两种来源混用,容易出现"来源优先级不一致"的鉴权 bug | 
 +| 认证通过就当成授权通过 | 只验身份不查权限,是最典型的越权(IDOR)来源 | 
 +| 只在网关鉴权 | 内部服务之间互相调用时绕过了网关,等于没防护 | 
 +| 相信客户端传来的 role | 客户端可任意伪造,授权判定必须在服务端 | 
 +| 日志打印完整 ''Authorization'' | 凭证泄露到日志、监控系统 | 
 + 
 +===== 八、一句话总结 ===== 
 + 
 +> **Authorization 是「验完身份之后,查你有没有这个权限」——请求头 ''Authorization'' 负责把凭证送过去,授权模型负责决定放不放行;前者对应 401,后者对应 403。** 
 + 
 +参考: 
 + 
 +  * RFC 9110 —— [[https://www.rfc-editor.org/rfc/rfc9110.html|HTTP Semantics(Authorization、401、403 的定义)]] 
 +  * RFC 6750 —— [[https://www.rfc-editor.org/rfc/rfc6750.html|Bearer Token 用法]] 
 +  * MDN —— [[https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Authorization|Authorization 请求头]] 
 + 
 +相关:[[jwt|JWT]] · [[代码术语:一文讲清楚什么是csrf|CSRF]] · [[代码术语:sub|sub]] · [[代码术语:payload|payload]] 
 + 
 +---- 
 + 
 +返回:[[代码术语]] 
 + 
 +```mdk height=560 color=#4f46e5 
 +# Authorization(授权) 
 +## 一对一对手 
 +- Authentication 认证:你是谁 
 +- Authorization 授权:你能做什么 
 +- authn vs authz 别混 
 +- 先认证,再授权 
 + 
 +## HTTP 请求头 
 +- 语法:scheme + 凭证 
 +- Basic dXNlcjpwYXNz 
 +- Bearer <token> 
 +- Digest nonce + 摘要 
 +- 必须走 HTTPS 
 +- 不放 URL query 
 +- 日志要脱敏 
 +- 一个请求只用一种方案 
 + 
 +## 为什么免疫 CSRF 
 +- Cookie 由浏览器自动携带 
 +- Authorization 头要前端显式设置 
 +- 业务请求不带 Cookie 
 +- JWT 方案 B 的立足点 
 + 
 +## 401 与 403 
 +- 401:未认证或凭证无效 
 +- 401 应带 WWW-Authenticate 
 +- 403:认证过了但权限不足 
 +- 407:代理要求认证 
 +- 把 403 当 401 会刷新死循环 
 + 
 +## 授权模型 
 +- ACL:资源挂名单 
 +- RBAC:用户 → 角色 → 权限 
 +- ABAC:按属性动态求值 
 +- ReBAC:按关系图判定 
 +- OAuth2 scope:委托授权 
 +- PBAC:策略语言统一表达 
 +- OIDC 补的是认证层 
 + 
 +## 代码落地 
 +- 前端 fetch 带 Bearer 头 
 +- 中间件先验签完成认证 
 +- requireRole 再做授权 
 +- 权限检查集中,别散落 
 + 
 +## 常见坑 
 +- 认证通过就当授权通过 
 +- 只在网关鉴权,内网调用被绕过 
 +- 相信客户端传来的 role 
 +- Cookie 与请求头混用来源 
 +- 令牌放 URL 
 +- Basic 不走 HTTPS 
 +- 日志打印完整 Authorization 
 +``` 

该主题尚不存在

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

  • 代码术语/authorization.1791899654.txt.gz
  • 最后更改: 2026/10/13 21:54
  • 由 张叶安