ABAC DENY 策略 (Beta)

Important

ABAC DENY 策略处于 Beta 版中。 DENY 策略附加到元存储、目录或架构级别,并在受支持的安全对象类型上拒绝 MANAGE ACCESS CONTROL 权限。 参见 支持的可安全类型和权限。 若要跨元存储中的所有目录附加 DENY 策略,请参阅 元存储级别的 ABAC 策略(Beta)。

ABAC DENY 策略显式拒绝对受管理标记符合条件的可保护对象上的主体的 Unity Catalog 权限,且始终优先于任何授权。 本页介绍如何创建、编辑、列出和删除 ABAC DENY 策略、拒绝 MANAGE ACCESS CONTROL的含义以及当前范围和限制。

可以使用目录资源管理器、SQL、 REST API、 Terraform 或 Databricks SDK 创建和管理 ABAC DENY 策略。

有关 ABAC 和核心概念的概述(包括治理标签以及 has_tag 和 has_tag_value 等内置函数),请参阅 基于属性的访问控制 (ABAC) 的核心概念。

计算要求

使用 SQL 创建、修改或删除 DENY 策略需要运行 Databricks Runtime 18 LTS 或更高版本的 经典计算资源 。

注意

Databricks Runtime 18 比 Databricks Runtime 18.0、18.1 和 18.2 更新。 以前会作为后续编号版本发布的功能,现在改为作为 Databricks Runtime 18 的按日期命名更新发布。 有关详细信息,请参阅 关于统一发行说明。

什么是 DENY 策略

DENY 策略是基于属性的访问控制策略,它显式拒绝指定主体对受管理标记与策略条件匹配的安全对象上的 Unity Catalog 特权。 每次检查访问时,Unity Catalog 都会根据策略范围内每个可保护对象上的受管标签来评估策略的 WHEN 条件,并拒绝对每个匹配的可保护对象授予该权限。

DENY 策略优先于对相同特权的任何授权,且不能被单独授权所覆盖。

DENY 策略受以下规则的约束:

  • DENY 始终优先。 DENY 策略优先于对相同权限的任何授予,包括通过继承、组成员身份或通过 对象所有权隐式持有的授予。 任何单个授权都不能覆盖处于活动状态的 DENY。
  • Metastore管理员 总是默认免于此。 元存储管理员永远不会受到针对 MANAGE ACCESS CONTROL 的 DENY 策略的影响,包括元存储级别的 DENY 策略,这可确保始终有路径来修改或删除任何 DENY 策略。
  • DENY 向下继承。 拒绝权限本身会像授予遵循 权限继承 一样,沿着对象层次结构向下继承。 目录中的 DENY 策略会拒绝对该目录中每个当前和将来对象的特权,而模式上的 DENY 策略会拒绝对该模式中每个当前和将来对象的该特权。
  • 重叠的 DENY 策略组合在一起,应用限制性最大的结果。 当多个 DENY 策略应用于同一主体时,它们的效果将联合在一起。 一个 DENY 策略无法豁免被另一个 DENY 策略针对的主体。 如果任何适用的政策拒绝该特权,则该政策将被拒绝。
  • DENY 策略独立于授权。 与仅删除显式授予的特权的 REVOKE 不同,DENY 策略不依赖于现有授权。 可以对从未授予的权限设置拒绝,删除授权不会删除 DENY 策略。 拒绝策略在显式删除之前一直有效。

DENY 策略可以在其条件中引用自己创建的受治理标记,也可以引用 Azure Databricks 预定义的系统标记。

DENY 策略与行筛选器和列掩码策略有两种不同:

  • 行筛选器和列掩码策略限制用户可以访问的数据内容。 DENY 策略确定主体根本是否可以执行一项操作,例如管理访问控制。
  • 行筛选器和列掩码策略需要用户定义的函数(UDF)来实现筛选器或掩码。 DENY 策略不使用 UDF。 条件直接写在策略定义中。

拒绝管理访问控制是什么意思?

