配置工作区的 IP 访问列表

本页介绍如何为Azure Databricks工作区配置 IP 访问列表。 本文讨论可以使用 Databricks CLI 执行的最常见任务。

也可以使用 IP 访问列表 API。

注释

工作区 IP 访问列表和基于帐户级别的入口控制一起强制实施。 必须经过两个控制的允许,请求才能成功。

工作区 IP 访问列表仍可用于添加基于 IP 地址的附加限制层,但不能将访问权限扩展到基于上下文的入口允许的范围之外。

要求

  • IP 访问列表仅支持 Internet 协议版本 4 (IPv4) 地址。
  • 如果在工作区上启用安全群集连接,则计算平面用于访问控制平面的任何公共 IP 都必须添加到允许列表中,或者必须配置 后端私人链接。 否则,经典计算资源无法启动。

    例如,如果你在使用 VNet 注入的工作区上启用安全群集连接,则 Databricks 会建议你为工作区使用一个稳定的出口公共 IP。 该公共 IP 和任何其他 IP 都必须出现在允许列表中。 请参阅 在 Azure 虚拟网络中部署 Azure Databricks (VNet 注入)。 或者,如果使用Azure Databricks管理的 VNet,并且将托管 NAT 网关配置为访问公共 IP,则这些 IP 必须存在于允许列表中。 有关详细信息,请参阅此 Databricks Community 帖子。

检查工作区是否启用了 IP 访问列表功能

若要检查工作区是否启用了 IP 访问列表功能:

databricks workspace-conf get-status enableIpAccessLists

启用或禁用工作区的 IP 访问列表功能

在 JSON 请求正文中,将 enableIpAccessLists 指定为 true(已启用)或 false(已禁用)。

databricks workspace-conf set-status --json '{
  "enableIpAccessLists": "true"
}'

添加 IP 访问列表

如果启用了 IP 访问列表功能,而工作区没有允许列表或阻止列表,则允许所有 IP 地址。 如果将 IP 地址添加到允许列表,会阻止该列表中未包含的所有 IP 地址。 请仔细查看更改,避免意外的访问限制。

计算平面用于访问控制平面的任何公共 IP 都应添加到允许列表中。

IP 访问列表有一个标签,该标签是列表的名称,也是列表类型。 此列表类型是 ALLOW(允许列表)或 BLOCK(阻止列表,这意味着即使在允许列表中也要排除)。

例如,添加允许列表:

databricks ip-access-lists create --json '{
  "label": "office",
  "list_type": "ALLOW",
  "ip_addresses": [
    "1.1.1.0/24",
    "2.2.2.2/32"
  ]
}'

列出 IP 访问列表

databricks ip-access-lists list

更新 IP 访问列表

至少指定以下值之一进行更新:

  • label — 此列表的标签。

  • list_type — 二者之一:ALLOW(允许列表)或 BLOCK(阻止列表,这意味着即使在允许列表中也排除)。

  • ip_addresses — IP 地址和 CIDR 范围的 JSON 数组,作为字符串值。

  • enabled — 指定是否启用此列表。 传递 true 或 false。

响应是您传入对象的一个副本,并包含附加的字段用于标识 ID 和修改日期。

例如,若要禁用列表:

databricks  ip-access-lists update <list-id> --json '{
  "enabled": false
}'

删除 IP 访问列表

若要删除 IP 访问权限:

databricks  ip-access-lists delete <list-id>

后续步骤

资源 Description
为帐户控制台配置 IP 访问列表 为账户控制台设置IP限制,以控制哪些网络可以访问账户级别的设置和API。
专用链接概念 使用 专用链接 建立从虚拟网络对 Azure 服务的安全且隔离的访问,绕过公共互联网。