介绍#
OAuth 是一个开放标准。假设有两个网站 A 和 B,OAuth 允许 A 在不知晓你在 B 上的凭据的前提下,使用你 B 上的数据或者权限。
目前(2026)主流的版本为 OAuth 2.0(本分类中的笔记也都围绕该版本展开)。
平时看到的“第三方登入”就用到了 OAuth。
OAuth 中定义了四个角色:
| 角色 | 含义 |
|---|---|
| 资源所有者 | 你,即用户 |
| 客户端 | 想要访问资源所有者在应用 B 上的数据的应用 A |
| 授权服务器 | 验证资源所有者身份,通过后向客户端颁发访问令牌 |
| 资源服务器 | 托管资源所有者的数据的应用 B,并会接收和处理访问令牌 |
客户端均需要在授权服务器上进行注册,注册的内容:
- 客户端类型(必须)
redirect_uri白名单(必须)- 其他授权服务器所要求的信息(视具体情况而定)
客户端类型有两种:
- 机密客户端 → 能够对其凭据保密
- 公开客户端 →
是机密还是公开取决于客户端能否对其凭据进行保密(相对于资源所有者来说)。即资源所有者能看到凭据,则是公开;若看不到,则是机密。
所谓客户端凭据,就是客户端在授权服务器上注册成功之后,授权服务器返回的一些用于客户端认证的凭据信息,常见的:
client_idclient_secret
OAuth 定义了很多的访问令牌的颁发方式,这些方式被称为 OAuth 授权类型,主要包含:
- 授权码
- 隐式授权 ← 在 Outh 2.1 中被弃用
- 设备码
- 刷新令牌
- 客户端凭据
这些都可以在官方文档中看到精确的解释,这里仅讲述“授权码”和“隐式授权”这两个,因为他们和本分类中的其他笔记关系最密切。
注意,不同的授权类型有着不同的授权流程,授权流程在业界也常被称为 Dance(全称 OAuth Dance),因为整个交互流程留下的“轨迹”很像跳舞时在地板上留下的的舞步痕迹。
授权码#
这是 OAuth 2.0 中使用最广泛的授权类型,其整体流程(图源于 RFC 文档):

