OAuth 介绍

OAuth 介绍

介绍#

OAuth 是一个开放标准。假设有两个网站 A 和 B,OAuth 允许 A 在不知晓你在 B 上的凭据的前提下,使用你 B 上的数据或者权限。

Info

目前(2026)主流的版本为 OAuth 2.0(本分类中的笔记也都围绕该版本展开)。

平时看到的“第三方登入”就用到了 OAuth。

OAuth 中定义了四个角色:

角色含义
资源所有者你,即用户
客户端想要访问资源所有者在应用 B 上的数据的应用 A
授权服务器验证资源所有者身份,通过后向客户端颁发访问令牌
资源服务器托管资源所有者的数据的应用 B,并会接收和处理访问令牌

客户端均需要在授权服务器上进行注册,注册的内容:

  • 客户端类型(必须)
  • redirect_uri 白名单(必须)
  • 其他授权服务器所要求的信息(视具体情况而定)

客户端类型有两种:

  • 机密客户端 → 能够对其凭据保密
  • 公开客户端 →

是机密还是公开取决于客户端能否对其凭据进行保密(相对于资源所有者来说)。即资源所有者能看到凭据,则是公开;若看不到,则是机密。

所谓客户端凭据,就是客户端在授权服务器上注册成功之后,授权服务器返回的一些用于客户端认证的凭据信息,常见的:

  • client_id
  • client_secret

OAuth 定义了很多的访问令牌的颁发方式,这些方式被称为 OAuth 授权类型,主要包含:

  • 授权码
  • 隐式授权 ← 在 Outh 2.1 中被弃用
  • 设备码
  • 刷新令牌
  • 客户端凭据

这些都可以在官方文档中看到精确的解释,这里仅讲述“授权码”和“隐式授权”这两个,因为他们和本分类中的其他笔记关系最密切。

注意,不同的授权类型有着不同的授权流程,授权流程在业界也常被称为 Dance(全称 OAuth Dance),因为整个交互流程留下的“轨迹”很像跳舞时在地板上留下的的舞步痕迹。

授权码#

这是 OAuth 2.0 中使用最广泛的授权类型,其整体流程(图源于 RFC 文档):

Tip

图中的 User-Agent 表示用户代理,最常见的就是浏览器。

该图很好地展示了交互流程以及用户代理上能看到哪些信息,这对后续漏洞的理解是有帮助的。

第一步:授权请求#

客户端将用户代理重定向到授权服务器的授权端点,并携带:

  • response_type=code
  • client_id
  • redirect_uri
  • scope
  • state
Tip

授权端点的名称并不固定,常见的有 /authorization、/authorize、/auth。

在 HTTP 历史报文中找到授权端点并不难,只需要观察请求参数:

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 的定义:

Text
scope-token = 1*( %x21 / %x23-5B / %x5D-7E )

解读:至少一个字符,字符范围是可打印 ASCII,但排除空格、双引号、反斜杠。

示例:

Text
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(非必须,在上一步骤中提到过)这两个参数。用户代理随后就会访问客户端:

HTTP
GET /callback?code=a1b2c3d4e5f6g7h8&state=ae13d489bd00e3c24 HTTP/1.1
Host: client-app.com

第三步:访问令牌请求#

访问令牌请求、访问令牌响应,这是发生在客户端和授权服务器之间的,用户代理看不到该过程(在用户代理和客户端之间的抓包工具自然也看不到)。

Info

这很像在“暗箱操作”,因此很多博客都称其为“后通道(Back Channel)”。

访问令牌请求中,客户端会通过后通道,向授权服务器的令牌端点(Token Endpoint)发起请求。

Tip

同“授权端点”,令牌端点也没有固定的名称,常见的:/token。

请求中,授权码通过 code 参数传递;授权类型通过 grant_type 参数传递,值必须为 authorization_code。

除此之外,客户端还需要提供凭据信息用于身份验证,常见的:

  • client_id(通过请求参数传递)
  • client_secret

client_secret 大多通过 HTTP Basic 发送:

HTTP
Authorization: Basic czZCaGRSa3F0Mzo3RmpmcDBaQnIxS3REUmJuZlZkbUl3

czZCaGRSa3F0Mzo3RmpmcDBaQnIxS3REUmJuZlZkbUl3 是 用户名:密码 经过 base64 编码后的结果:

