助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
如何快速了解这个空间的核心内容?
有哪些近期更新的重点文档?
我应该从哪些文档开始阅读?
文档反馈
低代码项目
快速开始
智能体
工作流
应用
资源
发布
模型
多人协作
推广与变现

OAuth 应用管理

更新于: 2026-06-25 19:29:14

本文介绍如何管理 OAuth 应用,包括安装、卸载、启用、禁用、编辑和删除 OAuth 应用等。

说明

  • 角色限制:在扣子企业版(企业标准版、企业旗舰版)中,仅组织超管组织管理员有权限管理 OAuth 应用,包括创建、编辑、删除、启用、禁用、安装和卸载 OAuth 应用,以及对应用进行授权操作。
  • 数量限制:扣子个人版中,每个用户最多创建 10 个 OAuth 应用。扣子企业版中,一个企业下最多创建 100 个 OAuth 应用。

基本概念

  • AppAuth 授权:应用以自身身份去访问扣子编程的资源。例如,一个后端服务需要从扣子编程获取数据。
  • OBO 授权: 应用以用户的身份去访问扣子编程的资源。例如,在跨企业协作场景中,外部应用需要访问本企业的资源时,OBO 应用可以确保这些操作是以用户身份进行的,保护企业数据的安全。

不同的扣子 OAuth 授权对应的授权类型和适用的客户端类型如下表所示。

授权类型

授权方式

客户端类型

OBO 授权

OAuth 授权码授权

Web 后端应用

OBO 授权

OAuth PKCE

移动端/PC 桌面端/单页面应用

OBO 授权

OAuth 设备授权

TV端/设备应用/类命令行程序

AppAuth 授权

OAuth JWT 授权(开发者)

服务类应用

安装和卸载应用

以下操作仅适用于扣子企业版,且仅组织超管组织管理员有权限安装和卸载应用。
应用安装管理页面,你可以查看企业下已安装的应用,并处理 OBO 应用的安装申请。

注意

卸载应用后,将删除 OAuth 应用当前正在使用的所有访问令牌。此操作会导致应用程序无法正常访问扣子 API,请谨慎操作。

  1. 登录扣子编程
  2. 在左侧导航栏选择 API & SDK。
  3. 在顶部单击授权 页签 ,单击应用安装管理页签。
    Image
  4. 应用安装管理页面,超级管理员可以查看已安装的应用,安装状态说明如下:
    • 已安装 AppAuth:表示该 OAuth 应用已创建并完成授权。
    • 已安装 OBO:表示该 OAuth 应用已完成授权,且已获得访问本企业资源的权限。
    • 未安装 OBO:用户已发起 OAuth 应用的安装申请,但超级管理员尚未同意安装。

    说明

    在应用安装管理页面展示的应用包括:

    • 已完成 OAuth 授权的服务类应用。
    • 曾获取过访问令牌的 OBO 应用,包括 Web 后端应用、TV端/设备应用/类命令行程序、移动端/PC 桌面端/单页面应用。
  5. 安装和卸载应用。
    • 对于未安装的 OBO 应用,超级管理员可以单击操作列中的安装,授权 OAuth 应用。
    • 对于已安装的应用,超级管理员单击操作列中的卸载,可以取消 OAuth 应用的授权。
      卸载的应用将不在应用安装管理页面展示。

查看已授权的应用

以下操作仅适用于扣子个人版。
已授权的应用页签下,可查看已授权的应用列表。

说明

  • 对于后端应用,此处展示已完成 OAuth 授权的应用列表。
  • 对于 Web 应用,此处展示曾获取过访问令牌的应用列表。

撤销应用授权

以下操作仅适用于扣子个人版。
已授权的应用页签下,单击撤销授权,可以删除此应用的访问令牌。

说明

撤销授权将删除 OAuth 应用当前正在使用的所有访问令牌。此操作导致应用程序无法正常访问扣子 API,请谨慎使用此功能。

Image

启用或禁用 OAuth 应用

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

编辑应用

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

删除应用

如果某个应用后续不再使用,你可以删除应用。注意,删除应用后,数据将无法恢复,请谨慎操作。

  1. 授权 > OAuth 应用页面的应用列表中找到目标应用。
  2. 操作列单击删除,删除 OAuth 应用。
    删除 OAuth 应用会同时撤销所有相关的授权。
    Image