1 / 4概念
Authentication & Authorization
认证回答“你是谁”,授权回答“你能做什么”,OAuth 解决的是“如何把有限权限委托给第三方”。判断标准不是“用了 JWT 没有”,而是凭证是否短命、权限是否最小、撤销是否可行。
1 概念
1.1 一句话定义
Authentication(认证)验证主体身份,Authorization(授权)判断主体能否对资源执行某个动作;OAuth 2.1 是委托授权框架,OIDC(OpenID Connect)在 OAuth 之上增加身份层,用 ID token 描述“谁登录了”。
1.2 它解决什么问题
- 用户不想把密码交给每个第三方应用,于是用授权服务器签发受限令牌。
- 多服务之间需要统一身份,避免每个服务各自维护账号和密码。
- 权限需要随角色、租户、资源属性变化,而不是硬编码在代码里。
- 令牌泄露、会话固定、越权访问需要可检测、可撤销、可审计。
没有清晰的身份与权限边界,系统会把“登录成功”误当成“什么都能做”。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| AES、RSA、哈希与密钥管理 | Primitives |
| TLS 握手、会话复用与 0-RTT | TLS |
| 证书链、吊销与签发 | Certificate Chain and Validation / Revocation and Transparency |
| XSS、CSRF、SQL 注入、CSP | Web Security |
| 依赖签名、SBOM、构建完整性 | Supply Chain Security |
| HTTP/2、gRPC、WebSocket 语义 | Application Protocols |
| 服务间 mTLS 与网格策略 | Service Mesh |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| resource owner | 授权访问自己资源的用户 | 不是客户端 |
| client | 请求访问资源的应用 | 不是资源服务器 |
| authorization server | 认证用户并签发令牌的服务 | 不是业务 API |
| resource server | 校验令牌并返回资源的 API | 不是授权服务器 |
| access token | 访问资源的凭证,通常是 bearer | 不是身份证明 |
| refresh token | 换取新 access token 的长效凭证 | 不是给业务 API 用的 |
| ID token | OIDC 的身份声明,JSON Web Token(JWT)格式 | 不是访问令牌 |
| PKCE | Proof Key for Code Exchange,授权码流程的防拦截扩展 | 不是客户端认证 |
| scope | 客户端请求的权限范围 | 不是角色 |
| claim | 令牌里的键值声明 | 不是可信输入,除非验签 |
| RBAC | 基于角色的访问控制 | 不是细粒度属性策略 |
| ABAC | 基于属性的访问控制 | 不是简单角色表 |
| PEP/PDP | 策略执行点/策略决策点 | 不要混在业务代码里 |
2 机制
2.1 心智模型
把一次请求想成一条链:主体 → 认证器 → 凭证(会话/令牌)→ 策略执行点(PEP)→ 策略决策点(PDP)→ 资源。认证只发生在链的前半段;每个资源入口都必须重新做授权,不能因为“来自内网”或“已登录”就放行。
2.2 机制拆解
- OAuth 2.1:授权码 + PKCE 是浏览器与移动端的默认流程;客户端凭据用于机器对机器;设备码用于输入受限设备。隐式流程与密码流程已被移除。
- OIDC:在令牌端点同时返回 ID token;客户端校验签名、
iss、aud、exp、nonce,再读取sub/email等声明。ID token 只用于身份,不用于调用 API。 - 令牌:access token 短命、带
aud/scope,资源服务器每次校验;refresh token 长效、必须轮换并检测重放;JWT 只是编码格式,不是安全策略。 - 会话:浏览器用
HttpOnly+Secure+SameSiteCookie 保存会话 ID,服务端存会话状态;会话 ID 必须高熵,登录后轮换。 - 授权模型:RBAC 把角色映射到权限;ABAC 用主体/资源/环境属性求值;ReBAC 用关系图(如“文档的编辑者”)表达共享。
- 策略执行:PEP 在每个入口调用 PDP;PDP 返回 allow/deny 与义务(如脱敏、二次认证),业务代码只执行结果。
2.3 完整枚举
| 流程 / 机制 | 参与者 | 适用 | 产物 | 关键约束 |
|---|---|---|---|---|
| Authorization Code + PKCE | 用户、客户端、授权服务器 | Web SPA、移动端、服务端 Web | code → access/refresh/ID token | 必须校验 state、nonce、redirect_uri |
| Client Credentials | 客户端、授权服务器 | 机器对机器、后台任务 | access token | 不能代表用户,scope 要最小 |
| Device Code | 设备、用户、授权服务器 | TV、CLI、输入受限设备 | access token | 用户码要短命、限速 |
| Refresh Token | 客户端、授权服务器 | 长期会话 | 新 access token | 轮换、重放检测、绑定客户端 |
| Token Exchange | 客户端、授权服务器 | 服务间代表用户调用 | 新 token | 防止权限放大 |
| Session Cookie | 浏览器、服务端 | 同域 Web 应用 | 会话 ID | HttpOnly、Secure、SameSite |
| OIDC ID Token | 客户端、授权服务器 | 单点登录、身份声明 | JWT | 只用于身份,不用于 API 授权 |
| RBAC | 用户、角色、权限 | 权限较稳定的企业应用 | 角色-权限表 | 角色爆炸、最小权限 |
| ABAC | 主体/资源/环境属性 | 多租户、细粒度策略 | 策略决策 | 属性来源与策略测试 |
| ReBAC | 主体、关系、对象 | 文档共享、组织层级 | 关系图查询 | 图规模与一致性 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| access token 有效期 | 分钟到小时 | 越短越安全,但刷新更频繁 |
| refresh token 有效期 | 天到月 | 必须可撤销、可轮换 |
| PKCE verifier | 43–128 字符 | 高熵随机串,不能复用 |
| 时钟偏移容忍 | 分钟级 | 校验 exp/nbf 时留余量 |
| Cookie 大小上限 | 约 4 KB | 不要塞整份 JWT 到 Cookie |
| 授权码有效期 | 秒到分钟 | 一次性使用,绑定 PKCE |
| JWT 体积 | 数百字节到数 KB | 声明越多,请求头越大 |
3 实践
3.1 最小示例
OAuth 2.1 授权码 + PKCE 的客户端侧伪代码:
verifier = random_string(43..128)
challenge = base64url(sha256(verifier))
redirect = /authorize?response_type=code
& client_id=web
& redirect_uri=https://app.example/callback
& scope=openid%20profile%20orders:read
& state=<random>
& code_challenge=<challenge>
& code_challenge_method=S256
# 回调后:校验 state,拿 code + verifier 换 token
# 校验 ID token:签名、iss、aud、exp、nonce
服务端授权检查:
type Subject = { id: string; roles: string[]; tenant: string };
type Resource = { owner: string; tenant: string };
function canRead(subject: Subject, resource: Resource): boolean {
if (subject.tenant !== resource.tenant) return false;
return subject.roles.includes("admin") || subject.id === resource.owner;
}
3.2 常用操作与参数
| 操作 | 命令 / API | 说明 |
|---|---|---|
| 换取令牌 | POST /token + grant_type=authorization_code | 带 code_verifier,不要放 URL |
| 查看令牌声明 | jwt decode <token> | 只看声明,不代表已验签 |
| 校验令牌 | 授权服务器 JWKS / introspection | 校验签名、iss、aud、exp |
| 撤销令牌 | POST /revoke | 撤销 refresh token 与授权 |
| 设置会话 Cookie | Set-Cookie: sid=...; HttpOnly; Secure; SameSite=Lax | 不要用 JS 读取 |
| 轮换会话 | 登录成功后生成新会话 ID | 防会话固定 |
| 查询权限 | GET /permissions?subject=... | PDP 的统一入口 |
| 审计授权 | 记录 subject/action/resource/decision | 便于追责与告警 |
3.3 标准流程
- 明确主体类型:用户、服务、设备;分别选择授权码、客户端凭据或设备码。
- 注册客户端,固定
redirect_uri,只申请最小 scope。 - 浏览器/移动端用授权码 + PKCE;SPA 不保存 client secret。
- 资源服务器每次校验 access token 的签名、
iss、aud、exp与 scope。 - 用 PEP 在入口做授权,PDP 统一策略;默认拒绝,显式允许。
- 设计撤销:短命 access token、可撤销 refresh token、会话失效与审计。
3.4 与相邻技术的组合
- TLS:所有令牌与会话都必须走 HTTPS;HSTS 防降级。
- Web Security:Cookie 会话要防 CSRF;Bearer token 要防 XSS 读取。
- API 网关:在边缘做令牌校验与粗粒度 scope 检查,细粒度授权留给服务。
- 服务网格:mTLS 证明服务身份,不等于用户身份;用户上下文仍需传播。
- 审计/风控:登录、授权、撤销事件进入 SIEM,异常行为触发二次认证。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 客户端类型 | SPA / 移动端 / 服务端 Web / 机器 | 决定流程与密钥存放 |
| 主体 | 用户 / 服务 / 设备 | 决定 grant type |
| 会话需求 | 可撤销 / 无状态 | Cookie 会话 vs JWT |
| 权限粒度 | 粗 / 细 / 关系型 | RBAC / ABAC / ReBAC |
| 多租户 | 是 / 否 | 授权必须带租户边界 |
| 合规 | 审计 / 注销 / 数据最小化 | 影响令牌寿命与日志 |
3.6 决策规则
- 浏览器 SPA:授权码 + PKCE,access token 放内存,refresh token 用安全存储或 BFF。
- 服务端 Web:授权码 + PKCE 或 OIDC,会话 Cookie + 服务端会话。
- 机器对机器:客户端凭据,scope 精确到 API/动作。
- 单点登录:OIDC;需要企业身份源时接 SAML/OIDC 联邦。
- 权限稳定且角色少:RBAC;多租户/资源属性复杂:ABAC;共享关系复杂:ReBAC。
- 需要“立即踢下线”:服务端会话或短命 token + 撤销列表,不要只发长效 JWT。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| 服务端会话 Cookie | 可撤销、实现简单 | 需要会话存储、跨域麻烦 | 同域 Web、后台系统 |
| JWT access token | 无状态、易跨服务 | 撤销难、泄露风险 | API、微服务 |
| Opaque token + introspection | 可撤销、信息不暴露 | 每次内省有延迟 | 高安全 API |
| RBAC | 模型简单、易审计 | 角色爆炸、粒度粗 | 企业后台 |
| ABAC | 细粒度、上下文感知 | 策略复杂、测试成本高 | 多租户、合规场景 |
| ReBAC | 表达共享关系 | 图查询与一致性复杂 | 文档协作、组织权限 |
3.8 何时不该用
- 单体应用只有一种用户:不要为了“标准”引入完整 OAuth,会话登录更简单。
- 只需要服务间认证:客户端凭据 + mTLS,不要模拟用户。
- 需要即时撤销且无法维护撤销列表:不要用长效 JWT 当会话。
- 把 ID token 当 API 凭证:受众不对,应该用 access token。
- 权限判断只放在前端:前端只做展示,服务端必须再判一次。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
回调报 redirect_uri 不匹配 | 注册值与请求值不一致 | 精确匹配,禁止通配 |
| 登录后立刻 401 | aud/iss 配错或时钟偏移 | 对齐受众、发行方与时间 |
| 令牌被重放 | refresh token 未轮换 | 轮换 + 重放检测 + 撤销 |
| 用户能看到别的租户数据 | 授权查询缺少租户条件 | 把租户写进策略与查询 |
| 退出登录后仍能访问 | 只清了前端 token | 服务端撤销/短命 token |
| Cookie 不发送 | SameSite/Secure/域配置错误 | 检查作用域与 HTTPS |
| 会话固定 | 登录后未轮换会话 ID | 登录成功生成新 ID |
| scope 过大 | 申请了用不到的权限 | 最小 scope,按动作拆分 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| SPA 里保存 client secret | 秘密公开,等同没有 | 授权码 + PKCE,秘密放后端 |
| access token 存 localStorage | XSS 可直接窃取 | 内存 + BFF/HttpOnly Cookie |
| 用 ID token 调业务 API | 受众与用途不符 | 使用 access token |
| 只信前端传来的 role | 越权 | 服务端从令牌/策略读取 |
| 无限续期的 refresh token | 泄露后长期有效 | 轮换、绑定客户端、过期 |
| 所有服务共享一个万能 token | 爆炸半径过大 | 按服务/动作拆分 audience/scope |
4.3 可观测信号
登录成功率、401/403 比例、令牌刷新失败率、授权决策耗时、撤销事件、异常地理位置/设备、scope 使用分布、会话数量。审计日志至少包含 subject、action、resource、decision、reason 和 request id。
4.4 安全 / 性能 / 一致性边界
- Bearer 语义:谁拿到 access token 谁就能用;必须靠 HTTPS、短命和受众限制降低泄露影响。
- 最小权限:scope、角色、租户、资源四层都要收紧;默认拒绝。
- 撤销:JWT 无状态与即时撤销天然冲突,需要短命 + 撤销列表/版本号。
- 一致性:权限变更传播有延迟;高风险操作要二次校验,不能只信缓存。