Introduzione alla sicurezza a livello di riga di BigQuery

Questo documento spiega il concetto di sicurezza a livello di riga, come funziona in BigQuery, quando utilizzarla per proteggere i dati e altri dettagli.

Che cos'è la sicurezza a livello di riga?

La sicurezza a livello di riga consente di filtrare i dati e di accedere a righe specifiche di una tabella in base alle condizioni di idoneità degli utenti.

BigQuery supporta i controlli degli accessi a livello di progetto, set di dati e tabella. La sicurezza a livello di riga estende il principio del privilegio minimo consentendo un controllo dell'accesso granulare dell'accesso a un sottoinsieme di dati in una tabella BigQuery, tramite policy di accesso a livello di riga.

Una tabella può avere più policy di accesso a livello di riga. Le policy di accesso a livello di riga possono coesistere in una tabella con la set di dati, tabella e progetto.

Come funziona la sicurezza a livello di riga

In generale, la sicurezza a livello di riga implica la creazione di criteri di accesso a livello di riga sulla tabella BigQuery di destinazione. Queste policy fungono da filtri per nascondere o mostrare determinate righe di dati, a seconda se un utente o un gruppo fa parte di un elenco autorizzato. L'accesso viene negato a tutti gli utenti o gruppi non inclusi specificamente nell'elenco consentito.

Un utente autorizzato, con il ruolo Identity and Access Management (IAM) BigQuery Admin o BigQuery DataOwner, può creare criteri di accesso a livello di riga su una tabella BigQuery.

Quando crei una policy di accesso a livello di riga, specifichi una tabella per nome e quali utenti o gruppi (definiti grantee-list) possono accedere a determinati dati delle righe. Il criterio include anche i dati che vuoi filtrare, che formano un'espressione di filtro chiamata filter_expression. filter_expression funziona come una clausola WHERE in una query tipica.

Per istruzioni su come creare e utilizzare una policy di accesso a livello di riga, consulta Gestione della sicurezza a livello di riga.

Consulta il riferimento DDL per la sintassi, l'utilizzo e le opzioni completi per la creazione di policy di accesso a livello di riga.

Esempi di casi d'uso

Gli esempi seguenti mostrano potenziali casi d'uso per la sicurezza a livello di riga.

Filtra i dati delle righe in base alla regione

Considera il caso in cui la tabella dataset1.table1 contiene righe appartenenti a regioni diverse (indicate dalla colonna region).

Puoi creare e compilare la tabella di esempio utilizzando la seguente query:

CREATE TABLE IF NOT EXISTS
  dataset1.table1 (partner STRING,
    contact STRING,
    country STRING,
    region STRING);
INSERT INTO
  dataset1.table1 (partner,
    contact,
    country,
    region)
VALUES
  ('Example Customers Corp', 'alice@examplecustomers.com', 'Japan', 'APAC'),
  ('Example Enterprise Group', 'bob@exampleenterprisegroup.com', 'Singapore', 'APAC'),
  ('Example HighTouch Co.', 'carrie@examplehightouch.com', 'USA', 'US'),
  ('Example Buyers Inc.', 'david@examplebuyersinc.com', 'USA', 'US');

La sicurezza a livello di riga consente a un proprietario o amministratore dei dati di implementare policy. La seguente istruzione implementa una policy che limita gli utenti del gruppo di mailing APAC a visualizzare solo i partner della regione APAC:

CREATE ROW ACCESS POLICY
  apac_filter
ON
  dataset1.table1 GRANT TO ("group:sales-apac@example.com")
FILTER USING
  (region="APAC" );

Il comportamento risultante è che gli utenti del gruppo sales-apac@example.com possono visualizzare solo le righe in cui il valore di region è APAC.

Comportamento della sicurezza a livello di riga per la regione APAC.

La seguente istruzione implementa una policy che limita sia i singoli utenti che i gruppi alla visualizzazione dei soli partner della regione Stati Uniti:

CREATE ROW ACCESS POLICY
  us_filter
