应用接入 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。