设置行级访问权限控制 | OceanBase 文档中心

设置行级访问权限控制

更新时间：2023-11-10 15:01:06

OceanBase 数据库兼容了 Oracle 的 Label Security 功能，可以在行级别对访问进行控制，保证读写数据的安全。

Label Security 是强制访问控制的一种方式，通过在表中添加一个 Label 列来记录每行的 Label 值，在访问时通过比较用户的 Label 和数据的 Label，达到约束主体（用户）对客体（表中的数据）访问的目的。

使用限制

OceanBase 数据库目前仅支持在 Oracle 租户模式下的 Label Security 功能。

示例

步骤一：解锁用户

OceanBase 数据库提供了内置的安全管理员 LBACSYS 来管理和使用该功能，安全管理员可以通过创建安全策略、定义策略中的 Label、设置用户的 Label，来定制自己的安全策略。一个安全策略可以应用到多张表上，一张表也可以应用多个安全策略。每当一个安全策略被应用，这张表上自动会添加一列，用于该安全策略的访问控制。

使用 sys 用户登录到 Oracle 租户。
解锁 LBACSYS 用户。

OceanBase 数据库默认创建了 LBACSYS 用户，其密码固定为 LBACSYS。该用户处于锁定状态，使用 Label Security 功能需要先启用该用户。
```
obclient> ALTER USER LBACSYS ACCOUNT UNLOCK;
```

步骤二：创建标签安全策略

使用安全管理员 LBACSYS 用户登录到 Oracle 租户。
创建策略 MY_POLICY。

有关创建新的标签安全策略的详细信息，请参见 SA_SYSDBA.CREATE_POLICY。

示例如下：
```
obclient> CALL SA_SYSDBA.CREATE_POLICY('MY_POLICY','MY_LABEL','');
```

步骤三：为标签安全策略创建级别

使用安全管理员 LBACSYS 用户登录到 Oracle 租户。

创建级别 Level 并指定其短名称和长名称。

有关创建级别的详细信息，请参见 SA_COMPONENTS.CREATE_LEVEL。

示例如下：

obclient> CALL SA_COMPONENTS.CREATE_LEVEL('MY_POLICY', 100, 'PUBLIC','Public Level');

obclient> CALL SA_COMPONENTS.CREATE_LEVEL('MY_POLICY', 200, 'INTERNAL','Internal Level');

obclient> CALL SA_COMPONENTS.CREATE_LEVEL('MY_POLICY', 300, 'HIGH', 'High Level');

obclient> SELECT * FROM sys.ALL_VIRTUAL_TENANT_OLS_COMPONENT_AGENT;
+-----------+-----------------------+------------------------------+------------------------------+--------------------+-----------+----------+------------+----------------+-------------+
| TENANT_ID | LABEL_SE_COMPONENT_ID | GMT_CREATE                   | GMT_MODIFIED                 | LABEL_SE_POLICY_ID | COMP_TYPE | COMP_NUM | SHORT_NAME | LONG_NAME      | PARENT_NAME |
+-----------+-----------------------+------------------------------+------------------------------+--------------------+-----------+----------+------------+----------------+-------------+
|      1002 |      1101710651032553 | 30-DEC-21 02.35.19.069966 PM | 30-DEC-21 02.35.19.069966 PM |   1101710651032553 |         0 |      100 | PUBLIC     | PUBLIC LEVEL   | NULL        |
|      1002 |      1101710651032554 | 30-DEC-21 02.35.25.787711 PM | 30-DEC-21 02.35.25.787711 PM |   1101710651032553 |         0 |      200 | INTERNAL   | INTERNAL LEVEL | NULL        |
|      1002 |      1101710651032555 | 30-DEC-21 02.35.31.772544 PM | 30-DEC-21 02.35.31.772544 PM |   1101710651032553 |         0 |      300 | HIGH       | HIGH LEVEL     | NULL        |
+-----------+-----------------------+------------------------------+------------------------------+--------------------+-----------+----------+------------+----------------+-------------+
3 rows in set

步骤四：创建数据标签 Label

使用安全管理员 LBACSYS 用户登录到 Oracle 租户。

创建数据标签 Label 并查看结果。

有关创建数据标签的详细信息，请参见 SA_LABEL_ADMIN.CREATE_LABEL。

示例如下：

obclient> DELIMITER /
obclient> BEGIN
            SA_LABEL_ADMIN.CREATE_LABEL('MY_POLICY',10000,'PUBLIC',TRUE);
            SA_LABEL_ADMIN.CREATE_LABEL('MY_POLICY',20000,'INTERNAL',TRUE);
            SA_LABEL_ADMIN.CREATE_LABEL('MY_POLICY',30000, 'HIGH',TRUE);
          END;
         /
Query OK, 0 rows affected

obclient> DELIMITER ;
obclient> SELECT * FROM sys.ALL_VIRTUAL_TENANT_OLS_LABEL_AGENT;
+-----------+-------------------+------------------------------+------------------------------+--------------------+-----------+----------+------+
| TENANT_ID | LABEL_SE_LABEL_ID | GMT_CREATE                   | GMT_MODIFIED                 | LABEL_SE_POLICY_ID | LABEL_TAG | LABEL    | FLAG |
+-----------+-------------------+------------------------------+------------------------------+--------------------+-----------+----------+------+
|      1002 |  1101710651032553 | 30-DEC-21 02.41.06.668980 PM | 30-DEC-21 02.41.06.668980 PM |   1101710651032553 |     10000 | PUBLIC   |    1 |
|      1002 |  1101710651032554 | 30-DEC-21 02.42.09.740930 PM | 30-DEC-21 02.42.09.740930 PM |   1101710651032553 |     20000 | INTERNAL |    1 |
|      1002 |  1101710651032555 | 30-DEC-21 02.42.09.750423 PM | 30-DEC-21 02.42.09.750423 PM |   1101710651032553 |     30000 | HIGH     |    1 |
+-----------+-------------------+------------------------------+------------------------------+--------------------+-----------+----------+------+
3 rows in set