ON
  dataset1.table1 GRANT TO ("group:sales-us@example.com",
"user:jon@example.com")
FILTER USING
  (region="US");

Il comportamento risultante è che gli utenti del gruppo sales-us@example.com e l'utente jon@example.com possono visualizzare solo le righe in cui il valore di region è US.

Comportamento della sicurezza a livello di riga per la regione Stati Uniti.

Gli utenti che non fanno parte dei gruppi APAC o US non vedono alcuna riga.

Filtra i dati delle righe in base ai dati sensibili

Ora, considera un caso d'uso diverso, in cui hai una tabella che contiene informazioni sugli stipendi.

Puoi creare e compilare la tabella di esempio utilizzando la seguente query:

CREATE OR REPLACE TABLE
  dataset1.table1 (name STRING,
    department STRING,
    salary INT64,
    email STRING);
INSERT INTO
  dataset1.table1 ( name,
    department,
    salary,
    email)
VALUES
  ('Jim D', 'HR', 100000, 'jim@example.com'),
  ('Anna K', 'Finance', 100000, 'anna@example.com'),
  ('Bruce L', 'Engineering', 100000, 'bruce@example.com'),
  ('Carrie F', 'Business', 100000, 'carrie@example.com');

La policy di accesso alle righe nella seguente istruzione limita l'esecuzione di query ai membri del dominio aziendale. Inoltre, l'utilizzo della funzione SESSION_USER() limita l'accesso solo alle righe che appartengono all'utente che esegue la query, in base al suo indirizzo email.

CREATE ROW ACCESS POLICY
  salary_personal
ON
  dataset1.table1 GRANT TO ("domain:example.com")
  FILTER USING
  (Email=SESSION_USER());

L'immagine seguente mostra in che modo la policy di accesso alle righe limita la tabella contenente le informazioni sugli stipendi. In questo esempio, l'utente si chiama Jim e ha l'indirizzo email jim@example.com.

Caso d'uso della sicurezza a livello di riga per gli stipendi

Per altri esempi di sicurezza a livello di riga, consulta Utilizza la sicurezza a livello di riga.

Filtra i dati delle righe in base alla tabella di ricerca

Con il supporto delle sottoquery, le policy di accesso alle righe possono fare riferimento ad altre tabelle e utilizzarle come tabelle di ricerca. I dati utilizzati nelle regole di filtro possono essere archiviati in una tabella e una singola policy di accesso alle righe della sottoquery può sostituire più policy di accesso alle righe configurate. Per aggiornare le policy di accesso alle righe, devi solo aggiornare la tabella di ricerca, che sostituisce più policy di accesso alle righe. Non è necessario aggiornare ogni singola policy di accesso riga.

Per esempi di filtro dei dati delle righe, consulta Utilizza la sicurezza a livello di riga.

Quando utilizzare la sicurezza a livello di riga rispetto ad altri metodi

Le viste autorizzate, le policy di accesso a livello di riga e l'archiviazione dei dati in tabelle separate offrono livelli diversi di sicurezza, prestazioni e praticità. La scelta del meccanismo giusto per il tuo caso d'uso è importante per garantire il livello di sicurezza appropriato per i tuoi dati.

Confronto con le visualizzazioni autorizzate: vulnerabilità

Sia la sicurezza a livello di riga sia l'applicazione forzata dell'accesso a livello di riga con una vista autorizzata possono presentare vulnerabilità, se utilizzate in modo improprio.

Quando utilizzi viste autorizzate o policy di accesso a livello di riga per la sicurezza a livello di riga, ti consigliamo di monitorare eventuali attività sospette utilizzando l'audit logging.

I canali laterali, come la durata della query, possono far trapelare informazioni sulle righe che si trovano al limite di uno shard di archiviazione. Questi attacchi richiederebbero probabilmente una certa conoscenza di come viene eseguito lo sharding della tabella o un numero elevato di query.

Per ulteriori informazioni su come prevenire questi attacchi side-channel, consulta Best practice per la sicurezza a livello di riga.

Confronto tra viste autorizzate, sicurezza a livello di riga e tabelle separate

