目录

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="..."

几条必须记住的实操口径:

为什么它天然免疫 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) 多服务统一鉴权、合规要求高的系统

要点:

六、代码里怎么写

前端携带凭证:

// 只放请求头,绝不拼进 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。**

参考:

相关:JWT · CSRF · sub · payload


返回:代码术语

# 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