大数跨境

OAuth 2.1 来了:Client Secret 该扔还是留?

OAuth 2.1 来了:Client Secret 该扔还是留? Python程序员
2026-10-30
0
导读:OAuth 2.1 没消灭 client_secret,只是规定公共客户端用 PKCE 替代;机密客户端仍须保留。

图片

你大概在哪儿听过一句话:"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 是怎么防截获的 配图

一段可跑的 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 速查(红=废弃 / 绿=强制)

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。

把这篇文章转发给还在用隐式模式的前端同事,就是在帮他少踩一个生产事故。

Python程序员

有料有趣的技术公众号


美编二维码.jpg

扫码关注、一同进步


【声明】内容源于网络
0
0
Python程序员
1234
内容 2525
粉丝 0
Python程序员 1234
总阅读0
粉丝0
内容2.5k