Inviare i risultati dell'ispezione della protezione dei dati sensibili a Data Catalog

Console Google Cloud

Per configurare un job di ispezione di una tabella BigQuery utilizzando Sensitive Data Protection:

1. Nella sezione Protezione dei dati sensibili della console Google Cloud, vai alla pagina Crea job o trigger.

   Vai a Crea job o trigger di job

2. Inserisci le informazioni sul job Sensitive Data Protection e fai clic su Continua per completare ogni passaggio:

   • Per il passaggio 1: scegli i dati di input, assegna un nome al job inserendo un valore nel campo Nome. In Posizione, scegli BigQuery dal menu Tipo di archiviazione, quindi inserisci le informazioni relative alla tabella da ispezionare. La sezione Campionamento è preconfigurata per eseguire un'ispezione di esempio sui tuoi dati. Puoi aggiustare i campi Limita righe per e Numero massimo di righe per risparmiare risorse se hai una grande quantità di dati. Per maggiori dettagli, consulta Scegliere i dati di input.

   • (Facoltativo) Nel passaggio 2: configura il rilevamento, configura i tipi di dati da cercare, chiamati "infoTypes". Ai fini di questa procedura dettagliata, mantieni selezionati gli infoTypes predefiniti. Per maggiori dettagli, vedi Configurare il rilevamento.

   • Per il passaggio 3: aggiungi azioni, attiva Salva in Data Catalog.

   • (Facoltativo) Per il passaggio 4: Pianifica, ai fini di questa procedura guidata, lascia il menu impostato su Nessuna in modo che l'ispezione venga eseguita solo una volta. Per scoprire di più sulla pianificazione dei job di ispezione ripetuti, consulta Pianifica.

3. Fai clic su Crea. Il job viene eseguito immediatamente.

DLP API

In questa sezione, configuri ed esegui un job di ispezione di Sensitive Data Protection.

Il job di ispezione che configuri qui indica a Sensitive Data Protection di ispezionare i dati BigQuery di esempio descritti nel passaggio 2 qui sopra o i tuoi dati BigQuery. La configurazione del job che specifichi è anche dove indichi a Sensitive Data Protection di salvare i risultati dell'ispezione nel Data Catalog.

Passaggio 1: prendi nota dell'identificatore del progetto

1. Vai alla console Google Cloud.

   Vai alla console Google Cloud

2. Fai clic su Seleziona.

3. Nell'elenco a discesa Seleziona da, seleziona l'organizzazione per cui hai attivato Data Catalog.

4. In ID, copia l'ID del progetto che contiene i dati che vuoi esaminare. Si tratta del progetto descritto nel passaggio Imposta i repository di archiviazione precedente in questa pagina.

5. Nella sezione Nome, fai clic sul progetto per selezionarlo.

Passaggio 2: apri Explorer API e configura il job

1. Vai ad API Explorer nella pagina di riferimento del metodo dlpJobs.create. Per mantenere disponibili queste istruzioni, fai clic con il tasto destro del mouse sul seguente link e aprilo in una nuova scheda o finestra:

   Open APIs Explorer

2. Nella casella principale, inserisci quanto segue, dove project-id è l'ID progetto che hai annotato in precedenza nel passaggio precedente:

   projects/project-id

   Poi, copia il seguente JSON. Seleziona i contenuti del campo Request body in Esplora API, quindi incolla il JSON per sostituire i contenuti. Assicurati di sostituire i segnaposto project-id, bigquery-dataset-name e bigquery-table-name con l'ID progetto e i nomi del set di dati e della tabella BigQuery effettivi, rispettivamente.

   {
     "inspectJob":
     {
       "storageConfig":
       {
         "bigQueryOptions":
         {
           "tableReference":
           {
             "projectId": "project-id",
             "datasetId": "bigquery-dataset-name",
             "tableId": "bigquery-table-name"
           }
         }
       },
       "inspectConfig":
       {
         "infoTypes":
         [
           {
             "name": "EMAIL_ADDRESS"
           },
           {
             "name": "PERSON_NAME"
           },
           {
             "name": "US_SOCIAL_SECURITY_NUMBER"
           },
           {
             "name": "PHONE_NUMBER"
           }
         ],
         "includeQuote": true,
         "minLikelihood": "UNLIKELY",
         "limits":
         {
           "maxFindingsPerRequest": 100
         }
       },
       "actions":
       [
         {
           "publishFindingsToCloudDataCatalog": {}
         }
       ]
     }
   }
   