La tabella seguente mette a confronto la flessibilità, le prestazioni e la sicurezza di viste autorizzate, policy di accesso a livello di riga e tabelle separate.

Metodo Considerazioni sulla sicurezza Consiglio
Visualizzazioni
autorizzate
Consigliato per la flessibilità. Può essere vulnerabile a query create con cura, durate delle query e altri tipi di attacchi side channel. Le viste autorizzate sono una buona scelta quando devi condividere dati con altri e la flessibilità e le prestazioni sono importanti. Ad esempio, puoi utilizzare le viste autorizzate per condividere i dati all'interno del tuo gruppo di lavoro.
Policy di accesso a livello di riga Consigliato per un equilibrio tra flessibilità e sicurezza. Può essere vulnerabile ad attacchi side channel alla durata delle query. Le policy di accesso a livello di riga sono una buona scelta quando devi condividere dati con altri e vuoi fornire una sicurezza aggiuntiva per le visualizzazioni o le sezioni delle tabelle. Ad esempio, puoi utilizzare le policy di accesso a livello di riga per condividere i dati con persone che utilizzano tutte la stessa dashboard, anche se alcune persone hanno accesso a più dati rispetto ad altre.
Tabelle separate Opzione consigliata per la sicurezza. Gli utenti non possono dedurre i dati senza l'accesso alla tabella. Le tabelle separate sono una buona scelta quando devi condividere i dati con altri e devi mantenerli isolati. Ad esempio, puoi utilizzare tabelle separate per condividere dati con partner e fornitori di terze parti, quando il numero totale di righe deve essere segreto.

Crea e gestisci le policy di accesso a livello di riga

Per informazioni su come creare, aggiornare (ricreare), elencare, visualizzare ed eliminare le policy di accesso a livello di riga in una tabella e su come eseguire query sulle tabelle con policy di accesso a livello di riga, consulta Utilizzo della sicurezza dell'accesso a livello di riga.

Eliminazione implicita delle policy di accesso a livello di riga

Le policy di accesso alle righe possono essere rimosse in modo implicito (automatico) da una tabella in diverse condizioni.

Il principio generale per l'eliminazione automatica delle policy di accesso alle righe è il seguente:

  • Le operazioni che utilizzano una disposizione di scrittura WRITE_TRUNCATE sovrascrivono sempre le policy di accesso alle righe esistenti nella tabella di destinazione.
  • Per le operazioni con una disposizione di scrittura WRITE_APPEND, le policy di accesso alle righe correnti della tabella di destinazione vengono conservate e le policy della tabella di origine vengono aggiunte alla tabella di destinazione.

Nello specifico, le policy di accesso alle righe vengono rimosse implicitamente nelle seguenti situazioni:

  • Sostituzione di una tabella: quando una tabella viene sostituita utilizzando l'istruzione DDL CREATE OR REPLACE TABLE, tutte le policy di accesso alle righe esistenti nella tabella originale vengono eliminate. Questo accade anche se la query di sostituzione si basa sui dati della tabella originale.

  • Caricamento o query con WRITE_TRUNCATE: le operazioni che utilizzano la disposizione di scrittura WRITE_TRUNCATE rimuovono tutte le policy di accesso alle righe esistenti. Ciò include il caricamento dei dati utilizzando il comando bq load --replace e l'esecuzione di una query con lo stato di writeDisposition impostato su WRITE_TRUNCATE. Queste operazioni sovrascrivono completamente la tabella e le policy di accesso alle righe non vengono trasferite.

  • Eliminazione o scadenza della tabella: se una tabella viene eliminata esplicitamente o se raggiunge la data di scadenza e viene rimossa automaticamente, vengono eliminate anche tutte le policy di accesso alle righe associate.

  • Operazioni di copia delle tabelle: quando copi una tabella senza policy di accesso alle righe in una tabella di destinazione con policy di accesso alle righe, le policy sulla tabella di destinazione vengono rimosse, a meno che non venga utilizzato il flag --append_table o "writeDisposition": "WRITE_APPEND". Per saperne di più sui job di copia delle tabelle, consulta Utilizzo della sicurezza a livello di riga con altre funzionalità di BigQuery.

