使用 IP 存取清單限制 OpenSharing 接收者的存取(Databricks-to-Open 共享)

本文說明數據提供者如何指派 IP 存取清單來控制共享數據的收件者存取權。

如果你作為資料提供者,使用 Databricks-to-Open 的分享協定,你可以限制接收者在存取你分享的資料時,只能使用有限的 IP 位址。 此清單是獨立於工作區 IP 存取清單 的。。 僅支援允許列表。

IP 存取清單會影響下列各項:

  • OpenSharing OSS 協定 REST API 存取
  • OpenSharing 啟用 URL 存取
  • OpenSharing 憑證檔案下載

備註

當服務提供者啟用 SecureConnect 時,IP 存取清單也會強制存取共享資料儲存。 沒有 SecureConnect,儲存 URL 可從任何用戶端 IP 存取,無論 IP 存取清單為何。

每個收件者最多支援 100 個 IP/CIDR 值,其中一個 CIDR 會計算為單一值。 僅支援 IPv4 位址。

將IP存取清單指派給收件者

您可以使用目錄總管或 Databricks Unity 目錄 CLI,將 IP 存取清單指派給收件者。

需要權限:如果你在建立收件人時指派 IP 存取清單,必須擁有該 CREATE RECIPIENT 權限。 如果您要將IP存取清單指派給現有的收件者,您必須是收件者對象擁有者。

目錄檢視器

  1. 在您的 Azure Databricks 工作區中,按一下 [資料] 圖示。目錄

  2. 目錄 面板頂端,點選 齒輪圖示。 齒輪圖示,選擇 OpenSharing

    或者,在右上角點選 「分享 > OpenSharing」。

  3. 在 [由我共用] 索引標籤上,按一下 [收件者],然後選取收件者。

  4. 在 [IP 存取清單] 索引標籤上,點選 為每個 IP 位址新增 IP 位址/CIDRs(以單一 IP 位址格式,例如 8.8.8.8)或 IP 位址範圍(CIDR 格式,例如 8.8.8.4/10)。

CLI

若要在建立新的收件者時新增IP存取清單,請使用 Databricks CLI執行下列命令,取代 <recipient-name> 和IP位址值。

databricks recipients create \
--json=-'{
  "name": "<recipient-name>",
  "authentication_type": "<authentication-type>",
  "ip_access_list": {
    "allowed_ip_addresses": [
      "8.8.8.8",
      "8.8.8.4/10"
    ]
  }
}'

若要將IP存取清單新增至現有的收件者,請執行下列命令,取代 <recipient-name> 和IP位址值。

databricks recipients update \
--json='{
  "name": "<recipient-name>",
  "ip_access_list": {
    "allowed_ip_addresses": [
      "8.8.8.8",
      "8.8.8.4/10"
    ]
  }
}'

拿掉IP存取清單

您可以使用目錄總管或 Databricks Unity 目錄 CLI 來移除收件者的 IP 存取清單。 如果您從清單中移除所有IP位址,收件者就可以從任何地方存取共享資料。

所需權限:收件者物件擁有者。

目錄檢視器

  1. 在您的 Azure Databricks 工作區中,按一下 [資料] 圖示。目錄

  2. 目錄 面板頂端,點選 齒輪圖示。 齒輪圖示,選擇 OpenSharing

    或者,在右上角點選 「分享 > OpenSharing」。

  3. 在 [由我共用] 索引標籤上,按一下 [收件者],然後選取收件者。

  4. 在 [IP 存取清單] 索引標籤上,按兩下您要刪除之IP位址旁的垃圾桶圖示。

CLI

使用 Databricks CLI 來傳遞空白的 IP 存取清單:

databricks recipients update \
--json='{
  "name": "<recipient-name>",
  "ip_access_list": {}
}'

檢視收件者的IP存取清單

您可以使用目錄總管、Databricks Unity 目錄 CLI 或 DESCRIBE RECIPIENT 筆記本或 Databricks SQL 查詢中的 SQL 命令來檢視收件者的 IP 存取清單。

所需的許可權:Metastore 管理員、具有 USE RECIPIENT 許可權的使用者或收件對象的所有者。

目錄檢視器

  1. 在您的 Azure Databricks 工作區中,按一下 [資料] 圖示。目錄

  2. 目錄 面板頂端,點選 齒輪圖示。 齒輪圖示,選擇 OpenSharing

    或者,在右上角點選 「分享 > OpenSharing」。

  3. 在 [由我共用] 索引標籤上,按一下 [收件者],然後選取收件者。

  4. 在 [IP 存取清單] 索引標籤上檢視允許的 IP 位址。

CLI

使用 Databricks CLI 執行下列命令。

databricks recipients get <recipient-name>

SQL

在筆記本或 Databricks SQL 查詢編輯器中,執行下列命令。

DESCRIBE RECIPIENT <recipient-name>;

OpenSharing IP 存取清單的稽核記錄

下列作業會觸發與IP存取清單相關的稽核記錄:

  • 收件者管理作業:建立、更新
  • 拒絕存取任何 OpenSharing OSS 協定 REST API 呼叫
  • 拒絕存取 OpenSharing 啟用 URL(僅限 Databricks 轉 Open 分享)
  • 拒絕存取 OpenSharing 憑證檔案下載(僅限 Databricks to Open 共享)

欲了解如何啟用及閱讀 OpenSharing 的稽核日誌,請參閱 「稽核與監控資料分享」。