Autenticazione nell'API DLP

Per utilizzare l'API DLP, devi autenticarti. L'API DLP può gestire sia le chiavi API sia l'autenticazione. La differenza principale tra questi due metodi è:

• Le chiavi API identificano il progetto chiamante, ovvero l'app o il sito, che effettua la chiamata a un'API.
• I token di autenticazione identificano un utente, ovvero la persona che utilizza il progetto.

Utilizzo di una chiave API per l'accesso non autenticato

Puoi utilizzare una chiave API della console Google Cloud per autenticarti all'API DLP per alcuni metodi, inclusi tutti i metodi projects.content.* e projects.image.*.

1. Segui le istruzioni per creare una chiave API per il progetto della console Google Cloud .
2. Quando effettui una richiesta API DLP, passa la chiave come valore di un parametro key. Ad esempio:

   curl https://dlp.googleapis.com/v2/infoTypes?key=[YOUR_API_KEY]

È importante proteggere le chiavi API da un utilizzo non autorizzato. Per consigli su come farlo, consulta Best practice per l'utilizzo sicuro delle chiavi API.

Nota: quando una chiave con wrapping di Cloud Key Management Service viene utilizzata nelle richieste deidentify o reidentify, le chiavi API non possono essere utilizzate per l'autenticazione. Cloud Key Management Service non supporta le chiavi API come metodo di autenticazione. Per saperne di più, consulta Accesso all'API.

utilizza un service account

Per utilizzare un account di servizio per l'autenticazione nell'API DLP:

• Segui le istruzioni per creare un service account. Seleziona JSON come tipo di chiave e concedi all'utente il ruolo Utente DLP (roles/dlp.user).

Per saperne di più sulla concessione dei ruoli ai service account, consulta Concessione dei ruoli ai service account.

Nota: non è necessario concedere all'utente il ruolo Proprietario.

Al termine, la chiave del account di servizio viene scaricata nella località predefinita del browser.

Successivamente, decidi se fornire l'autenticazione del account di servizio come token di connessione o utilizzando le credenziali predefinite dell'applicazione.

Token di connessione che utilizzano un account di servizio

Se chiami direttamente l'API DLP, ad esempio effettuando una richiesta HTTP con cURL, passerai l'autenticazione come token di connessione in un'intestazione della richiesta di autorizzazione HTTP. Per ottenere un token di connessione utilizzando il service account:

1. Installa Google Cloud CLI.
2. Esegui l'autenticazione nel tuo account di servizio, sostituendo [KEY_FILE] di seguito con il percorso del file della chiave del account di servizio:

   gcloud auth activate-service-account --key-file [KEY_FILE]

3. Richiedi un token di autorizzazione utilizzando il service account:

   gcloud auth print-access-token

   Il comando restituisce un valore del token di accesso.
4. Quando chiami l'API, passa il valore del token come token bearer in un'intestazione Authorization:

   curl -s -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer [ACCESS_TOKEN]' \
     'https://dlp.googleapis.com/v2/infoTypes'

Credenziali predefinite dell'applicazione

Se utilizzi una libreria client per chiamare l'API DLP, utilizza le Credenziali predefinite dell'applicazione (ADC).

I servizi che utilizzano ADC cercano le credenziali all'interno di una variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS. A meno che tu non voglia specificamente che ADC utilizzi altre credenziali (ad esempio, le credenziali utente), imposta questa variabile di ambiente in modo che punti al file della chiave del account di servizio.

export GOOGLE_APPLICATION_CREDENTIALS=[PATH_TO_KEY_FILE]

Utilizzo di Sensitive Data Protection dalle VM di Compute Engine

Per accedere all'API DLP dalle istanze VM, seleziona Consenti l'accesso completo a tutte le API Cloud nella sezione Identità e accesso API durante la creazione della VM.