开发工具/API 参考/鉴权/OAuth 应用管理
更新于: 2026-06-25 19:29:14
本文介绍如何管理 OAuth 应用,包括安装、卸载、启用、禁用、编辑和删除 OAuth 应用等。
说明
- 角色限制:在扣子企业版(企业标准版、企业旗舰版)中,仅组织超管和组织管理员有权限管理 OAuth 应用,包括创建、编辑、删除、启用、禁用、安装和卸载 OAuth 应用,以及对应用进行授权操作。
- 数量限制:扣子个人版中,每个用户最多创建 10 个 OAuth 应用。扣子企业版中,一个企业下最多创建 100 个 OAuth 应用。
基本概念
- AppAuth 授权:应用以自身身份去访问扣子编程的资源。例如,一个后端服务需要从扣子编程获取数据。
- OBO 授权: 应用以用户的身份去访问扣子编程的资源。例如,在跨企业协作场景中,外部应用需要访问本企业的资源时,OBO 应用可以确保这些操作是以用户身份进行的,保护企业数据的安全。
不同的扣子 OAuth 授权对应的授权类型和适用的客户端类型如下表所示。
安装和卸载应用
以下操作仅适用于扣子企业版,且仅组织超管和组织管理员有权限安装和卸载应用。
在应用安装管理页面,你可以查看企业下已安装的应用,并处理 OBO 应用的安装申请。
注意
卸载应用后,将删除 OAuth 应用当前正在使用的所有访问令牌。此操作会导致应用程序无法正常访问扣子 API,请谨慎操作。
- 登录扣子编程。
- 在左侧导航栏选择 API & SDK。
- 在顶部单击授权 页签 ,单击应用安装管理页签。

- 在应用安装管理页面,超级管理员可以查看已安装的应用,安装状态说明如下:
- 已安装 AppAuth:表示该 OAuth 应用已创建并完成授权。
- 已安装 OBO:表示该 OAuth 应用已完成授权,且已获得访问本企业资源的权限。
- 未安装 OBO:用户已发起 OAuth 应用的安装申请,但超级管理员尚未同意安装。
说明
在应用安装管理页面展示的应用包括:
- 已完成 OAuth 授权的服务类应用。
- 曾获取过访问令牌的 OBO 应用,包括 Web 后端应用、TV端/设备应用/类命令行程序、移动端/PC 桌面端/单页面应用。
- 安装和卸载应用。
- 对于未安装的 OBO 应用,超级管理员可以单击操作列中的安装,授权 OAuth 应用。
- 对于已安装的应用,超级管理员单击操作列中的卸载,可以取消 OAuth 应用的授权。
卸载的应用将不在应用安装管理页面展示。
查看已授权的应用
以下操作仅适用于扣子个人版。
在已授权的应用页签下,可查看已授权的应用列表。
说明
- 对于后端应用,此处展示已完成 OAuth 授权的应用列表。
- 对于 Web 应用,此处展示曾获取过访问令牌的应用列表。
撤销应用授权
以下操作仅适用于扣子个人版。
在已授权的应用页签下,单击撤销授权,可以删除此应用的访问令牌。
说明
撤销授权将删除 OAuth 应用当前正在使用的所有访问令牌。此操作导致应用程序无法正常访问扣子 API,请谨慎使用此功能。

启用或禁用 OAuth 应用
创建 OAuth 应用后,此应用默认为启用状态。禁用应用操作将暂时禁用当前应用所有的访问令牌,您的应用在禁用期间将无法正常访问扣子 API。重新启用应用后,访问令牌将恢复扣子 API 的访问权限。

编辑应用
你可以在授权 > OAuth 应用页面中找到待编辑的应用,并在操作列单击修改图标,修改已创建的 OAuth 应用。暂不支持修改应用类型。

删除应用
如果某个应用后续不再使用,你可以删除应用。注意,删除应用后,数据将无法恢复,请谨慎操作。
- 在授权 > OAuth 应用页面的应用列表中找到目标应用。
- 在操作列单击删除,删除 OAuth 应用。
删除 OAuth 应用会同时撤销所有相关的授权。
