應用接入 OAuth 教程:授權碼、PKCE 與最小 scope
2026-11-17 · 原創·功能教程
應用接入 OAuth 教程:授權碼、PKCE 與最小 scope
本文面向第一次接觸應用接入的開發者,目標是在使用者授權後使用你的應用。整個流程應圍繞 OAuth 授權碼與 PKCE 展開,入口為 `/docs#docs-oauth`。開始前,先明確需要訪問的業務能力,以及憑證由誰保管。
1. 準備
- 閱讀入口文件,確認應用是否為公共客戶端;公共客戶端必須使用 S256。
- 按業務需要列出最小 scope,不要申請與當前功能無關的許可權。
- 明確餘額與用量是獨立許可權;不要把 ext token 放在瀏覽器前端。
2. 操作
1. 使用 OAuth 授權碼流程,並加入 PKCE。
2. 公共客戶端必須使用 S256。
3. 引導使用者授權時,只請求已確認的最小 scope。
4. 使用者授權後,在不暴露 ext token 的環境中完成後續呼叫邏輯,避免把 ext token 放到前端。
3. 結果檢視
接入完成後,檢查使用者是否完成授權、應用是否只獲得所需 scope,並檢視本應用用量。檢視餘額和用量時,應分別確認對應許可權,避免混用。
4. 安全注意
不要把 ext token 放在瀏覽器前端;不要擴大 scope 以圖省事;餘額與用量許可權獨立,應分別申請和校驗。若流程異常,先檢查 S256 配置、scope 範圍和 ext token 的存放位置。
完成配置後,可從 `/docs#docs-oauth` 檢視文件並在對應工具中驗證授權流程。對首次接入的團隊,建議先跑通最小授權鏈路,再按業務逐步增加所需 scope。