Text
s6BhdRkqt3:7Fjfp0ZBr1KtDRbnfVdmIw
↓ base64
czZCaGRSa3F0Mzo3RmpmcDBaQnIxS3REUmJuZlZkbUl3

当然,也可以直接通过请求参数的方式进行传递(但 RFC 并不推荐此方法):

HTTP
client_id=12345&client_secret=czZCaGRSa3F0Mzo3RmpmcDBaQnIxS3REUmJuZlZkbUl3

redirect_uri 参数是否需要存在取决于授权请求中是否存在该参数:

  • 存在 → 需要
  • 不存在 → 不需要

第四步:访问令牌响应#

授权服务器收到请求后,需要干两件事情:

  • 验证客户端身份
  • 验证授权码
  • 验证 redirect_uri(如果有)是否与授权请求中提供的一致

如果一切符合预期,则返回访问令牌(通常还会返回刷新令牌):

HTTP
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 发起调用了。

Tip

此过程也在后通道中完成。

访问令牌通常放在 Authorization: Bearer 中:

HTTP
GET /userinfo HTTP/1.1
Host: oauth-resource-server.com
Authorization: Bearer z0y9x8w7v6u5

第六步:资源授权#

资源服务器收到调用后,会验证访问令牌是否有效,以及它是否属于当前客户端应用程序。如果是,资源服务器将根据访问令牌所对应的 scope 发送所请求的资源。

隐式授权#

这是早期为“客户端通过 JS 去走 OAuth 流程”设计的,其步骤如下(图源于 RFC 文档):

第一步:授权请求#

该步骤和授权码授权类型非常相似,唯一的主要区别是,response_type 需要设置为 token:

HTTP
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)发送:

HTTP
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:

HTTP
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.com

ID Token#

在 OpenID Connect 框架中,用户在 OP 完成认证之后,OP 会向 RP 发送一个 ID Token,这是一个 JWT 格式的令牌,当然其出现的形式往往是 JWS 或者 JWE。

Tip

关于 JWT 的介绍,可见这篇文章。

客户端会从两方面验证 ID Token:

  • JWS/JWE 在密码学上的校验
  • JWT 中的声明

这大大提升了客户端的可信度,但是无论是验证流程的具体实现还是 JWT 本身都可能存在不安全的实现。

response_type#

采用 OpenID Connect 的,需要在授权请求中指定:

HTTP
response_type=id_token

注意,OAuth 支持多种响应类型,因此客户端完全可以组合不同的响应类型(用空格分隔),例如:

HTTP
response_type=id_token token
response_type=id_token code

PKCE#

针对授权码授权类型,有这么一类攻击,攻击者通过某种方式(CSRF、redirect_uri 修改等)获得了发起有效访问令牌请求的三要素:

  • client_id
  • code
  • client_secret
Tip

grant_type 是必须提供的参数之一,之所以没放上面,是因为它的值在授权码授权类型中是固定的 authorization_code,无需从受害者那边窃取。

此时,攻击者可模仿客户端向授权服务器发起访问令牌请求,一个 Python 代码示例:

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:

Text
code_challenge = code_verifier

S256:

Text
code_challenge = BASE64URL-ENCODE(SHA256(ASCII(code_verifier)))

然后,客户端发起授权请求,并将 code_challenge 以及生成算法一并发送给授权服务器。

在后续的访问令牌请求中,客户端需要向授权服务器提供 code_verifier,授权服务器接收后会根据之前由客户端提供的算法计算挑战值:

  • 结果与之前提供的一致 → 开始正常的客户端授权、验授权码……
  • 结果与之前提供的不一致 → 拒绝本次请求

由于有效的 code_verifier 只有真正的客户端有,因此可以有效防御前面介绍的攻击。

谁把我灯关了
谁把我灯关了

网安小白,幻想着成为一名大佬。

版权声明
本文采用CC BY-NC-SA 4.0许可协议,转载请注明出处。
最后更新

反向链接 1

关系图谱查看全部

相关文章

键盘快捷键

全站

CtrlK
搜索
/
搜索
?
显示快捷键
Esc
关闭弹窗、退出模式

阅读文章

T
目录
F
专注模式
A
批注模式

批注模式

P
笔
H
荧光笔
L
激光笔
E
橡皮擦
1–6
切换颜色
Shift
按住拖动画直线
CtrlZ
撤销
CtrlShiftZ
重做