组织 Unity Catalog 机密,使每个应用程序只能访问自己的机密,大多数主体身份使用机密而不读取其值,而你控制加密这些值的密钥。 关于如何创建、授予和读取秘密,请参见 Unity Catalog 中的秘密。
根据谁需要机密对机密进行分组
为每个应用程序、环境或团队创建一个模式,并在该模式上授予 CREATE SECRET 权限,而不是在目录上授予权限。 一个模式最多可容纳 1,000 个密钥,元存储库最多可容纳 10,000 个密钥。
对单个机密授权:对某个架构的授权将应用于其中每一个机密,包括后续增加的机密。 当主体只需要一个 secret 时,应在该 secret 上授予
READ SECRET,而不是在其架构上。在需要时,为生产机密单独创建目录:工作区绑定和客户管理的密钥适用于整个目录。 为了防止生产机密进入开发工作区,或者用自己的密钥加密,可以把它们放在单独的目录里。 请参阅 Workspace-catalog binding 和 用您自己的密钥加密 Azure Databricks 管理的机密。
为了给订单应用程序提供其自己的架构,并让报告作业只读取其中一个机密,请运行以下命令:
-- The application's service principal reads every secret in its schema
CREATE SCHEMA main.orders_app;
GRANT USE CATALOG ON CATALOG main TO `orders-service-principal`;
GRANT USE SCHEMA, READ SECRET ON SCHEMA main.orders_app TO `orders-service-principal`;
-- The reporting job reads only the warehouse password
GRANT USE CATALOG ON CATALOG main TO `reporting-service-principal`;
GRANT USE SCHEMA ON SCHEMA main.orders_app TO `reporting-service-principal`;
GRANT READ SECRET ON SECRET main.orders_app.warehouse_password TO `reporting-service-principal`;
对于由 Azure 密钥保管库 支持的秘密,每个 schema 使用一个 密钥保管库,并赋予其独立的服务凭证和连接。 密钥保管库 连接不支持标签过滤器,因此保险库就是边界。 如果一个保管库包含超过 1,000 个机密,Unity Catalog 会先导入最早的,跳过其余的。
不要用一个共享的 密钥保管库 支持可供多个应用访问的一个架构。
分别管理发现、轮换和读取机密的权限
这些都是独立的权限,因此主体在更新或在目录浏览器中找到秘密时,无需看到其价值:
| 让一个主体 | 授予 | 返回该值 |
|---|---|---|
| 查找机密并请求访问 | 对目录拥有 BROWSE 权限, 它显示每个机密的元数据,如名称、所有者和到期日。 |
No |
| 通过更新某个机密的值来轮换机密 | WRITE SECRET |
No |
比如在某项工作中,用 dbutils.secrets 读取该值 |
READ SECRET |
Yes |
完整权限列表请参见 “授予对密钥的访问权限”。
为了让所有人都能找到秘密并请求访问,并且轮换作业无需读取密码即可更新仓库密码,运行以下操作:
GRANT BROWSE ON CATALOG main TO `account users`;
GRANT USE CATALOG ON CATALOG main TO `rotation-service-principal`;
GRANT USE SCHEMA ON SCHEMA main.orders_app TO `rotation-service-principal`;
GRANT WRITE SECRET ON SECRET main.orders_app.warehouse_password TO `rotation-service-principal`;
BROWSE 会向所有拥有该权限的人显示注释。 使用 Secret 的注释说明谁拥有它以及如何申请访问权限。 绝不要在注释中放入值,或任何相关提示。
使用自己的密钥加密Azure Databricks管理的机密
目录上的客户管理密钥(CMK)设置适用于其中的每个 Azure Databricks 管理的机密。 要用单独的密钥加密生产机密,可以将它们放在独立的目录集中。 关于 CMK 如何应用于机密,请参见 “使用客户管理的密钥加密机密值”。
在源头轮换机密
对于由 Azure 密钥保管库 支持的秘密,可以在 Azure 密钥保管库 中轮换值,例如使用 密钥保管库 轮换策略。 不要把它们的值复制到 Azure Databricks 管理的机密里,因为每复制一份,就多一个需要轮换的值。
对于 Azure Databricks 管理的机密,可以在 Catalog Explorer 中或使用 REST API 更新该值。 设置一个过期日期,让 Catalog Explorer 在密钥到期时显示警告。
已经持有某个值的代码会保留该值,直到再次读取该秘密。 在长期运行的作业中,每次打开连接时都要读取机密信息,而不仅仅是在启动时。
让工作负载在不读取机密内容的情况下使用机密
大多数依赖密钥的用户其实永远不需要看到其具体内容。 声明秘密的 Unity Catalog UDF 会以其所有者的权限读取该秘密,因此调用者只需 EXECUTE 访问 UDF,例如屏蔽或哈希个人数据。 相比之下,任何运行调用 secret() 工作空间秘密作用域的SQL函数的人都需要 READ 调用该作用域,因为它暴露了其中的每个秘密。 参见 在 UDF 中使用密钥。
仅将
READ SECRET授予给执行作业的服务主体、声明秘密的 UDF 所有者以及拥有秘密的小团队。将组或服务主体设为每个声明秘密的 UDF 的所有者,这样当有人离开时,UDF 就不会失败。
只有当所有调用者都能读取机密时,才使用会话范围的 UDF。 他们使用调用方的权限读取机密信息。
Warning
永远不要从 UDF 返回机密值。 遮蔽并不能阻止UDF代码在查询结果中返回某个值。
控制谁可以授予访问权限并对此进行审计
将秘密及其模式的所有权分配给一个组,而不是个人。
元存储管理员和具有
MANAGE的主体无法读取某个值,但他们可以为自己授予READ SECRET。 将MANAGE限制在一小部分人中。在
system.access.audit系统表中查看秘密读取和授权。 参见 审计 Secret 访问。
其他资源
| 资源 | Description |
|---|---|
| Unity Catalog 中的机密 | 创建、授予和读取 Unity Catalog 密钥。 |
| 机密管理 | 比较 Unity Catalog 的秘密与工作空间的秘密作用域,看看各自可以在哪里使用。 |