差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 后一修订版 | 前一修订版 | ||
| 代码术语:authorization [2026/10/13 21:54] – 创建 张叶安 | 代码术语:authorization [2026/10/13 21:55] (当前版本) – 为 Authorization 词条添加思维导图 张叶安 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | 1 | + | ====== Authorization(授权) ====== |
| + | |||
| + | **Authorization(授权)** 回答的是「**你能做什么**」,与之配对的 **Authentication(认证)** 回答的是「**你是谁**」。两者的英文缩写都以 '' | ||
| + | |||
| + | 在实际项目中,这个词主要落在两个层面:一是 **HTTP 的 '' | ||
| + | |||
| + | ===== 一、认证与授权:先划清边界 ===== | ||
| + | |||
| + | ^ 维度 ^ Authentication 认证 ^ Authorization 授权 ^ | ||
| + | | 回答的问题 | 你是谁 | 你能做什么 | | ||
| + | | 英文缩写 | authn | authz | | ||
| + | | 典型输入 | 用户名 + 密码、OTP、指纹、令牌 | 身份 + 资源 + 动作 | | ||
| + | | 判据 | 凭证是否真实有效 | 该身份对该资源的权限策略 | | ||
| + | | 失败状态码 | **401** | **403** | | ||
| + | | 常见实现 | 登录、JWT 验签、OIDC | RBAC、ACL、ABAC、OAuth2 scope | | ||
| + | |||
| + | 顺序是固定的:**先认证,再授权**。没有确定的身份,就无从判断权限。 | ||
| + | |||
| + | ''' | ||
| + | |||
| + | ===== 二、HTTP 请求头 Authorization ===== | ||
| + | |||
| + | 它是客户端**携带凭证**的标准位置,语法固定为: | ||
| + | |||
| + | < | ||
| + | Authorization = < | ||
| + | </ | ||
| + | |||
| + | <code http> | ||
| + | Authorization: | ||
| + | Authorization: | ||
| + | Authorization: | ||
| + | </ | ||
| + | |||
| + | 几条必须记住的实操口径: | ||
| + | |||
| + | * **scheme 名称大小写不敏感**,'' | ||
| + | * **凭证必须走 HTTPS**。'' | ||
| + | * **不要把令牌放进 URL query**。它会进浏览器历史、'' | ||
| + | * **一个请求只用一种方案**。不要在同一个请求里塞多个 '' | ||
| + | * **共享缓存默认不吃带 '' | ||
| + | * **日志要脱敏**。'' | ||
| + | |||
| + | ==== 为什么它天然免疫 CSRF ==== | ||
| + | |||
| + | Cookie 由浏览器**自动携带**,所以能被跨站请求利用;而 '' | ||
| + | |||
| + | ===== 三、常见 scheme 对照 ===== | ||
| + | |||
| + | ^ scheme ^ 规范 ^ 凭证形态 ^ 要点 ^ | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | 自定义 | 各自规范 | AWS SigV4、HMAC 签名等 | 云服务常自带签名方案,会带上时间戳与签名防止重放 | | ||
| + | |||
| + | ===== 四、401 与 403:别用反了 ===== | ||
| + | |||
| + | ^ 状态码 ^ 含义 ^ 客户端该怎么做 ^ | ||
| + | | **401** Unauthorized | 名字有误导,实际是**未认证或凭证无效**(缺失、过期、签名错) | 重新认证;响应**应当**带 '' | ||
| + | | **403** Forbidden | 已认证,但**权限不足**,重试也不会变好 | 不要重复登录;提示无权限,或引导申请权限 | | ||
| + | | **407** Proxy Auth Required | 是**代理**要求认证 | 用 '' | ||
| + | |||
| + | <code http> | ||
| + | HTTP/1.1 401 Unauthorized | ||
| + | WWW-Authenticate: | ||
| + | </ | ||
| + | |||
| + | 实践提醒:**把 403 写成 401,前端会陷入" | ||
| + | |||
| + | ===== 五、授权模型:权限怎么判 ===== | ||
| + | |||
| + | ^ 模型 ^ 思路 ^ 典型场景 ^ | ||
| + | | **ACL** 访问控制列表 | 资源上直接挂「谁可以访问」的名单 | 文件系统、共享文档、少量主体 | | ||
| + | | **RBAC** 基于角色的访问控制 | 用户 → 角色 → 权限,中间隔一层角色 | 后台管理系统,最通用 | | ||
| + | | **ABAC** 基于属性的访问控制 | 按主体 / 资源 / 环境的属性动态求值 | 细粒度与动态规则(部门、时间、IP、金额) | | ||
| + | | **ReBAC** 基于关系的访问控制 | 按关系图判定(谁是文档的协作者) | 协作类产品、Google Zanzibar 一系 | | ||
| + | | **OAuth2 scope** | 把权限**委托**给第三方应用,只授予其中一部分 | 第三方登录、开放平台 | | ||
| + | | **PBAC** 基于策略 | 用策略语言统一表达规则(如 OPA / Rego) | 多服务统一鉴权、合规要求高的系统 | | ||
| + | |||
| + | 要点: | ||
| + | |||
| + | * **OAuth2 的 scope 表达的是「授权范围」**,而 OIDC 才补上「认证」那一层 —— 别把 '' | ||
| + | * JWT 里的 '' | ||
| + | * **权限检查要集中**:写成统一中间件或策略服务,而不是散落在各个 handler 里。 | ||
| + | |||
| + | ===== 六、代码里怎么写 ===== | ||
| + | |||
| + | 前端携带凭证: | ||
| + | |||
| + | <code javascript> | ||
| + | // 只放请求头,绝不拼进 URL | ||
| + | await fetch("/ | ||
| + | method: " | ||
| + | headers: { | ||
| + | " | ||
| + | Authorization: | ||
| + | }, | ||
| + | body: JSON.stringify({ productId: 42 }), | ||
| + | }); | ||
| + | </ | ||
| + | |||
| + | 服务端:先用 '' | ||
| + | |||
| + | <code javascript> | ||
| + | app.use((req, | ||
| + | const header = req.get(" | ||
| + | const [scheme, token] = header.split(" | ||
| + | |||
| + | if (scheme? | ||
| + | // 未认证 → 401,并告知认证方式 | ||
| + | res.set(" | ||
| + | return res.status(401).json({ error: " | ||
| + | } | ||
| + | |||
| + | try { | ||
| + | req.user = verifyJwt(token); | ||
| + | } catch { | ||
| + | res.set(" | ||
| + | return res.status(401).json({ error: " | ||
| + | } | ||
| + | next(); | ||
| + | }); | ||
| + | |||
| + | // 授权:认证通过之后,再判断「这个身份能不能做这件事」 | ||
| + | function requireRole(role) { | ||
| + | return (req, res, next) => { | ||
| + | if (!req.user? | ||
| + | next(); | ||
| + | }; | ||
| + | } | ||
| + | |||
| + | app.delete("/ | ||
| + | </ | ||
| + | |||
| + | ===== 七、常见坑 ===== | ||
| + | |||
| + | ^ 坑 ^ 说明 ^ | ||
| + | | 把 403 当 401 用 | 前端会不停刷新令牌陷入死循环;403 重试无意义 | | ||
| + | | 401 不带 '' | ||
| + | | '' | ||
| + | | 令牌放 URL query | 进入历史、'' | ||
| + | | 用请求头传递却仍配 Cookie | 两种来源混用,容易出现" | ||
| + | | 认证通过就当成授权通过 | 只验身份不查权限,是最典型的越权(IDOR)来源 | | ||
| + | | 只在网关鉴权 | 内部服务之间互相调用时绕过了网关,等于没防护 | | ||
| + | | 相信客户端传来的 role | 客户端可任意伪造,授权判定必须在服务端 | | ||
| + | | 日志打印完整 '' | ||
| + | |||
| + | ===== 八、一句话总结 ===== | ||
| + | |||
| + | > **Authorization 是「验完身份之后,查你有没有这个权限」——请求头 '' | ||
| + | |||
| + | 参考: | ||
| + | |||
| + | * RFC 9110 —— [[https:// | ||
| + | * RFC 6750 —— [[https:// | ||
| + | * MDN —— [[https:// | ||
| + | |||
| + | 相关:[[jwt|JWT]] · [[代码术语: | ||
| + | |||
| + | ---- | ||
| + | |||
| + | 返回:[[代码术语]] | ||
| + | |||
| + | ```mdk height=560 color=# | ||
| + | # Authorization(授权) | ||
| + | ## 一对一对手 | ||
| + | - Authentication 认证:你是谁 | ||
| + | - Authorization 授权:你能做什么 | ||
| + | - authn vs authz 别混 | ||
| + | - 先认证,再授权 | ||
| + | |||
| + | ## HTTP 请求头 | ||
| + | - 语法:scheme + 凭证 | ||
| + | - Basic dXNlcjpwYXNz | ||
| + | - Bearer < | ||
| + | - 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 | ||
| + | ``` | ||