图中的 User-Agent 表示用户代理,最常见的就是浏览器。
该图很好地展示了交互流程以及用户代理上能看到哪些信息,这对后续漏洞的理解是有帮助的。
第一步:授权请求#
客户端将用户代理重定向到授权服务器的授权端点,并携带:
response_type=codeclient_idredirect_uriscopestate
授权端点的名称并不固定,常见的有 /authorization、/authorize、/auth。
在 HTTP 历史报文中找到授权端点并不难,只需要观察请求参数:
GET /authorization?client_id=12345&redirect_uri=https://client-app.com/callback&response_type=code&scope=openid%20profile&state=ae13d489bd00e3c24 HTTP/1.1
Host: oauth-authorization-server.com
……参数解释:
| 参数名 | 描述 |
|---|---|
client_id | 必填参数,其值为客户端标识符(客户端在授权服务器上注册的时候会被分配此值,授权服务器内唯一)。 |
redirect_uri | 可选参数,用于指定授权服务器应该向客户端的哪个 URI 发送授权码。RFC 中的叫法为 Redirection endpoint 即重定向端点,但是人们也常称其为:回调 URI、回调端点。 |
response_type | 必填参数,用于指定授权服务器应该返回什么。对于授权码授权类型,该值应为 code,即授权服务器应该返回授权码 。 |
scope | 可选参数,用于指定客户端想从授权服务器上获得的权限范围。示例见下。 |
state | 可选参数(但推荐),存储一个唯一且无法猜测的值,供客户端在请求与回调之间绑定会话,用于防范跨站请求伪造(CSRF)。在授权服务器携带授权码访问重定向端点的时候会携带上该值。 |
scope 由一个个的 scope-token 构成(用空格分隔),scope-token 的定义:
scope-token = 1*( %x21 / %x23-5B / %x5D-7E )解读:至少一个字符,字符范围是可打印 ASCII,但排除空格、双引号、反斜杠。
示例:
scope=contacts
scope=contacts.read
scope=contact-list-r
scope=https://oauth-authorization-server.com/auth/scopes/user/contacts.readonly可见,RFC 中并没有给 scope 定义任何的特定值,因为 scope 在很大程度上取决于服务的内部架构和需求。
热门服务中的 scope 示例:
第二步:授权响应#
授权服务器收到授权请求之后,首先会验证资源所有者的身份。验证成功之后,资源所有者能看到 scope 所规定的授权范围,他们能选择是否同意客户端获得这些权限。
如果资源所有者选择同意,授权服务器将生成一个授权码。接着,授权服务器会给用户代理一个重定向响应,地址是 redirect_uri 所指定的回调端点,并且会携带 code(存放授权码)和 state(非必须,在上一步骤中提到过)这两个参数。用户代理随后就会访问客户端:
GET /callback?code=a1b2c3d4e5f6g7h8&state=ae13d489bd00e3c24 HTTP/1.1
Host: client-app.com第三步:访问令牌请求#
访问令牌请求、访问令牌响应,这是发生在客户端和授权服务器之间的,用户代理看不到该过程(在用户代理和客户端之间的抓包工具自然也看不到)。
这很像在“暗箱操作”,因此很多博客都称其为“后通道(Back Channel)”。
访问令牌请求中,客户端会通过后通道,向授权服务器的令牌端点(Token Endpoint)发起请求。
同“授权端点”,令牌端点也没有固定的名称,常见的:/token。
请求中,授权码通过 code 参数传递;授权类型通过 grant_type 参数传递,值必须为 authorization_code。
除此之外,客户端还需要提供凭据信息用于身份验证,常见的:
client_id(通过请求参数传递)client_secret
client_secret 大多通过 HTTP Basic 发送:
Authorization: Basic czZCaGRSa3F0Mzo3RmpmcDBaQnIxS3REUmJuZlZkbUl3czZCaGRSa3F0Mzo3RmpmcDBaQnIxS3REUmJuZlZkbUl3 是 用户名:密码 经过 base64 编码后的结果:
s6BhdRkqt3:7Fjfp0ZBr1KtDRbnfVdmIw
↓ base64
czZCaGRSa3F0Mzo3RmpmcDBaQnIxS3REUmJuZlZkbUl3当然,也可以直接通过请求参数的方式进行传递(但 RFC 并不推荐此方法):
client_id=12345&client_secret=czZCaGRSa3F0Mzo3RmpmcDBaQnIxS3REUmJuZlZkbUl3redirect_uri 参数是否需要存在取决于授权请求中是否存在该参数:
- 存在 → 需要
- 不存在 → 不需要
第四步:访问令牌响应#
授权服务器收到请求后,需要干两件事情:
- 验证客户端身份
- 验证授权码
- 验证
redirect_uri(如果有)是否与授权请求中提供的一致
如果一切符合预期,则返回访问令牌(通常还会返回刷新令牌):
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache
{
"access_token":"2YotnFZFEjr1zCsicMWpAA",
"token_type":"example",
"expires_in":3600,
"refresh_token":"tGzv3JOkF0XG5Qx2TlKWIA",
"example_parameter":"example_value"
}第五步:API 调用#
客户端此时就可以拿着访问令牌向资源服务器的 API 发起调用了。
此过程也在后通道中完成。
访问令牌通常放在 Authorization: Bearer 中:
GET /userinfo HTTP/1.1
Host: oauth-resource-server.com
Authorization: Bearer z0y9x8w7v6u5第六步:资源授权#
资源服务器收到调用后,会验证访问令牌是否有效,以及它是否属于当前客户端应用程序。如果是,资源服务器将根据访问令牌所对应的 scope 发送所请求的资源。
隐式授权#
这是早期为“客户端通过 JS 去走 OAuth 流程”设计的,其步骤如下(图源于 RFC 文档):

