PKCE 解决什么问题
传统的授权码流程要求客户端有 client_secret。但手机 App、桌面程序、SPA 都是公开客户端,密钥没法安全保存——反编译或看源码就能拿到。PKCE 让客户端每次授权时临时生成一个随机串(verifier),把它的哈希(challenge)发给授权服务器,换 Token 时再出示原始串。
这样即使攻击者拦截了授权码,没有原始 verifier 也换不到 Token。整个过程不需要任何长期密钥。
S256 和 plain 的区别
- S256:challenge = BASE64URL(SHA256(verifier))。授权请求只带哈希,即使被截获也推不出 verifier。
- plain:challenge 就是 verifier 本身,等于没有保护,只为兼容极老的服务器,不要用。
长度规则
规范要求 verifier 是 43 到 128 个字符,字符集限定为 A-Z a-z 0-9 - . _ ~。本工具用 crypto.getRandomValues 生成随机字节再 Base64URL 编码,天然满足字符集要求。
完整流程中的位置
- 生成 verifier 与 challenge,把 verifier 存在本地(sessionStorage 或内存)。
- 授权请求带上
code_challenge与code_challenge_method。 - 用户在授权页登录同意,回调带回 code。
- 用 code 加原始 verifier 换取 Token。
功能说明
PKCE 生成器
对接 OAuth 2.0 第三方登录时,只要客户端是「公开客户端」(手机 App、桌面软件、纯前端页面),规范都要求用 PKCE。它需要两个随机串:code_verifier(原始随机串)和 code_challenge(它的哈希)。这个页面把两个都算好,还顺手拼出完整授权 URL。
生成的四样东西
- code_verifier:43 到 128 字符的随机串,客户端自己存着,换 Token 时出示。
- code_challenge:verifier 的 SHA256 再 Base64URL,放进授权请求。
- 授权 URL:拼好所有必填参数,可以直接在浏览器打开测试。
- 换 Token 请求体:POST 表单格式,含 code、verifier 与 client_id。
安全要点
- verifier 不能泄露:只在换 Token 时发一次,不要写进前端可读的 URL 或日志。
- 一次一用:每次授权都重新生成,不要复用。
- state 参数别省:PKCE 防不了 CSRF,还需要 state 做会话绑定。
- redirect_uri 必须精确匹配:授权服务器会严格比对,多一个斜杠都不行。
为什么这里能算 SHA256
用的是浏览器内置的 Web Crypto(crypto.subtle.digest),不需要联网也不需要第三方库。生成过程完全在本机完成,不会把 client_id 或任何参数发送出去。
使用步骤
1. 依次填写「Client ID」、「Redirect URI」、「授权端点」、「Scope」,单位与原表或文档保持一致。
2. 在「Challenge 方式」、「Verifier 长度」下拉中选择合适的选项,不确定时保持默认即可。
3. 点击「生成一组」按钮执行。
4. 在结果区核对输出结果,需要留档时手动复制。
常见问题
PKCE生成器能做什么?
生成 OAuth 2.0 PKCE 所需的 code_verifier 与 code_challenge:支持 S256 与 plain 两种方式。全部处理在浏览器本地完成,无需注册、无需安装。
生成的内容能直接用在正式环境吗?
结构可以直接用,工具已经按目标格式组织好了;涉及具体取值、命名、合规表述的部分仍需按你的实际场景逐项确认,不要让默认值直接上线。
生成时会把我填的内容发到服务器吗?
不会。拼装和格式化都在浏览器里完成,输入内容只存在于当前页面,关掉即释放。
参数该怎么选?
先用默认值生成一份看效果,再按需要微调单个参数。同时改动多个参数时不容易判断是哪一项起了作用,建议一次只改一处。
你可能还想问
这个工具需要联网才能用吗?
第一次打开页面需要联网加载,之后的计算与处理都在本地完成,断网也能继续操作。数据不经过服务器,也不受网络波动影响。
处理结果怎么保存或分享?
结果区支持一键复制,也可按页面提供的下载入口保存到本地;页面不做云端存储,关掉浏览器后需要重新处理。
速查在线工具箱