L'utilizzo dell'istruzione DML TRUNCATE TABLE, che rimuove tutte le righe da una tabella mantenendo lo schema, non rimuove le policy di accesso alle righe.

Quote

Per saperne di più su quote e limiti per la sicurezza a livello di riga, consulta Quote e limiti di BigQuery.

Prezzi

La sicurezza a livello di riga è inclusa in BigQuery senza costi aggiuntivi. Tuttavia, una policy di accesso a livello di riga può influire sul costo di esecuzione di una query nei seguenti modi:

  • La fatturazione aggiuntiva può essere causata da policy di accesso a livello di riga, in particolare policy che includono sottoquery che fanno riferimento ad altre tabelle.

  • I filtri delle policy di accesso a livello di riga non partecipano alla riduzione delle query sulle tabelle partizionate e in cluster. Ciò non significa che legga più dati durante l'esecuzione della query principale. Non sfrutta i predicati della policy di accesso alle righe per eseguire un'ulteriore eliminazione.

  • Con i filtri delle policy di accesso a livello di riga, non tutti i filtri utente vengono applicati in anticipo. Ciò potrebbe aumentare i dati letti dalle tabelle e potrebbe leggere e fatturare più righe.

Per saperne di più sui prezzi delle query di BigQuery, consulta Prezzi di BigQuery.

Limitazioni

Per informazioni sui limiti per la sicurezza a livello di riga, consulta Limiti della sicurezza a livello di riga di BigQuery. Le sezioni seguenti documentano ulteriori limitazioni della sicurezza a livello di riga.

Limitazioni delle prestazioni

  • Alcune funzionalità di BigQuery non vengono accelerate quando si utilizzano tabelle contenenti policy di accesso a livello di riga, come BigQuery BI Engine e le viste materializzate.

  • La sicurezza a livello di riga non partecipa alla eliminazione delle query, che è una funzionalità delle tabelle partizionate. Per saperne di più, consulta Tabelle partizionate e in cluster. Questa limitazione non rallenta l'esecuzione della query principale.

  • Potresti riscontrare un lieve peggioramento delle prestazioni quando esegui query su tabelle con sicurezza a livello di riga.

Per saperne di più su come la sicurezza a livello di riga interagisce con alcune funzionalità e servizi di BigQuery, consulta Utilizzo della sicurezza a livello di riga con altre funzionalità di BigQuery.