MANAGE ACCESS CONTROL 是 MANAGE 权限的子权限,用于控制访问管理,例如授予和撤销权限、转移所有权以及管理 ABAC 策略。 可以被拒绝,但不能被批准。 详情请参见 “管理访问控制”。

DENY 策略可用于拒绝使用 MANAGE ACCESS CONTROL 权限,以防止指定主体(包括对象所有者)对策略范围内的对象执行访问管理操作。 它会移除该权限所控制的访问管理功能,无论主体是如何持有这些功能的,无论是通过 MANAGE 特权,还是通过对象所有权隐式获得。

在受影响的对象上,被拒绝访问的主体将失去执行以下操作的能力:

拒绝 MANAGE ACCESS CONTROL 并不会剥夺主体查看对象元数据的能力。 具有 MANAGE 的主体或对象所有者仍然可以看到该对象的存在,并且仍然可以行使 MANAGE、其其他权限或所有权所赋予的所有其他能力。 他们只失去了上述的访问管理能力。

拒绝 MANAGE ACCESS CONTROL 并不能阻断主体共享数据的所有途径。 参见 数据共享的考虑因素。

DENY 策略示例

以下策略拒绝所有账户用户对 sensitive 中所有标记了 data_admins 的表的 MANAGE ACCESS CONTROL 权限,但 catalog_a 组除外。 受影响的主体,包括表所有者,将失去授予或撤销权限、更改所有权或管理这些表行过滤器和列掩码的能力:

CREATE POLICY deny_manage_access_control_sensitive_tables
ON CATALOG catalog_a
COMMENT 'Prevent non-admins from managing permissions on sensitive tables'
TO `account users`
EXCEPT `data_admins`
DENY MANAGE ACCESS CONTROL
FOR TABLES
WHEN has_tag('sensitive');

以下策略对指定组拒绝在 catalog_a 中所有架构上的 MANAGE ACCESS CONTROL,但 data_admins 除外。 由于 DENY 会向下继承,因此受影响的主体也失去了在这些架构中管理对对象的访问权限的能力:

CREATE POLICY deny_designated_users_catalog_access
ON CATALOG catalog_a
COMMENT 'Prevent designated users from managing access on catalog objects'
TO `designated_users`
EXCEPT `data_admins`
DENY MANAGE ACCESS CONTROL
FOR SCHEMAS;

支持的可保护类型和权限

以下安全对象类型支持一个特权 MANAGE_ACCESS_CONTROL 的 DENY 策略。 一个策略适用于一种可保护类型。 Unity Catalog 会在创建策略时根据可保护对象类型验证该权限是否有效。

可担保类型 MANAGE_ACCESS_CONTROL
Catalog ✓
Schema ✓
Table ✓
Volume ✓
功能 ✓
Model ✓
机密 ✓

这是 FOR 子句中支持的可保护对象类型列表。 将策略附加到目录或架构时,DENY 将继承到该目录或架构中的所有对象,甚至包括类型不受 FOR 子句支持的对象。

在 SQL 中,在 FOR 后使用 securable type 的复数形式,例如 DENY MANAGE ACCESS CONTROL FOR TABLES 或 FOR SCHEMAS。 单数形式不被接受。 在 REST API 中,将 for_securable_type 设置为单数形式,例如 TABLE。

创建 DENY 策略

可以通过目录资源管理器 UI、 CREATE POLICY SQL 语句或 REST API 创建 DENY 策略。

若要创建 DENY 策略,您必须在附加该策略的目录或架构上具有 MANAGE,或者拥有该安全对象。

目录浏览器

