你大概在哪儿听过一句话:"OAuth 2.1 把 client_secret 干掉了。" 听起来很爽,但如果你照着这句话去把你后端服务的 secret删了,恭喜你,登录模块当晚就挂。
今天我们就把这件事讲透:OAuth 2.1 到底改了什么、为什么有的应用确实可以不要 client_secret、而有的应用不仅不能删,反而比原来更离不了它。
一句话先放这儿:OAuth 2.1 不是"消灭"了 client_secret,而是规定某些客户端根本就不该持有 secret。
OAuth 2.1 是个啥
简单说,OAuth 2.1 不是凭空发明的新协议,而是把过去十年里 OAuth 2.0 的一堆"补丁"和"最佳实践"打包、统一、删掉糟粕后形成的一揽子规范。
它目前仍是 IETF 草案(draft-ietf-oauth-v2-1)「待核实最新状态」,但主流授权服务器(Auth0、Okta、Keycloak等)早就按它的思路在实现了。你可以把它理解为:OAuth2.0的"最终稳定整合版"。
2.1 相对 2.0 收敛了啥
OAuth 2.0 当年留了不少"灵活"的口子,结果被各种滥用。OAuth 2.1 主要做了这几件收敛的事:
- 合并了多个 RFC
把核心规范、PKCE、Bearer Token、原生 App 最佳实践等整合到一起。 - 废弃隐式授权(implicit grant)
以前 SPA 直接在浏览器里拿 token,token 暴露在前端,太危险,删掉。 - 废弃密码模式(password grant / ROPC)
App 直接收集用户账号密码再换 token,等于把密码交给第三方,删掉。 - 强制 PKCE
授权码流程里,PKCE 从"可选"变成"必须",连机密客户端也要用。 - 强制 HTTPS、要求更严的重定向校验等
注意:它"删"的是危险的授权方式和坏习惯,不是简单地把所有 secret 一锅端。
为啥公共端不用 Secret
要解开"要不要 secret"的谜,先得搞清楚:secret 是给谁用的。
这就引出 OAuth 里一个根本性的分类:机密客户端 vs 公共客户端。
先分清两类客户端
判断标准只有一个:这段代码、这个应用,能不能安全地把一个密码藏好、不让别人看到?
- 机密客户端(Confidential Client)
:跑在服务器上,比如你的后端服务、传统 Web 后端。它有"私密的机房",能把 client_secret 存在环境变量或密钥管理里,偷不走。 - 公共客户端(Public Client)
:跑在用户设备上或浏览器里,比如单页应用(SPA)、移动 App、桌面程序。它本质上"裸奔"在用户手里,你存在前端的 secret,用户用开发者工具一秒就能扒出来。
所以真相是:公共客户端从来就不该用 client_secret—— 不是 OAuth 2.1 不让它用,是它用了也等于没用。OAuth 2.1 只是把这个事实写进了规范。
PKCE 是怎么防截获的
那公共客户端不存 secret,怎么保证"换 token 的人"就是"拿授权码的人"?答案是PKCE(Proof Key for Code Exchange,读作"pixy")。
打个比方:你去存包,柜门用一把"一次性临时锁"锁上,钥匙你随身带着。别人就算中途捡到你掉的取件小票(授权码),没有那把随身钥匙(code_verifier),也打不开柜子。
技术上分三步:
1. 客户端先随机生成一个code_verifier(一串长随机串)。
2. 对它做 SHA256 + Base64URL 得到code_challenge,请求授权时只把 challenge 发给服务器。
3. 拿到授权码后,换 token 时把原始的code_verifier发给服务器,服务器自己算一遍 challenge 比对。中间人只截到授权码、没截到 verifier,就换不到 token。
一段可跑的 PKCE 代码
下面这段 Python(3.8+)代码,完整演示了"生成 verifier → 推导 challenge → 拼授权链接 → 用 verifier换token"的全过程。注意第4步:换 token 时只带code_verifier,不再发client_secret。
Python · 3.8+ 可运行示例(左右滑动查看完整代码)
import base64
import hashlib
import secrets
import urllib.parse
# 1. 生成 code_verifier(43~128 位随机字符串)
code_verifier = base64.urlsafe_b64encode(secrets.token_bytes(32)).rstrip(b"=").decode()
# 2. 用 SHA256 推导 code_challenge(S256 方法)
def gen_challenge(verifier: str) -> str:
digest = hashlib.sha256(verifier.encode("ascii")).digest()
return base64.urlsafe_b64encode(digest).rstrip(b"=").decode()
code_challenge = gen_challenge(code_verifier)
# 3. 拼接授权链接,带上 challenge(此时没有 client_secret)
auth_url = "https://auth.example.com/authorize?" + urllib.parse.urlencode({
"response_type": "code",
"client_id": "my_spa_app",
"code_challenge": code_challenge,
"code_challenge_method": "S256",
"redirect_uri": "https://app.example.com/callback",
})
# 4. 用户登录授权后,拿回 authorization_code,用 verifier 换 token
# 关键:公共客户端这里不传 client_secret
token_payload = {
"grant_type": "authorization_code",
"code": "<拿到的 authorization_code>",
"redirect_uri": "https://app.example.com/callback",
"client_id": "my_spa_app",
"code_verifier": code_verifier, # 用 verifier 代替 secret
}
# import requests
# resp = requests.post("https://auth.example.com/token", data=token_payload)
# print(resp.json())
把这段代码跑起来,你会直观看到:整条链路里,根本没有一个叫client_secret的字段出现。
三个最容易踩的坑
- 误区一:"以后所有应用都不用 secret 了。"
错。后端这类机密客户端照样要 secret,而且 OAuth 2.1 还要求它们也上 PKCE。 - 误区二:"PKCE 只给公共客户端用。"
错。OAuth 2.1 规定所有授权码流程都必须用 PKCE,机密客户端一样要。 - 误区三:"隐式模式省事,SPA 还能用。"
错。隐式授权已被废弃,SPA 请统一走"授权码 + PKCE"。
一句话:PKCE 是全员强制,secret 是机密客户端专属。两者不冲突。
2.0 与 2.1 一张表看懂
OAuth 2.0 与 2.1 速查(红=废弃 / 绿=强制)
谁还该留着 Secret
给你一个实战速判:
- 该弃用 secret 的
:纯前端 SPA、移动 App、桌面客户端、任何代码会下发到用户设备的应用。它们配 PKCE 即可。 - 必须保留 secret 的
:你的后端服务、服务端到服务端的机器间调用(M2M)、传统带后端的 Web 应用。它们既用 secret,也请务必加上 PKCE。 - 混合架构
:前端 SPA + 后端 BFF。前端走 PKCE(无 secret),后端代发请求时用自己的 secret。各司其职。
照着这张清单行动
读到这里,你可以立刻对照做三件事:
1.前端 / SPA / App 项目:检查授权流程是不是"授权码 + PKCE",如果是老旧的隐式模式或密码模式,排入重构。
2.后端机密客户端:确认 secret 存在安全的地方(环境变量 / 密钥库),并给授权码流程补上 PKCE。
3.新项目:默认就按 OAuth 2.1 设计 —— 公共端无 secret + PKCE,机密端 secret + PKCE。
把这篇文章转发给还在用隐式模式的前端同事,就是在帮他少踩一个生产事故。


