PKCE 生成與 S256 校驗
生成安全的 PKCE verifier 與 challenge,比對 S256,並在本機生成 OAuth 請求範例。
生成 verifier 與 S256 challenge
生成模式使用密碼學安全隨機位元組,從 RFC 7636 規定的字元集中無偏抽樣,輸出 43–128 字元的 code_verifier,預設長度為 64。state 與 nonce 分別使用獨立的 32 位元組隨機值,並去除 Base64URL 填充。點選執行後才生成,不自動發出請求。
計算與比對既有參數
計算模式嚴格使用輸入的 verifier,不裁剪空格或進行 Unicode 正規化。S256 對 ASCII 位元組執行 SHA-256,再做不帶 = 填充的 Base64URL 編碼。比對模式要求規範的 43 字元 challenge,並以 matches: true 或 false 表示結果;不相符不等於格式錯誤。格式合規不能證明 verifier 具有隨機性。
RFC 7636 標準向量
附錄 B 的公開 verifier dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk 對應 E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM。範例會載入這個公開測試值,不能用於真實授權流程。
生成兩階段請求範例
勾選請求範例後,填寫已註冊的端點、用戶端 ID 和回呼 URI。授權 URL 包含 code_challenge 與 code_challenge_method=S256,不包含 code_verifier;權杖表單才包含原始 verifier。未填寫授權碼時使用佔位值。用戶端驗證須依註冊設定另行處理,工具不會虛構 client secret。端點要求 HTTPS,本機回環 HTTP 除外;支援自訂協定回呼 URI。工具不會存取這些位址。
接入真實應用時
每次授權都應使用獨立 verifier,並將其與目前授權嘗試關聯,只傳送給已註冊的權杖端點。state 須依 OAuth 流程儲存與核對,OpenID Connect 的 nonce 也須依其規則處理。本工具不執行登入,不驗證身分提供方,僅提供 S256,不生成不建議的 plain。結果與剪貼簿可能包含 verifier,測試後請清空;頁面不使用 localStorage,也不將輸入傳送至伺服器。
規範與原始碼
常見問題
verifier 與 challenge 有何不同?
verifier 是由用戶端保留的隨機秘密,S256 challenge 是其 SHA-256 Base64URL 結果,用於授權請求。
工具會登入或存取端點嗎?
不會。工具僅在本機生成數值與文字範例,用戶端驗證與回呼校驗須由應用處理。
參數相符就代表登入安全嗎?
不代表。S256 相符只說明轉換一致,不能證明隨機性、state 處理或授權伺服器身分。
其他語言
參考資料
我們如何確保結果正確
我們使用以下自動化測試驗證此工具。下方保留測試案例的原始名稱,方便查看實際斷言及重現。
- 驗證方法
- 比較 verifier 到 S256 challenge 的轉換,並檢查長度、字母表及 state/nonce 分離。
- 對比依據
- RFC 7636 附錄 B 與 Node.js crypto SHA-256。
- 驗證範圍
- 只覆蓋這些樣本和邊界;不代表所有輸入均已證明正確。
測試原始碼與案例(點選檔名檢視)
-
query-auth-tools.test.js
- PKCE RFC 7636 Appendix B and independent Node SHA-256 vectors
- PKCE CSPRNG generation spans both limits, independent state/nonce and unique values
這些測試涵蓋列出的樣本和邊界,不代表所有輸入都已證明正確。往返測試和使用同一依賴套件的檢查,不屬於獨立交叉驗證。