Limitazione dell'accesso dei destinatari di OpenSharing tramite liste di accesso IP (da Databricks a Open Sharing)

Questo articolo descrive come i provider di dati possono assegnare elenchi di accesso IP per controllare l'accesso dei destinatari ai dati condivisi.

Se si usa il protocollo di condivisione da Databricks a Open come provider di dati, è possibile limitare un destinatario a un set limitato di indirizzi IP quando accedono ai dati condivisi. Questo elenco è indipendente dagli elenchi di accesso IP dell'area di lavoro . Sono supportati solo gli elenchi consentiti.

L'elenco di accesso IP influisce sugli elementi seguenti:

• Accesso all'API REST del protocollo OSS OpenSharing
• Accesso all'URL di attivazione OpenSharing
• Download del file di credenziali OpenSharing

Ogni destinatario supporta un massimo di 100 valori IP/CIDR, in cui un CIDR viene conteggiato come singolo valore. Sono supportati solo gli indirizzi IPv4.

Assegnare un elenco di accesso IP a un destinatario

È possibile assegnare un elenco di accesso IP a un destinatario usando Esplora cataloghi o l'interfaccia della riga di comando di Databricks Unity Catalog.

Autorizzazioni necessarie: se si assegna un elenco di accesso IP quando si crea un destinatario, è necessario disporre del CREATE RECIPIENT privilegio . Se si assegna un elenco di accesso IP a un destinatario esistente, è necessario essere il proprietario dell'oggetto destinatario.

Esploratore di cataloghi

1. Nell'area di lavoro di Azure Databricks fare clic Catalogo.

2. Nella parte superiore del riquadro Catalogo, fare clic sull' e selezionare OpenSharing.

   In alternativa, nell'angolo superiore destro fare clic su Condividi > OpenSharing.

3. Nella scheda Condivisi da me fare clic su Destinatari e selezionare il destinatario.

4. Nella scheda elenco di accesso IP , fare clic su Aggiungi indirizzo IP/CIDR per ogni indirizzo IP (in formato di indirizzo IP singolo, ad esempio 8.8.8.8) o intervallo di indirizzi IP (in formato CIDR, ad esempio 8.8.8.4/10).

CLI

Per aggiungere un elenco di accesso IP quando si crea un nuovo destinatario, eseguire il comando seguente usando l'interfaccia della riga di comando di Databricks , sostituendo <recipient-name> e i valori dell'indirizzo 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"
    ]
  }
}'

Per aggiungere un elenco di accesso IP a un destinatario esistente, eseguire il comando seguente, sostituendo <recipient-name> e i valori dell'indirizzo IP.

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

Rimuovere un elenco di accesso IP

È possibile rimuovere l'elenco di accesso IP di un destinatario usando Esplora cataloghi o l'interfaccia della riga di comando di Databricks Unity Catalog. Se si rimuovono tutti gli indirizzi IP dall'elenco, il destinatario può accedere ai dati condivisi da qualsiasi posizione.

Autorizzazioni necessarie: proprietario dell'oggetto destinatario.

Esploratore di cataloghi

1. Nell'area di lavoro di Azure Databricks fare clic Catalogo.

2. Nella parte superiore del riquadro Catalogo, fare clic sull' e selezionare OpenSharing.

   In alternativa, nell'angolo superiore destro fare clic su Condividi > OpenSharing.

3. Nella scheda Condivisi da me fare clic su Destinatari e selezionare il destinatario.

4. Nella scheda elenco di accesso IP, clicca sull'icona del cestino accanto all'indirizzo IP che desideri eliminare.

CLI

Usa il Databricks CLI per passare una lista di accesso IP vuota.

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

Visualizzare l'elenco di accesso IP di un destinatario

È possibile visualizzare l'elenco di accesso IP di un destinatario usando Esplora cataloghi, la CLI di Databricks Unity Catalog o il DESCRIBE RECIPIENT comando SQL in un notebook o in una query SQL di Databricks.

Autorizzazioni necessarie: amministratore metastore, utente con privilegi USE RECIPIENT o proprietario dell'oggetto destinatario.

Esploratore di cataloghi

1. Nell'area di lavoro di Azure Databricks fare clic Catalogo.

2. Nella parte superiore del riquadro Catalogo, fare clic sull' e selezionare OpenSharing.

   In alternativa, nell'angolo superiore destro fare clic su Condividi > OpenSharing.

3. Nella scheda Condivisi da me fare clic su Destinatari e selezionare il destinatario.

4. Visualizzare gli indirizzi IP consentiti nella scheda della lista di accesso IP .

CLI

Eseguire il comando seguente usando la CLI di Databricks.

databricks recipients get <recipient-name>

SQL

Eseguire il seguente comando in un notebook o nell'editor di query SQL di Databricks.

DESCRIBE RECIPIENT <recipient-name>;

Registrazione di controllo per gli elenchi di accesso IP OpenSharing

Le operazioni seguenti attivano i log di controllo correlati agli elenchi di accesso IP:

• Operazioni di gestione dei destinatari: creare, aggiornare
• Negazione dell'accesso a qualsiasi chiamata all'API REST del protocollo OSS OpenSharing
• Accesso negato all'URL di attivazione di OpenSharing (solo per la condivisione da Databricks a Open Sharing)
• Negazione dell'accesso al download del file delle credenziali OpenSharing (solo condivisione da Databricks a Open)

Per altre informazioni su come abilitare e leggere i log di controllo per OpenSharing, vedere Controllare e monitorare la condivisione dei dati.