OAuth 应用管理

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

基本概念

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

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

安装和卸载应用

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

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

   说明

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

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

查看已授权的应用

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

撤销应用授权

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

启用或禁用 OAuth 应用

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

编辑应用

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

删除应用

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

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