第一步:授权请求#
该步骤和授权码授权类型非常相似,唯一的主要区别是,response_type 需要设置为 token:
GET /authorization?client_id=12345&redirect_uri=https://client-app.com/callback&response_type=token&scope=openid%20profile&state=ae13d489bd00e3c24 HTTP/1.1
Host: oauth-authorization-server.com第二步:访问令牌响应#
同样,授权服务器需要验证资源所有者的身份,验证成功后,让资源所有者确认 scope 所列举的授权范围。
资源所有者如果同意授权,授权服务器会将其浏览器重定向到授权请求中指定的 redirect_uri,并将访问令牌及其他令牌相关数据作为 URL 片段(URL fragment)发送:
GET /callback#access_token=z0y9x8w7v6u5&token_type=Bearer&expires_in=5000&scope=openid%20profile&state=ae13d489bd00e3c24 HTTP/1.1
Host: client-app.com由于访问令牌被放在 URL 片段中(它不会直接发送给客户端应用程序),因此客户端应用程序必须使用适当的脚本(JS)来提取片段中访问令牌并将其保存。
第三步:API 调用#
流程同授权码授权类型。但是这有个关键区别,即访问令牌的可见性。
在授权码授权类型中,访问令牌对用户是不可见的,因此对 API 的调用只能由客户端发起。
但在隐式授权中,访问令牌用户可见,因此用户当然可以拿着令牌自行对 API 发起调用。
第四步:资源授权#
同授权码授权类型,不再赘述。
OpenID Connect#
OAuth 仅作授权,并不验证当前使用客户端的用户(在文档中常被叫为“终端用户”)是否是真正的资源所有者。
为了弥补这个不足,引入了一个基于 OAuth 2.0 规范的框架,即 OpenID Connect(OIDC)。
需要注意两个术语:
- 实现了 OpenID Connect 的授权服务器被称为 OpenID Providers(简称 OP)
- 在 OpenID Connect 框架中的客户端也被称为 Relying Parties(简称 RP)
若要使用 OpenID Connect,RP 必须在授权请求中向 scope 参数添加 openid:
GET /authorize?response_type=code&client_id=s6BhdRkqt3&redirect_uri=https%3A%2F%2Fclient.example.org%2Fcb&scope=openid%20profile%20email&state=af0ifjsldkj&nonce=n-0S6_WzA2Mj
Host: server.example.comID Token#
在 OpenID Connect 框架中,用户在 OP 完成认证之后,OP 会向 RP 发送一个 ID Token,这是一个 JWT 格式的令牌,当然其出现的形式往往是 JWS 或者 JWE。
关于 JWT 的介绍,可见这篇文章。
客户端会从两方面验证 ID Token:
- JWS/JWE 在密码学上的校验
- JWT 中的声明
这大大提升了客户端的可信度,但是无论是验证流程的具体实现还是 JWT 本身都可能存在不安全的实现。
response_type#
采用 OpenID Connect 的,需要在授权请求中指定:
response_type=id_token注意,OAuth 支持多种响应类型,因此客户端完全可以组合不同的响应类型(用空格分隔),例如:
response_type=id_token token
response_type=id_token codePKCE#
针对授权码授权类型,有这么一类攻击,攻击者通过某种方式(CSRF、redirect_uri 修改等)获得了发起有效访问令牌请求的三要素:
client_idcodeclient_secret
grant_type 是必须提供的参数之一,之所以没放上面,是因为它的值在授权码授权类型中是固定的 authorization_code,无需从受害者那边窃取。
此时,攻击者可模仿客户端向授权服务器发起访问令牌请求,一个 Python 代码示例:
from authlib.integrations.requests_client import OAuth2Session
client_id = "dc6209a9d196f34902d5228d39cef3778970697365f6de78deba171e704cc221"
client_secret = "5cabdb56ad624bd7681fe159dfb11524cd03bfdb60e2144d5f8302936dd4f39a"
scope = ""
authorization_response = "http://u50evnpxmud5f9grewlnz5b1osuji96y.oastify.com/?code=b289eca458477cd3002296db2f4ebc73603ad70d1dc1a1d1b91080659e470990&state=2a3eeb79cc1d4c6e2d7c7805320a69669a7ac874a3c2a512"
token_endpoint = "http://authorization-ptl-036a4bb909e2-1e9cddb3e956.libcurl.so/oauth/token"
redirect_uri = "http://u50evnpxmud5f9grewlnz5b1osuji96y.oastify.com"
client = OAuth2Session(client_id, client_secret, scope=scope, redirect_uri=redirect_uri)
token = client.fetch_token(token_endpoint, authorization_response=authorization_response)
print(token)授权服务器并不会发现异样,因为用于验证客户端身份的关键参数(client_id、client_secret 等)都是攻击者窃取来的。
PKCE(Proof Key for Code Exchange)的出现就是为了防止上述攻击的。
在发起授权请求之前,客户端会生成一个高熵的代码验证器 code_verifier,其实就是一串随机字符串。接着,客户端用 code_verifier 配合某算法计算得到挑战码 code_challenge。常见的算法有两种:
plain:
code_challenge = code_verifierS256:
code_challenge = BASE64URL-ENCODE(SHA256(ASCII(code_verifier)))然后,客户端发起授权请求,并将 code_challenge 以及生成算法一并发送给授权服务器。
在后续的访问令牌请求中,客户端需要向授权服务器提供 code_verifier,授权服务器接收后会根据之前由客户端提供的算法计算挑战值:
- 结果与之前提供的一致 → 开始正常的客户端授权、验授权码……
- 结果与之前提供的不一致 → 拒绝本次请求
由于有效的 code_verifier 只有真正的客户端有,因此可以有效防御前面介绍的攻击。