Per scoprire di più sulle opzioni di ispezione disponibili, consulta Ispezione dello spazio di archiviazione e dei database per l'individuazione di dati sensibili. Per un elenco completo delle tipologie di informazioni che Sensitive Data Protection può ispezionare, consulta Riferimento InfoType.

Passaggio 3: esegui la richiesta per avviare il job di ispezione

Dopo aver configurato il job seguendo i passaggi precedenti, fai clic su Esegui per inviare la richiesta. Se la richiesta riesce, viene visualizzata una risposta con un codice di successo e un oggetto JSON che indica lo stato del job Sensitive Data Protection che hai appena creato.

La risposta alla richiesta di ispezione include l'ID del job di ispezione come chiave "name" e lo stato corrente del job di ispezione come chiave "state". Dato che hai appena inviato la richiesta, lo stato del job in quel momento è "PENDING".

Console Google Cloud

Per controllare lo stato del job di ispezione:

1. Nella console Google Cloud, apri Sensitive Data Protection.

   Vai a Sensitive Data Protection

2. Fai clic sulla scheda Job e trigger di job e poi su Tutti i job.

Il job che hai appena eseguito sarà probabilmente in cima all'elenco. Controlla la colonna Stato per assicurarti che lo stato sia Fine.

Puoi fare clic sull'ID job del job per visualizzarne i risultati. Ogni rilevatore infoType elencato nella pagina Dettagli job è seguito dal numero di corrispondenze trovate nei contenuti.

DLP API

Per controllare lo stato del job di ispezione:

1. Vai a Explorer API nella pagina di riferimento del metodo dlpJobs.get facendo clic sul seguente pulsante:

   Open APIs Explorer

2. Nella casella name, digita il nome del job dalla risposta JSON alla richiesta di ispezione nel seguente formato:

   projects/project-id/dlpJobs/job-id

   L'ID job è nel formato i-1234567890123456789.

3. Per inviare la richiesta, fai clic su Esegui.

Se la chiave "state" dell'oggetto JSON della risposta indica che il job è "DONE", il job di ispezione è terminato.

Per visualizzare il resto della risposta JSON, scorri verso il basso nella pagina. In "result" > "infoTypeStats", ogni tipo di informazione elencato deve avere un corrispondente "count". In caso contrario, assicurati di aver inserito il JSON in modo accurato e che il percorso o la posizione dei dati sia corretto.

Al termine del job di ispezione, puoi passare alla sezione successiva di questa guida per visualizzare i risultati dell'ispezione in Security Command Center.

Console Google Cloud

1. Nella console Google Cloud, apri Sensitive Data Protection.

   Vai a Sensitive Data Protection

2. Fai clic sulla scheda Job e trigger di job e poi sulla scheda Trigger di job.

3. Nella colonna Azioni relativa all'attivatore di job da eliminare, fai clic sul menu Altre azioni (visualizzato come tre puntini disposti in verticale)more_vert e poi su Elimina.

Se vuoi, puoi anche eliminare i dettagli del job che hai eseguito. Fai clic sulla scheda Tutti i job e poi, nella colonna Azioni relativa al job da eliminare, fai clic sul menu Altre azioni (visualizzato come tre puntini disposti in verticale)more_vert e poi su Elimina.

DLP API

1. Vai a Explorer API nella pagina di riferimento del metodo dlpJobs.delete facendo clic sul seguente pulsante:

   Open APIs Explorer

2. Nella casella name, digita il nome del job dalla risposta JSON alla richiesta di ispezione, che ha il seguente formato:

   projects/project-id/dlpJobs/job-id

   L'ID job è nel formato i-1234567890123456789.

Se hai creato job di ispezione aggiuntivi o se vuoi assicurarti di averli eliminati correttamente, puoi elencare tutti i job esistenti:

1. Vai a Explorer API nella pagina di riferimento del metodo dlpJobs.list facendo clic sul seguente pulsante:

   Open APIs Explorer

2. Nella casella principale, digita l'identificatore del progetto nel seguente formato, dove project-id è l'identificatore del progetto:

   projects/project-id

3. Fai clic su Execute (Esegui).

Se nella risposta non sono elencati job, significa che li hai eliminati tutti. Se nella risposta sono elencati job, ripeti la procedura di eliminazione descritta sopra per questi job.