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
它是客户端携带凭证的标准位置,语法固定为:
Authorization = <auth-scheme> <credentials>
Authorization: Basic dXNlcjpwYXNzd29yZA== Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... Authorization: Digest username="alice", realm="api", nonce="...", response="..."
几条必须记住的实操口径:
- 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 里「方案 B」把 access token 放内存、走请求头的原因。详细分析见 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 头,由代理凭证解决 |
HTTP/1.1 401 Unauthorized WWW-Authenticate: Bearer realm="api", error="invalid_token"
实践提醒:把 403 写成 401,前端会陷入“疯狂刷新令牌”的死循环 —— 这是前后端联调里最常见的坑之一。而 401 不带 WWW-Authenticate 也是不规范的做法。
五、授权模型:权限怎么判
| 模型 | 思路 | 典型场景 |
|---|---|---|
| ACL 访问控制列表 | 资源上直接挂「谁可以访问」的名单 | 文件系统、共享文档、少量主体 |
| RBAC 基于角色的访问控制 | 用户 → 角色 → 权限,中间隔一层角色 | 后台管理系统,最通用 |
| ABAC 基于属性的访问控制 | 按主体 / 资源 / 环境的属性动态求值 | 细粒度与动态规则(部门、时间、IP、金额) |
| ReBAC 基于关系的访问控制 | 按关系图判定(谁是文档的协作者) | 协作类产品、Google Zanzibar 一系 |
| OAuth2 scope | 把权限委托给第三方应用,只授予其中一部分 | 第三方登录、开放平台 |
| PBAC 基于策略 | 用策略语言统一表达规则(如 OPA / Rego) | 多服务统一鉴权、合规要求高的系统 |
要点:
- OAuth2 的 scope 表达的是「授权范围」,而 OIDC 才补上「认证」那一层 —— 别把
scope当成权限清单的全部。 - 权限检查要集中:写成统一中间件或策略服务,而不是散落在各个 handler 里。
六、代码里怎么写
前端携带凭证:
// 只放请求头,绝不拼进 URL await fetch("/api/orders", { method: "POST", headers: { "Content-Type": "application/json", Authorization: `Bearer ${accessToken}`, }, body: JSON.stringify({ productId: 42 }), });
服务端:先用 Authorization 完成认证,再做授权判定:
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);
七、常见坑
| 坑 | 说明 |
|---|---|
| 把 403 当 401 用 | 前端会不停刷新令牌陷入死循环;403 重试无意义 |
401 不带 WWW-Authenticate | 不符合规范,客户端无法得知该用哪种认证方式 |
Basic 不走 HTTPS | base64 只是编码,等于明文广播密码 |
| 令牌放 URL query | 进入历史、Referer、日志,泄露面成倍扩大 |
| 用请求头传递却仍配 Cookie | 两种来源混用,容易出现“来源优先级不一致”的鉴权 bug |
| 认证通过就当成授权通过 | 只验身份不查权限,是最典型的越权(IDOR)来源 |
| 只在网关鉴权 | 内部服务之间互相调用时绕过了网关,等于没防护 |
| 相信客户端传来的 role | 客户端可任意伪造,授权判定必须在服务端 |
日志打印完整 Authorization | 凭证泄露到日志、监控系统 |
八、一句话总结
**Authorization 是「验完身份之后,查你有没有这个权限」——请求头 ''Authorization'' 负责把凭证送过去,授权模型负责决定放不放行;前者对应 401,后者对应 403。**
参考:
- RFC 9110 —— HTTP Semantics(Authorization、401、403 的定义)
- RFC 6750 —— Bearer Token 用法
- MDN —— Authorization 请求头
返回:代码术语
# 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