Begränsa OpenSharing-mottagaråtkomst med hjälp av IP-åtkomstlistor (Databricks-to-Open-delning)

Den här artikeln beskriver hur dataleverantörer kan tilldela IP-åtkomstlistor för att styra mottagarens åtkomst till delade data.

Om du som dataprovider använder delningsprotokollet Databricks-to-Open kan du begränsa en mottagare till en begränsad uppsättning IP-adresser när de får åtkomst till data som du delar. Den här listan är oberoende av IP-åtkomstlistor för arbetsytor. Endast tillåtna listor stöds.

IP-åtkomstlistan påverkar följande:

  • REST API-åtkomst för OpenSharing OSS Protocol
  • Åtkomst till OpenSharing-aktiverings-URL
  • Nedladdning av openSharing-fil för autentiseringsuppgifter

Note

När providern har SecureConnect aktiverat framtvingar IP-åtkomstlistan även åtkomst till delad datalagring. Utan SecureConnect kan lagrings-URL:er nås från alla klient-IP-adresser, oavsett IP-åtkomstlista.

Varje mottagare stöder högst 100 IP/CIDR-värden, där en CIDR räknas som ett enda värde. Endast IPv4-adresser stöds.

Tilldela en IP-åtkomstlista till en mottagare

Du kan tilldela en IP-åtkomstlista till en mottagare med hjälp av Catalog Explorer eller Databricks Unity Catalog CLI.

Behörigheter krävs: Om du tilldelar en IP-åtkomstlista när du skapar en mottagare måste du ha behörigheten CREATE RECIPIENT . Om du tilldelar en IP-åtkomstlista till en befintlig mottagare måste du vara mottagarens objektägare.

Katalogutforskaren

  1. På din Azure Databricks-arbetsyta klickar du på dataikonen.Katalog.

  2. Längst upp i fönstret Katalog klickar du på kugghjulsikonen. kugghjulsikonen och väljer OpenSharing.

    Du kan också klicka på Dela > OpenSharing i det övre högra hörnet.

  3. På fliken Delat av mig klickar du på Mottagare och väljer mottagaren.

  4. På fliken IP-åtkomstlista klickar du på Lägg till IP-adress/CIDR för varje IP-adress (i enskilt IP-adressformat, t.ex. 8.8.8.8) eller ip-adressintervall (i CIDR-format, till exempel 8.8.8.4/10).

CLI

Om du vill lägga till en IP-åtkomstlista när du skapar en ny mottagare kör du följande kommando med hjälp av Databricks CLI och ersätter <recipient-name> och IP-adressvärdena.

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"
    ]
  }
}'

Om du vill lägga till en IP-åtkomstlista till en befintlig mottagare kör du följande kommando, ersätter <recipient-name> och IP-adressvärdena.

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

Ta bort en IP-åtkomstlista

Du kan ta bort en mottagares IP-åtkomstlista med hjälp av Catalog Explorer eller Databricks Unity Catalog CLI. Om du tar bort alla IP-adresser från listan kan mottagaren komma åt delade data var som helst.

Behörigheter som krävs: Ägare av mottagarobjektet.

Katalogutforskaren

  1. På din Azure Databricks-arbetsyta klickar du på dataikonen.Katalog.

  2. Längst upp i fönstret Katalog klickar du på kugghjulsikonen. kugghjulsikonen och väljer OpenSharing.

    Du kan också klicka på Dela > OpenSharing i det övre högra hörnet.

  3. På fliken Delat av mig klickar du på Mottagare och väljer mottagaren.

  4. På fliken IP-åtkomstlista klickar du på papperskorgsikonen bredvid den IP-adress som du vill ta bort.

CLI

Använd Databricks CLI för att skicka in en tom IP-åtkomstlista:

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

Visa en mottagares IP-åtkomstlista

Du kan visa en mottagares IP-åtkomstlista med hjälp av Catalog Explorer, Databricks Unity Catalog CLI eller DESCRIBE RECIPIENT SQL-kommandot i en notebook- eller Databricks SQL-fråga.

Behörigheter som krävs: Metaarkivadministratör, användare med USE RECIPIENT behörigheten eller mottagarens objektägare.

Katalogutforskaren

  1. På din Azure Databricks-arbetsyta klickar du på dataikonen.Katalog.

  2. Längst upp i fönstret Katalog klickar du på kugghjulsikonen. kugghjulsikonen och väljer OpenSharing.

    Du kan också klicka på Dela > OpenSharing i det övre högra hörnet.

  3. På fliken Delat av mig klickar du på Mottagare och väljer mottagaren.

  4. Visa tillåtna IP-adresser på fliken IP-åtkomstlista .

CLI

Kör följande kommando med hjälp av Databricks CLI.

databricks recipients get <recipient-name>

SQL

Kör följande kommando i en notebook-fil eller Databricks SQL-frågeredigeraren.

DESCRIBE RECIPIENT <recipient-name>;

Granskningsloggning för OpenSharing IP-åtkomstlistor

Följande åtgärder utlöser granskningsloggar relaterade till IP-åtkomstlistor:

  • Hanteringsåtgärder för mottagare: skapa, uppdatera
  • Nekad åtkomst till något av REST API-anropen för OpenSharing OSS Protocol
  • Nekad åtkomst till OpenSharing-aktiverings-URL (endast Databricks-to-Open-delning)
  • Nekad åtkomst till nedladdning av OpenSharing-autentiseringsuppgifter (endast databricks-till-öppen-delning)

Mer information om hur du aktiverar och läser granskningsloggar för OpenSharing finns i Granska och övervaka datadelning.