---
title: "自动授权 - 开发者中心 ODC V4.3.2 | OceanBase 文档中心"
description: 自动授权 本文档旨在介绍如何新建和管理自动授权规则。 背景信息 OceanBase 开发者中心（OceanBase Developer Center，ODC）支持拥有特殊权限的用户（系统管理员）定义自动授权规则。拥有该特殊权限的用户可以创建/修改/查看/停用自动授权规则。 自动授权是指对满足某些条件的用户，例如姓名、…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lqS5SYzz_YEAAAAAAAAAAAAADiGDAQ/original) 开发者中心 ODCV 4.3.2

# 自动授权

更新时间：2026-04-13 15:31:21

[编辑](https://github.com/oceanbase/odc-doc/edit/V4.3.2/zh-CN/700.database-change-management/100.user-permission-and-management/200.manage-automatic-authorization-rules.md)  

本文档旨在介绍如何新建和管理自动授权规则。

## 背景信息

OceanBase 开发者中心（OceanBase Developer Center，ODC）支持拥有特殊权限的用户（系统管理员）定义自动授权规则。拥有该特殊权限的用户可以创建/修改/查看/停用自动授权规则。

自动授权是指对满足某些条件的用户，例如姓名、组织部门、登录方式等信息符合某些判断条件，在初次登录或创建用户时自动授予特定的角色或权限，以避免大量冗余授权操作的一项功能。

本文档以创建 Grant system_admin for deptB 自动授权规则为例，memberOf.department 中的用户名包含 deptB 时，为该用户授予 system_admin 角色。

## 新建自动授权规则

1. 用户[在 ODC 上集成 OAuth2 且认证登录 ODC 后](https://www.oceanbase.com/docs/common-odc-1000000001418037)，OAuth2 授权系统返回数据结构。例如：

   ```json
   {
     "id": 1,
     "name": "username",
     "mail": "example@email.com",
     "memberOf": {
       "department": [
         {
           "name": "deptA",
           "description": "this is a department"
         },
         {
           "name": "deptB",
           "description": "this is a department"
         }
       ],
       "extra": "some other info"
     }
   }

   ```

   对于该数据，可以使用不同表达式获取对应的值。例如：

   | **expression** | **result** |
   | --- | --- |
   | id | 1 |
   | memberOf.department[0].name | deptA |
   | memberOf.department[*].name | ["deptA", "deptB"] |
 2. 通过第三方登录 Web 版 ODC 后，在项目协同窗口的左侧导航栏中，单击 **用户权限** > **授权规则** > **新建规则**。

   ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/1000.user-permission-and-management/2.manage-automatic-authorization-rules/1.png)
 3. 在 **新建规则** 面板中需指定以下信息以创建新的规则。

   ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/1000.user-permission-and-management/2.manage-automatic-authorization-rules/2.png)

   | 信息项 | 说明 |
   | --- | --- |
   | 规则名称 | 指定该规则的名称，不可重名。 |
   | 状态 | 选择 **启用** / **停用** 该授权规则。    规则状态默认为 **启用**，可手动更改为 **停用** 。被停用的规则将不能被访问。 |
   | 触发事件 | 当前只能选择系统内置的事件，不同事件对应不同的触发时机。 |
   | 匹配条件（可选） | 单击 **添加条件** 按钮并指定以下四个字段创建匹配条件。    - **对象**：存储了触发条件和执行行为所需的信息，可以为复杂嵌套对象，包括 array、list 和 map；也可以为字符串和数字等简单对象。   - **表达式**：目标在对象中所处的索引，不同类型对象的索引方式有区别。   - **操作**：支持包含、匹配和等于操作。   - **值**：目标值。       #### 说明           - 如未选择添加匹配条件，表示触发选择的事件则会无条件执行动作。         - 选择 **匹配** 作为匹配条件时，匹配值需为正则表达式。 |
   | 执行动作（可选） | 选择 **授予角色** / **授予连接访问权限** 并配置对应的角色名称/公共连接名称。   #### 说明    如未选择执行动作，表示无论是否满足匹配条件均不执行任何动作。 |
   | 备注（可选） | 为规则添加备注信息，非必填项。 |
 4. 指定上述信息后，单击面板右下角的 **保存** 按钮以完成创建规则。
 5. 创建完成后，可在自动授权列表中查看创建的规则。

   ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/1000.user-permission-and-management/2.manage-automatic-authorization-rules/3.png)

## 查看自动授权规则

### 自动授权规则列表

如上图所示，在自动授权规则列表中显示并提供了以下基本信息。

| 信息项 | 说明 |
| --- | --- |
| 规则名称 | 显示规则的名称信息。 |
| 创建人 | 显示创建发起人。    单击搜索图标![搜索](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/icon/search.jpg)，可搜索和筛选创建人。 |
| 状态 | 显示规则当前状态： **启用** 或者 **停用** 。    单击筛选图标![筛选](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/icon/filter.jpg)，可筛选状态。 |
| 创建时间 | 显示对规则进行 **编辑** 的最新历史操作时间。    支持以升序或降序方式显示创建时间。 |
| 启用状态 | 支持启用/停用规则。 |
| 操作 | 支持 **查看** 、 **编辑** 和 **删除** 规则。 |

### 查看规则

![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/1000.user-permission-and-management/2.manage-automatic-authorization-rules/4.png)

在自动授权规则信息 **操作** 栏下，单击 **查看** 按钮以弹出 **规则信息** 面板。面板中包括以下信息。

| 信息项 | 说明 |
| --- | --- |
| 规则信息 | 显示 **规则名称、触发事件、匹配条件、执行动作、角色、备注** 等创建规则时您指定的信息。 |
| 操作信息 | 显示 **创建人**、**创建时间** 和 **更新时间** 等信息。 |

### 编辑规则

![5](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/1000.user-permission-and-management/2.manage-automatic-authorization-rules/5.png)

在自动授权规则信息 **操作** 栏下，单击 **编辑** 按钮以弹出 **编辑规则** 面板。

**编辑规则** 面板中显示新建规则时所指定的所有信息项，可修改此类信息项以编辑规则。

## 相关文档

- [用户和角色](https://www.oceanbase.com/docs/common-odc-1000000001418118)
 - [SSO 集成](https://www.oceanbase.com/docs/common-odc-1000000001418037)

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线