必须从目录或架构创建 DENY 策略。 当你从单个对象(如表)开始时,拒绝 访问 策略类型不可用。

  1. 在 Azure Databricks 工作区中,单击 Data icon.Catalog。
  2. 选择要在其中附加策略的目录或架构。 DENY 策略只能在目录或架构级别附加。
  3. 单击“策略”选项卡。
  4. 单击“新建策略”。
  5. 在 “策略标识”下,输入 策略名称和 可选 说明。
  6. 在 主体和作用域下:
    • 在 “应用于”中,选择策略适用的主体(用户、组或服务主体)。
    • 在“除外”中,可选择要排除在策略之外的主体。
    • 在 Scope 中,确认附加策略的目录或架构。
  7. 在 策略类型中,选择 拒绝访问。
  8. 在 可保障对象中,选择该策略适用的可保障类型。 参见 支持的类型和权限。
  9. 在 条件下,选择如何将策略范围扩展到目录或模式中所选类型的可保障资产:
    • 没有条件 将该政策适用于所选目录或模式下所有该类型的担保资产。
    • 与以下任一标签匹配的受保护对象 仅将策略应用于至少带有一个所选治理标签的受保护对象。
    • 与自定义表达式匹配的受保护对象允许您编写基于标签的表达式,以确定该策略适用于哪些受保护对象。 有关可用 条件函数,请参阅“条件”和“内置函数 ”。
  10. 在 权限下,选择 管理访问控制。 这是 DENY 策略支持的唯一特权。
  11. 单击“ 显示代码 ”,在保存之前查看等效的 SQL 语句,然后单击“ 创建策略”。

SQL

DENY 策略的 SQL 语法使用 DENY ... FOR ... WHEN ... 正文代替 ROW FILTER 或 COLUMN MASK。

CREATE [OR REPLACE] POLICY policy_name
ON { METASTORE | CATALOG catalog_name | SCHEMA schema_name }
[COMMENT description]
TO principal [, ...]
[EXCEPT principal [, ...]]
DENY MANAGE ACCESS CONTROL
FOR securable_type
[WHEN condition]

Parameters:

  • policy_name:策略的名称。 在同一安全对象上定义的所有策略中必须是唯一的。
  • ON { METASTORE | CATALOG | SCHEMA }:附加策略的范围。 DENY 策略可以附加到元存储、编录或架构级别,而不是附加到单个安全对象上。 用 ON METASTORE 来在元商店的每个目录中应用该策略。 ON METASTORE 无需指定名称,并作用于你当前正在操作的元存储。 参见Metastore级别的ABAC政策(Beta版)。
  • TO principal [, ...]:策略适用的用户、组或服务主体。
  • EXCEPT principal [, ...]:负责人豁免于政策。 Metastore管理员总是默认免于此,不需要被列入名单。
  • DENY MANAGE ACCESS CONTROL:拒绝的权利。 MANAGE ACCESS CONTROL 是唯一被支持的特权。
  • FOR securable_type:策略适用范围内的可保护对象类型。 策略适用于一种类型。 参见 支持的类型和权限。
  • WHEN condition:基于标签的布尔表达式,用于确定策略在作用域内适用于哪些可保护对象。 使用内置函数 has_tag('tag_name') 和 has_tag_value('tag_name', 'tag_value'). 如果省略,则默认为 TRUE (适用于范围内所有类型的可保障资产)。 有关可用 条件函数,请参阅“条件”和“内置函数 ”。

有关示例,请参阅 DENY 策略示例。

REST API

这个示例拒绝所有账户用户对 catalog_a 中所有带有 data_admins 标签的表执行 MANAGE ACCESS CONTROL,但 sensitive 除外:

curl -X POST "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/policies" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}" \
  -H "Content-Type: application/json" \
  --data-binary @- << 'EOF'
{
  "name": "deny_manage_access_control_sensitive_tables",
  "comment": "Prevent non-admins from managing permissions on sensitive tables",
  "on_securable_type": "CATALOG",
  "on_securable_fullname": "catalog_a",
  "for_securable_type": "TABLE",
  "policy_type": "POLICY_TYPE_DENY",
  "to_principals": ["account users"],
  "except_principals": ["data_admins"],
  "deny": {
    "privileges": ["MANAGE_ACCESS_CONTROL"]
  },
  "when_condition": "has_tag('sensitive')"
}
EOF

name、on_securable_type、on_securable_fullname、for_securable_type、policy_type、to_principals 和 deny.privileges 为必填项。 comment、except_principals 和 when_condition 是可选的。

关于请求和响应的详细信息,请参见 REST API 参考中的 创建策略 。

编辑 DENY 策略

目录浏览器