步骤五：指定用户的 Label

以 sys 用户登录到 Oracle 租户，创建用户 user1 并授予用户 user1 除 GRANT OPTION 以外所有当前用户拥有的权限。

obclient> CREATE USER user1 IDENTIFIED BY ******;
Query OK, 0 rows affected

obclient> GRANT ALL PRIVILEGES TO user1;
Query OK, 0 rows affected

以安全管理员 LBACSYS 登录，为用户 user1 指定 Label。

有关为用户指定标签的详细信息，请参见 SA_USER_ADMIN.SET_LEVELS。

obclient> CALL SA_USER_ADMIN.SET_LEVELS('MY_POLICY', 'user1', 'HIGH','PUBLIC', 'PUBLIC', 'PUBLIC');
Query OK, 0 rows affected

obclient> SELECT * FROM sys.ALL_VIRTUAL_TENANT_OLS_USER_LEVEL_AGENT;
+-----------+------------------------+------------------------------+------------------------------+------------------+--------------------+---------------+---------------+---------------+-----------+
| TENANT_ID | LABEL_SE_USER_LEVEL_ID | GMT_CREATE                   | GMT_MODIFIED                 | USER_ID          | LABEL_SE_POLICY_ID | MAXIMUM_LEVEL | MINIMUM_LEVEL | DEFAULT_LEVEL | ROW_LEVEL |
+-----------+------------------------+------------------------------+------------------------------+------------------+--------------------+---------------+---------------+---------------+-----------+
|      1002 |       1101710651032553 | 30-DEC-21 04.04.06.712035 PM | 30-DEC-21 04.04.06.712035 PM | 1101710651032553 |   1101710651032553 |           300 |           100 |           100 |       100 |
+-----------+------------------------+------------------------------+------------------------------+------------------+--------------------+---------------+---------------+---------------+-----------+
1 row in set

步骤六：将标签策略应用到表上

以 user1 用户登录到 Oracle 租户，创建表 tbl1。

obclient> CREATE TABLE tbl1(col1 INT,col2 INT);
Query OK, 0 rows affected

以安全管理员 LBACSYS 登录，将策略 MY_POLICY 应用到表 tbl1 上。

有关将指定的策略添加到表中的详细信息，请参见 SA_POLICY_ADMIN.APPLY_TABLE_POLICY。
```
obclient> CALL SA_POLICY_ADMIN.APPLY_TABLE_POLICY('MY_POLICY','user1', 'tbl1', '', '', '');
 Query OK, 0 rows affected
```

步骤七：测试标签安全策略

向表中插入数据，根据查询结果进行验证。

以 user1 用户登录，在 tbl1 表中插入 col1 和 MY_LABEL 两列数据。

obclient> INSERT INTO tbl1 VALUES(1,1,10000);
Query OK, 1 row affected

obclient> INSERT INTO tbl1(MY_LABEL) VALUES(20000);
Query OK, 1 row affected

obclient> INSERT INTO tbl1(col1) VALUES (2);
Query OK, 1 row affected

obclient> COMMIT;
Query OK, 0 rows affected

在 user1 用户下设置 SESSION LABEL 和 ROW LABEL。

有关设置当前数据库会话的标签的详细信息，请参见 SA_SESSION.SET_LABEL；有关设置当前数据库会话的默认行标签值，请参见 SA_SESSION.SET_ROW_LABEL。

obclient> CALL SA_SESSION.SET_LABEL('MY_POLICY', 'INTERNAL');
Query OK, 0 rows affected

obclient> CALL SA_SESSION.SET_ROW_LABEL('MY_POLICY', 'INTERNAL');
Query OK, 0 rows affected

obclient> SELECT SA_SESSION.LABEL('MY_POLICY') FROM DUAL;
+-------------------------------+
| SA_SESSION.LABEL('MY_POLICY') |
+-------------------------------+
| INTERNAL                      |
+-------------------------------+
1 row in set

obclient> SELECT SA_SESSION.ROW_LABEL('MY_POLICY') FROM DUAL;
+-----------------------------------+
| SA_SESSION.ROW_LABEL('MY_POLICY') |
+-----------------------------------+
| INTERNAL                          |
+-----------------------------------+
1 row in set

进行查询，可以看到用户 user1 可以访问到 Level 为 INTERNAL 以下级别的数据。

obclient> SELECT * FROM tbl1;
+------+------+----------+
| COL1 | COL2 | MY_LABEL |
+------+------+----------+
|    1 |    1 |    10000 |
| NULL | NULL |    20000 |
|    2 | NULL |    10000 |
+------+------+----------+
3 rows in set

修改 Label 后，再次查询，可以看到用户 user1 只能访问到 Level 为 PUBLIC 级别的数据。

obclient> CALL SA_SESSION.SET_LABEL('MY_POLICY', 'PUBLIC');
Query OK, 0 rows affected

obclient> CALL SA_SESSION.SET_ROW_LABEL('MY_POLICY', 'PUBLIC');
Query OK, 0 rows affected

obclient> SELECT * FROM tbl1;
+------+------+----------+
| COL1 | COL2 | MY_LABEL |
+------+------+----------+
|    1 |    1 |    10000 |
|    2 | NULL |    10000 |
+------+------+----------+
2 rows in set