Altre limitazioni

  • Questa funzionalità potrebbe non essere disponibile quando utilizzi prenotazioni create con determinate versioni di BigQuery. Per ulteriori informazioni sulle funzionalità abilitate in ogni versione, consulta Introduzione alle versioni di BigQuery.

  • Le policy di accesso alle righe non sono compatibili con l'SQL precedente. Le query delle tabelle con policy di accesso a livello di riga devono utilizzare GoogleSQL. Le query SQL precedente vengono rifiutate con un errore.

  • Non puoi applicare policy di accesso a livello di riga alle colonne JSON.

  • Le query sulle tabelle con funzione carattere jolly non sono supportate per le tabelle con policy di accesso alle righe.

  • Le policy di accesso alle righe non possono essere applicate alle tabelle temporanee.

  • Non puoi applicare policy di accesso a livello di riga a tabelle che fanno riferimento ad altre tabelle con sicurezza a livello di riga.

  • Alcune funzionalità di BigQuery non sono compatibili con la sicurezza a livello di riga. Per saperne di più, consulta Utilizzo della sicurezza a livello di riga.

    • Le policy di accesso a livello di riga che incorporano subquery non sono compatibili con l'API BigQuery Storage Read. L'API BigQuery Storage Read supporta solo predicati di filtro semplici.
  • Le operazioni non di query, inclusi i job dei account di servizio, che richiedono l'accesso completo ai dati della tabella possono utilizzare la sicurezza a livello di riga con il filtro TRUE. Gli esempi includono la copia delle tabelle, i workflow di Managed Service for Apache Spark e altro ancora. Per saperne di più, consulta Utilizzo della sicurezza a livello di riga.

  • Puoi creare, sostituire o eliminare le policy di accesso a livello di riga con istruzioni DDL o API delle policy di accesso alle righe. Puoi anche eseguire tutte le azioni disponibili nelle API delle policy di accesso alle righe nello strumento a riga di comando bq. Puoi elencare e visualizzare le policy di accesso a livello di riga nella consoleCloud de Confiance .

  • L'anteprima o la navigazione delle tabelle non è compatibile con la sicurezza a livello di riga.

  • Il campionamento delle tabelle non è compatibile con la sicurezza a livello di riga.

  • Le policy di accesso a livello di riga impongono un limite di 100 MB ai risultati delle sottoquery di primo livello al loro interno. Il superamento di questa soglia causerà l'esito negativo della query. È importante sottolineare che questa limitazione viene applicata in base alla singola policy e non influisce sulla query dell'utente.

  • Le sottoquery IN di primo livello in cui il tipo di search_value è FLOAT, STRUCT, ARRAY, JSON o GEOGRAPHY non sono disponibili nelle policy di accesso alle righe.

  • Se il predicato della policy di accesso a livello di riga non può essere valutato a causa dell'eliminazione di una tabella di riferimento, la query non va a buon fine.

  • Le policy di accesso a livello di riga delle sottoquery supportano solo le tabelle BigQuery, le tabelle esterne BigLake e le tabelle gestite BigLake.

  • Le istruzioni di ridenominazione e eliminazione delle colonne che modificano lo schema della tabella sono consentite solo se la colonna da eliminare o rinominare non fa parte di una policy di accesso alle righe.

  • L'oscuramento dei dati è compatibile solo con le query che hanno policy di accesso alle righe non di sottoquery. Il mascheramento dei dati viene applicato oltre alla sicurezza a livello di riga. Ad esempio, se è applicata una policy di accesso alle righe su location = "US" e location è mascherato, gli utenti possono visualizzare le righe in cui location = "US", ma il campo della località è mascherato nei risultati. Le query che coinvolgono una policy di accesso alle righe della sottoquery richiedono l'accesso come Lettore granulare alle colonne a cui fanno riferimento le policy di accesso alle righe.

Audit logging e monitoraggio

Puoi monitorare la sicurezza a livello di riga in BigQuery in due modi: utilizza gli audit log in Cloud Logging per monitorare il ciclo di vita delle policy e gli eventi di accesso ai dati oppure esegui query sulla vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES per esaminare le definizioni e i metadati delle policy di accesso a livello di riga attive.

Audit logging

Quando vengono letti i dati in una tabella con una o più policy di accesso a livello di riga, le policy di accesso a livello di riga autorizzate per l'accesso in lettura e le eventuali tabelle corrispondenti a cui viene fatto riferimento nelle sottoquery vengono visualizzate nelle informazioni di autorizzazione IAM per la richiesta di lettura.

La creazione e l'eliminazione delle policy di accesso a livello di riga vengono registrate negli audit log e sono accessibili tramite Cloud Logging. Gli audit log includono il nome della policy di accesso a livello di riga. Tuttavia, le definizioni filter_expression e grantee_list di una policy di accesso a livello di riga vengono omesse dai log, in quanto potrebbero contenere informazioni sensibili sull'utente o di altro tipo. L'elenco e la visualizzazione delle policy di accesso a livello di riga non vengono registrati nell'audit log.

Per saperne di più sul logging in BigQuery, consulta Introduzione al monitoraggio di BigQuery.

Per saperne di più sul logging in Cloud de Confiance, consulta Cloud Logging.

Monitora con INFORMATION_SCHEMA

Puoi eseguire query sulla vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES per recuperare i metadati in tempo reale sulle policy di accesso a livello di riga attive in un set di dati o in una regione. La vista restituisce la tabella di destinazione di ogni policy, il nome della policy, il predicato del filtro (filter_predicate), l'ora di creazione e l'ora dell'ultima modifica.

Passaggi successivi