从其所附加到的父目录或架构的“策略”选项卡中管理 DENY 策略。

  1. 在 Azure Databricks 工作区中,单击 Data icon.Catalog。
  2. 选择策略附加到的目录或架构。
  3. 单击“策略”选项卡。
  4. 选择想要编辑的策略。
  5. 更新您想要更改的字段。
  6. 单击“更新策略”。

SQL

若要使用 SQL 编辑具有相同名称和目标的 DENY 策略,请运行 CREATE OR REPLACE POLICY 。 请参阅 创建 DENY 策略。

REST API

与在 SQL 中不同 CREATE OR REPLACE POLICY , PATCH 支持部分更新。 使用 update_mask 查询参数指定要更改哪些字段。 仅会更新这些字段,而请求体中未包含的字段将保持不变。

此示例将 audit_admins 添加到策略中排除的主体:

curl -X PATCH "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/policies/CATALOG/catalog_a/deny_manage_access_control_sensitive_tables?update_mask=except_principals" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}" \
  -H "Content-Type: application/json" \
  --data-binary @- << 'EOF'
{
  "except_principals": ["data_admins", "audit_admins"]
}
EOF

你发送的值是替换现有列表,而不是添加,所以你必须包含所有你想排除的主体,而不仅仅是新的。

删除 DENY 策略

目录浏览器

从其所附加到的父目录或架构的策略选项卡中管理 DENY 策略。

  1. 在 Azure Databricks 工作区中,单击 Data icon.Catalog。
  2. 选择策略附加到的目录或架构。
  3. 单击“策略”选项卡。
  4. 选择策略。
  5. 单击“ 删除策略”。

SQL

若要使用 SQL 删除 DENY 策略,请运行 DROP POLICY:

DROP POLICY deny_manage_access_control_sensitive_tables ON CATALOG catalog_a;

REST API

curl -X DELETE "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/policies/CATALOG/catalog_a/deny_manage_access_control_sensitive_tables" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}"

显示策略

使用 SHOW POLICIES 列出在安全对象上定义的策略。 使用 SHOW EFFECTIVE POLICIES 还可以包括从父作用域继承的策略,例如影响架构的目录级策略。

SHOW [EFFECTIVE] POLICIES ON { METASTORE | CATALOG | SCHEMA } securable_name

结果包括策略名称、策略类型、每个策略所定义的可保护对象的目录和架构,以及该可保护对象的类型和全名。 DENY 策略会以策略类型 DENY 返回,并与在同一范围内附加的任何行筛选器、列掩码和 GRANT 策略一起返回。 只有当策略在表上定义时,列 Table 才会被填充。 这适用于行过滤和列掩码策略。 对于 GRANT 和 DENY 策略,列 Table 为 NULL。

Example:

SHOW EFFECTIVE POLICIES ON CATALOG catalog_a;
Policy Name                                  Policy Type  Catalog    Schema  Table  Comment                                                           on_securable_type  on_securable_fullname
-------------------------------------------  -----------  ---------  ------  -----  ----------------------------------------------------------------  -----------------  ---------------------
deny_manage_access_control_sensitive_tables  DENY         catalog_a  NULL    NULL   Prevent non-admins from managing permissions on sensitive tables  CATALOG            catalog_a

SHOW GRANTS 不反映 DENY 策略。 请参阅限制。

描述策略

使用 DESCRIBE POLICY 查看特定 DENY 策略的详细信息。 需要在目标安全对象上具有 READ METADATA 或 MANAGE,或者拥有该对象的所有权。

{ DESC | DESCRIBE } POLICY policy_name ON { METASTORE | CATALOG | SCHEMA } securable_name

结果显示策略的属性为键值对,包括名称、可保护对象类型、可保护对象名称、主体、拒绝权限和 WHEN 条件。

使用信息架构查询策略定义

可以使用以下方法 INFORMATION_SCHEMA.ABAC_POLICY_DEFINITIONS查询当前目录集中的 DENY 策略定义:

SELECT *
FROM information_schema.abac_policy_definitions
WHERE policy_type = 'DENY';

有关可用的列和更多示例,请参见 ABAC_POLICY_DEFINITIONS。

