OAuth PKCE 生成
verifier + S256 challenge,顺手拼好授权链接
如何使用本工具
- 先填授权端点、client_id 和 redirect_uri,scope 按需要写,多个用空格隔开。
- state 已经自动随机生成,回调时必须原样比对,不要写死成固定值。
- 点「生成」换一组 verifier,长度默认 64 位,按 RFC 允许 43 到 128。
- S256 模式下前端只把 challenge 发给授权服务器,verifier 留到换 token 时才提交。
- 复制授权链接在浏览器打开,回调拿到 code 后用 POST 提交 code + verifier 换 token。
常见问题
Q:PKCE 到底防的是什么?
A:防授权码被截获。移动端和 SPA 没有安全的客户端密钥,授权码通过自定义 scheme 或重定向 URL 回来时,恶意 App 可能抢先注册同一个 scheme 把 code 拿走。有了 PKCE,攻击者只拿到 code 而没有 verifier,换不到 token,因为授权服务器比对的是 challenge 的哈希。
Q:S256 和 plain 怎么选?
A:只要能选就必须选 S256。plain 是把 verifier 原样当 challenge 发出去,只能防住「截获 code 但看不到请求」的场景,本身不含哈希保护。RFC 7636 明确写了:客户端有能力做 S256 就必须做 S256,plain 只留给做不了哈希的老实现。
Q:verifier 长度为什么限定 43 到 128?
A:这是 RFC 7636 的硬性要求,超出范围授权服务器应当拒绝。43 是 32 字节随机数 base64url 编码后的长度(不含填充),也正好对应 256 位熵。本工具默认 64 位,随机源是 crypto.getRandomValues,不是 Math.random。
Q:为什么 state 不能用固定值?
A:state 的作用是防 CSRF:攻击者把自己的授权码塞给你的回调地址,如果你不校验 state,就会用自己的账号绑上别人的授权,等于把数据交给了对方。state 必须每次随机生成并存在本地会话里,回调时做一次严格比对,不匹配就丢弃。
Q:challenge 末尾的等号去哪了?
A:被去掉了。PKCE 要求用 BASE64URL 编码,规范里明确说不要 padding,也就是不能有末尾的 =。同时 + 要换成 -、/ 要换成 _,否则放进 URL 查询串会被二次编码,比对时对不上。本工具的编码函数三步都做了。
Q:换 token 的时候 verifier 放在哪?
A:放在 POST 表单体里,字段名 code_verifier,和 code、grant_type=authorization_code、redirect_uri、client_id 一起提交。注意不要在 URL 上带 verifier,它一旦进了访问日志就等于泄露,PKCE 的保护也就没了。