应用接入指南:如何使用 OAuth 与 PKCE 安全授权
2026-11-11 · 原创·功能教程
应用接入指南:如何使用 OAuth 与 PKCE 安全授权
对于需要授权登录、分档调用和查看本应用用量的应用开发者而言,安全的应用接入是构建服务的基础。本教程将指导您完成应用授权的准备工作、核心操作、结果查看及安全注意事项。
准备工作
在开始操作前,请确保您已了解应用接入的基本要求。本功能使用 OAuth 授权码流程与 PKCE(Proof Key for Code Exchange)机制。如果您开发的是公共客户端,必须使用 S256 作为 PKCE 的方法。请根据业务需求梳理所需的权限范围,遵循按业务申请最小 scope 的原则。
操作步骤
1. 发起授权请求:引导用户进入授权页面,请求相应的 scope 权限。请确保仅申请业务必需的最小 scope。
2. 处理授权码与 PKCE:用户同意授权后,系统会返回授权码。在此过程中,公共客户端必须使用 S256 进行 PKCE 验证,以确保请求的合法性。
3. 获取访问令牌:使用授权码和 PKCE 校验码换取访问令牌,以便后续调用接口。
结果查看与用量管理
成功获取令牌后,您可以在应用内调用相关接口。请注意,ext 余额权限与用量权限是独立的。如果您需要查看本应用的用量,请确保在申请 scope 时包含了相应的用量查看权限,从而实现分档调用和用量监控。
安全注意事项
在应用接入过程中,安全是重中之重。请务必遵守以下规则:
- 保护 ext token:千万不要把 ext token 放在浏览器前端代码中,这会导致令牌泄露风险。
- 权限隔离:ext 余额与用量权限独立,请严格按需分配,避免过度授权。
- 遵循最小权限原则:始终按业务申请最小 scope,减少潜在的安全隐患。
如需深入了解完整的接口规范与参数说明,请前往模型目录或对应工具体验,并在站内访问 `/docs#docs-oauth` 查阅详细文档。