策略配额

Resource Limit
每个元存储的策略(所有对象) 10,000
各元商店的政策,直接附带(测试版) 100
各目录的策略 100
各架构的策略 100

GRANT 和 DENY 策略为每个对象共享一个组合配额。 这些配额与 行筛选器和列掩码策略的配额分开。

审计日志

DENY 策略的创建、更改和删除操作记录在与行筛选器和列掩码策略相同的 createPolicy、deletePolicy、getPolicy 和 listPolicies 操作下。 有关审核日志查询示例,请参阅 审核日志记录 。

最佳做法

  • 在 TO 和 EXCEPT 中使用组,而不是单个用户。 在策略中指定的组内添加或删除用户,无需编辑策略即可更改该策略的适用对象。
  • 务必将受信任的组从策略中排除,以免不小心将所有人都拒之门外。 当策略适用于 account users 组时,这一点尤为重要。 使用该 EXCEPT 条款命名一个保留该权限的组,这样至少一组主体仍能管理受影响对象的访问。
  • 在涵盖目标的最小范围内附加策略。 范围更广会将无关的受保护对象纳入策略的标签匹配范围,并且可能会在你无意的情况下拒绝访问。

数据共享的考虑

拒绝 MANAGE ACCESS CONTROL 只会阻止由所有权和 MANAGE 权限控制的功能。 它并不能封堵主体共享数据的所有途径。 DENY 策略不会阻止以下各项:

  • 用CTAS复制数据。 在表上具有 CREATE TABLE、在架构上具有 SELECT(以及 USE CATALOG 和 USE SCHEMA)的主体,可以使用 CREATE TABLE ... AS SELECT 将数据复制到新表中。 为限制此限制,避免授予 CREATE TABLE。
  • 通过视图公开数据。 在表上具有 SELECT、在架构上具有 CREATE TABLE(以及 USE CATALOG 和 USE SCHEMA)的主体,可以基于该表创建一个 视图。 由于视图运行时拥有 其所有者的权限,视图上获得 SELECT 的主体可以在无需直接访问源表的情况下读取底层数据。 为了限制这一点,避免授予 CREATE TABLE,因为它也授权了视图创建。
  • 应用或移除受控标签。 在对象上具有 APPLY TAG 且对 受管标签具有 ASSIGN 权限的主体仍然可以更改该对象上的该标签,这可能会影响基于标签的策略。 要限制这一点,请限制谁在受治理的标记上拥有 ASSIGN,以及谁在对象上拥有 APPLY TAG。 请参阅 管理受治理标记的权限。
  • 开放分享。 拥有该对象所需权限的共享所有者可以将其添加到 共享中。 要限制这一点,请避免在元存储上授予 CREATE SHARE。
  • 凭证发放。 主体可以通过凭证分发共享对对象的访问权限。 为限制此限制,避免在元存储库启用外部数据访问,且不授予 EXTERNAL USE SCHEMA。
  • 组管理。 对Databricks 组拥有Manage权限的主体(包括自动拥有该权限的账户管理员和工作区管理员)可以更改组成员,从而改变哪些主体可通过该组继承访问权限。 要限制这一点,可以限制组中拥有管理权限的人。

Limitations

  • 只有 MANAGE ACCESS CONTROL 特权可被拒绝。 DENY 策略不支持其他特权,例如 SELECT 和 MODIFY。
  • 该 MANAGE ACCESS CONTROL 特权可以被拒绝,但不能被授予。
  • 策略可以附加到元存储库(Beta)、目录或模式上,而非单个可保护对象。
  • 一个策略适用于一种可保护的对象类型。 要拒绝同一作用域内多个可保护对象类型的权限,需为每个类型创建独立策略,或创建 FOR SCHEMAS 策略使 MANAGE ACCESS CONTROL 该策略对模式内所有对象类型都被拒绝。
  • SHOW GRANTS、 GetPermissions和 GetEffectivePermissions 不反映 DENY 策略。 若要查看当前生效的 DENY 策略,请使用 SHOW EFFECTIVE POLICIES 查看对象的目录或架构。

详细信息