Questa pagina fornisce informazioni supplementari per l'utilizzo di Cloud Audit Logs con Cloud Storage. Utilizza Cloud Audit Logs per generare log per le operazioni API eseguite in Cloud Storage.
Panoramica
I serviziGoogle Cloud scrivono gli audit log per aiutarti a rispondere alle domande "Chi ha fatto cosa, dove e quando?" all'interno delle tue risorse Google Cloud . Puoi anche allegare informazioni personalizzate agli audit log per ottenere informazioni più granulari su come viene eseguito l'accesso alle tue risorse.
I tuoi progetti Google Cloud contengono solo gli audit log per le risorse che si trovano direttamente all'interno del progetto Google Cloud . Altre risorse, come cartelle, organizzazioni e account di fatturazione, contengono gli audit log per l'entità stessa. Google Cloud
Per una panoramica generale di Cloud Audit Logs, consulta Panoramica di Cloud Audit Logs. Per una comprensione più approfondita del formato del log di controllo, vedi Comprendere i log di controllo.
Log di controllo disponibili
Per Cloud Storage sono disponibili i seguenti tipi di log di controllo:
Audit log delle attività di amministrazione: voci per le operazioni che:
- modificare l'accesso alle risorse Cloud Storage
- ripristinare o spostare i bucket
- creare, eliminare o modificare bucket, cartelle gestite o configurazioni di report dell'inventario
- creare, mettere in pausa, riprendere, disattivare, aggiornare, elencare o ottenere le cache Anywhere Cache
Audit log Accesso ai dati: voci per le operazioni non monitorate negli audit log Attività di amministrazione. Esistono diversi sottotipi di audit log di accesso ai dati:
ADMIN_READ
: voci per le operazioni che leggono le configurazioni di accesso, leggono i metadati dei bucket o elencano i bucket all'interno di un progetto.DATA_READ
: voci per le operazioni che leggono o elencano risorse Cloud Storage diverse dai bucket.DATA_WRITE
: voci per le operazioni che creano, modificano, eliminano o ripristinano oggetti o che creano, modificano o eliminano caricamenti multipart API XML o che creano, eliminano o ridenominano cartelle.
Per ricevere gli audit log di accesso ai dati, devi abilitarli esplicitamente.
Audit log degli eventi di sistema: voci per le operazioni Google Cloud che modificano la configurazione delle risorse Cloud Storage. Vengono generati dai sistemi Google Cloud e non sono determinati dall'azione dell'utente.
Oltre agli audit log per Cloud Storage, Cloud Audit Logs può creare audit log per Storage Insights. I log di controllo di Storage Insights vengono generati ogni volta che vengono create, aggiornate e recuperate le configurazioni dei report sull'inventario e quando vengono recuperati i report sull'inventario.
Per descrizioni più dettagliate dei tipi di log di controllo, vedi Tipi di log di controllo.
Operazioni con audit
La tabella seguente riassume le operazioni di Cloud Storage corrispondenti a ogni tipo di audit log:
Tipo di audit log | Sottotipo | Operazioni di Cloud Storage |
---|---|---|
Attività di amministrazione | ADMIN_WRITE |
|
Accesso ai dati | ADMIN_READ |
|
Accesso ai dati | DATA_READ |
|
Accesso ai dati | DATA_WRITE |
|
Evento di sistema |
|
1 I log di controllo Attività di amministrazione non vengono generati se/quando gli ACL vengono impostati inizialmente al momento della creazione dell'oggetto. Inoltre, se un ACL oggetto è impostato su pubblico, non vengono generati audit log per le letture o le scritture nell'oggetto o nel relativo ACL.
2 Queste operazioni comportano la lettura e la scrittura dei dati. Di conseguenza, queste operazioni generano due voci di log ciascuna.
3 Il trasferimento del bucket potrebbe non iniziare immediatamente dopo la richiesta iniziale. Il log eventi di sistema viene scritto quando il processo inizia effettivamente.
Limitazioni
Si applicano le seguenti limitazioni a Cloud Audit Logs con Cloud Storage:
- Cloud Audit Logs non monitora l'accesso agli oggetti pubblici.
- Cloud Audit Logs non tiene traccia delle modifiche apportate dalle funzionalità Gestione del ciclo di vita degli oggetti o Autoclass.
- I log di accesso ai dati generati dai download autenticati del browser hanno
i campi
principalEmail
ecallerIp
oscurati quando il download avviene al di fuori della console Google Cloud .
Se hai bisogno di funzionalità di logging in uno di questi casi, valuta l'utilizzo dei log di utilizzo di Cloud Storage.
Formato degli audit log
Le voci dei log di controllo includono i seguenti componenti:
La voce di log stessa, che è un oggetto
LogEntry
. Di seguito vengono riportati alcuni campi utili:logName
contiene l'ID risorsa e il tipo di log di controllo.resource
contiene il target dell'operazione sottoposta ad audit.timestamp
contiene l'ora dell'operazione sottoposta ad audit.- Il
protoPayload
contiene le informazioni sottoposte ad audit.
I dati di audit log, che sono un oggetto
AuditLog
contenuto nel campoprotoPayload
della voce di log.All'interno del campo
protoPayload
, il campometadata
include informazioni specifiche per Cloud Storage. Ad esempio, una richiesta di lettura dell'oggetto include un camporequested_bytes
nel campometadata
del relativo audit log. Quando la richiesta viene chiamata con un'intestazionerange
, il valore dell'intervallo viene inserito nel campometadata
; in caso contrario, il camporequested_bytes
nei metadati viene compilato con le dimensioni totali dell'oggetto.All'interno di
protoPayload
, le informazioni di audit aggiuntive specifiche per Cloud Storage sono incluse nei campi di richiesta e risposta quando è applicata la modalità di audit logging dettagliata; tuttavia, non è necessario attivare l'audit logging dettagliato per aggiungere le tue informazioni personalizzate ai log di controllo.
Per informazioni sugli altri campi in questi oggetti e su come interpretarli, vedi Comprendere i log di controllo.
Nome log
I nomi dei log di Audit log di Cloud includono identificatori di risorse che indicano ilGoogle Cloud progetto o un'altra Google Cloud entità proprietaria degli audit log, oltre a specificare se il log contiene dati di audit logging per l'attività di amministrazione o l'accesso ai dati.
Di seguito sono riportati i nomi dei log di controllo, incluse le variabili per gli identificatori delle risorse:
projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Factivity folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Fdata_access billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Factivity billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Fdata_access organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Factivity organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Fdata_access
Nome servizio
Gli audit log di Cloud Storage utilizzano il nome servizio
storage.googleapis.com
.
Gli audit log di Storage Insights utilizzano il nome servizio
storageinsights.googleapis.com
.
Per un elenco di tutti i nomi dei servizi API Cloud Logging e dei relativi tipi di risorsa monitorata, consulta Mappare i servizi alle risorse.
Tipi di risorse
Gli audit log di Cloud Storage utilizzano il tipo di risorsa gcs_bucket
.
Per un elenco di tutti i tipi di risorsa monitorata di Cloud Logging e informazioni descrittive, consulta Tipi di risorse monitorate.
Abilitazione degli audit log
Gli audit log per le attività di amministrazione sono sempre abilitati e non possono essere disabilitati.
Gli audit log di accesso ai dati sono disabilitati per impostazione predefinita e non vengono scritti a meno che non vengano abilitati esplicitamente.
Per informazioni sull'abilitazione di alcuni o tutti gli audit log di accesso ai dati, consulta la pagina Configurare gli audit log di accesso ai dati.
Autorizzazioni e ruoli
I ruoli e le autorizzazioni IAM determinano la tua capacità di accedere ai dati degli audit log nelle risorse Google Cloud .
Quando decidi quali autorizzazioni e ruoli specifici per la registrazione si applicano al tuo caso d'uso, considera quanto segue:
Il ruolo Visualizzatore log (
roles/logging.viewer
) ti consente di accedere in sola lettura agli audit log di attività di amministrazione, accesso negato in base ai criteri ed eventi di sistema. Se hai solo questo ruolo, non puoi visualizzare gli audit log di accesso ai dati che si trovano nei bucket_Required
e_Default
.Il ruolo Visualizzatore log privati
(roles/logging.privateLogViewer
) include le autorizzazioni contenute inroles/logging.viewer
, oltre alla possibilità di leggere gli audit log di accesso ai dati nei bucket_Required
e_Default
.Tieni presente che se questi log privati sono archiviati in bucket definiti dall'utente, qualsiasi utente che dispone delle autorizzazioni per leggere i log in questi bucket può leggere i log privati. Per saperne di più sui bucket di log, consulta la panoramica su routing e archiviazione.
Per saperne di più sui ruoli e sulle autorizzazioni IAM che si applicano ai dati degli audit log, consulta Controllo dell'accesso con IAM.
Visualizzazione dei log
Puoi eseguire query su tutti i log di controllo o su log specifici in base al nome. Il nome dell'audit log include l'identificatore della risorsa del progetto, della cartella, dell'account di fatturazione o dell' Google Cloud organizzazione per cui vuoi visualizzare le informazioni di audit logging.
Le query possono specificare campi LogEntry
indicizzati.
Per ulteriori informazioni su come eseguire query sui log, consulta
Creare query in Esplora log
Esplora log consente di visualizzare e filtrare le singole voci di log. Se vuoi utilizzare SQL per analizzare gruppi di voci di log, utilizza la pagina Analisi dei log. Per ulteriori informazioni, vedi:
- Eseguire query e visualizzare i log in Analisi dei log.
- Query di esempio per gli approfondimenti sulla sicurezza.
- Risultati della query del grafico.
La maggior parte degli audit log può essere visualizzata in Cloud Logging utilizzando la consoleGoogle Cloud , Google Cloud CLI o l'API Logging. Tuttavia, per gli audit log relativi alla fatturazione, puoi utilizzare solo Google Cloud CLI o l'API Logging.
Console
Nella console Google Cloud , puoi utilizzare Esplora log per recuperare le voci di audit log per il tuo progetto, la tua cartella o la tua organizzazione Google Cloud :
-
Nella Google Cloud console, vai alla pagina Esplora log:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
Seleziona un progetto, una cartella o un'organizzazione Google Cloud esistente.
Per visualizzare tutti i log di controllo, inserisci una delle seguenti query nel campo dell'editor di query, quindi fai clic su Esegui query:
logName:"cloudaudit.googleapis.com"
protoPayload."@type"="type.googleapis.com/google.cloud.audit.AuditLog"
Per visualizzare i log di controllo per un tipo di risorsa e di log di controllo specifici, nel riquadro Generatore di query:
In Tipo di risorsa, seleziona la risorsa di cui vuoi visualizzare gli audit log. Google Cloud
In Nome log, seleziona il tipo di audit log che vuoi visualizzare:
- Per gli audit log delle attività di amministrazione, seleziona activity.
- Per gli audit log di accesso ai dati, seleziona data_access.
- Per gli audit log degli eventi di sistema, seleziona system_event.
- Per gli audit log negati da criteri, seleziona policy.
Fai clic su Esegui query.
Se non vedi queste opzioni, significa che non sono disponibili audit log di questo tipo nel progetto, nella cartella o nell'organizzazione. Google Cloud
Se riscontri problemi quando provi a visualizzare i log in Esplora log, consulta le informazioni per la risoluzione dei problemi.
Per ulteriori informazioni sull'esecuzione di query utilizzando Esplora log, vedi Creare query in Esplora log.
gcloud
Google Cloud CLI fornisce un'interfaccia a riga di comando per l'API Logging. Fornisci un identificatore di risorsa valido in ciascuno dei nomi dei log. Ad esempio, se la query include PROJECT_ID, l'identificatore del progetto che fornisci deve fare riferimento al progettoGoogle Cloud attualmente selezionato.
Per leggere le voci del log di controllo a livello di progetto Google Cloud , esegui il seguente comando:
gcloud logging read "logName : projects/PROJECT_ID/logs/cloudaudit.googleapis.com" \ --project=PROJECT_ID
Per leggere le voci del log di controllo a livello di cartella, esegui il comando seguente:
gcloud logging read "logName : folders/FOLDER_ID/logs/cloudaudit.googleapis.com" \ --folder=FOLDER_ID
Per leggere le voci di audit log a livello di organizzazione, esegui questo comando:
gcloud logging read "logName : organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com" \ --organization=ORGANIZATION_ID
Per leggere le voci del log di controllo a livello di account di fatturazione Cloud, esegui questo comando:
gcloud logging read "logName : billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com" \ --billing-account=BILLING_ACCOUNT_ID
Aggiungi il flag --freshness
al comando per leggere i log più vecchi di un giorno.
Per saperne di più sull'utilizzo di gcloud CLI, consulta
gcloud logging read
.
REST
Quando crei le query, fornisci un identificatore di risorsa valido in ciascuno dei nomi dei log. Ad esempio, se la query include PROJECT_ID, l'identificatore di progetto che fornisci deve fare riferimento al progetto Google Cloud attualmente selezionato.
Ad esempio, per utilizzare l'API Logging per visualizzare le voci di audit log a livello di progetto, procedi nel seguente modo:
Vai alla sezione Prova questa API nella documentazione del metodo
entries.list
.Inserisci quanto segue nella sezione Corpo della richiesta del modulo Prova questa API. Se fai clic su questo modulo precompilato, il corpo della richiesta viene compilato automaticamente, ma devi fornire un PROJECT_ID valido in ciascuno dei nomi dei log.
{ "resourceNames": [ "projects/PROJECT_ID" ], "pageSize": 5, "filter": "logName : projects/PROJECT_ID/logs/cloudaudit.googleapis.com" }
Fai clic su Esegui.
Aggiungere informazioni personalizzate ai log di controllo
Puoi allegare informazioni personalizzate alle richieste di inclusione nei log di controllo includendo l'intestazione x-goog-custom-audit-KEY: VALUE
nella richiesta. Le richieste API XML supportano inoltre l'utilizzo di un parametro di
query x-goog-custom-audit-KEY=VALUE
. Le informazioni personalizzate vengono aggiunte al campo metadata
di
protoPayload
nellavoce di logg di controllo.
Quando aggiungi informazioni di controllo personalizzate, tieni presente le seguenti considerazioni:
Ogni
KEY
, con l'inclusione del prefissox-goog-custom-audit-
, può contenere fino a 64 caratteri, mentre ogniVALUE
può contenere fino a 1200 caratteri.Ogni richiesta può contenere fino a 4 voci di intestazione o parametro combinate.
Esempi di voci di intestazione
Il seguente elenco mostra esempi di coppie chiave-valore che puoi includere nelle voci di intestazione:
x-goog-custom-audit-job: test-job-id-here
x-goog-custom-audit-user: user ID test 1
x-goog-custom-audit-internal-user-id: MATR2022-11
x-goog-custom-audit-tracking-ticket: TT/1516512851
x-goog-custom-audit-justification: Removed customer identity record at customer request
x-goog-custom-audit-customer-id: USCU12315154
Esempi di richieste
Riga di comando
gcloud storage hash gs://example_bucket/example_object.jpeg --additional-headers=x-goog-custom-audit-job="job name",x-goog-custom-audit-user="test user"
Librerie client
C++
Per scoprire come aggiungere intestazioni personalizzate alle richieste, vedi Aggiungere intestazioni personalizzate.
C#
Per scoprire come aggiungere intestazioni personalizzate alle richieste, vedi Aggiungere intestazioni personalizzate.
Vai
Per scoprire come aggiungere intestazioni personalizzate alle richieste, vedi Aggiungere intestazioni personalizzate.
Java
Per scoprire come aggiungere intestazioni personalizzate alle richieste, vedi Aggiungere intestazioni personalizzate.
Node.js
Per scoprire come aggiungere intestazioni personalizzate alle richieste, vedi Aggiungere intestazioni personalizzate.
PHP
Per scoprire come aggiungere intestazioni personalizzate alle richieste, vedi Aggiungere intestazioni personalizzate.
Python
Per scoprire come aggiungere intestazioni personalizzate alle richieste, vedi Aggiungere intestazioni personalizzate.
Ruby
Per scoprire come aggiungere intestazioni personalizzate alle richieste, vedi Aggiungere intestazioni personalizzate.
API REST
API JSON
curl -X GET "https://storage.googleapis.com/storage/v1/b/example_bucket/o/example_object" \ -H "Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg" \ -H "x-goog-custom-audit-job: job name" \ -H "x-goog-custom-audit-user: test user"
API XML
curl -X GET "https://storage.googleapis.com/example_bucket/example_object" \ -H "Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg" \ -H "x-goog-custom-audit-job: job name" \ -H "x-goog-custom-audit-user: test user"
Richieste di URL firmati
curl -X GET 'storage.googleapis.com/example_bucket?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=example%40example-project.iam.gserviceaccount.com%2F20181026%2Fus-central1%2Fstorage%2Fgoog4_request&X-Goog-Date=20181026T181309Z&X-Goog-Expires=900&X-Goog-SignedHeaders=host,x-goog-custom-audit-job,x-goog-custom-audit-user&X-Goog-Signature=247a2aa45f169edf4d187d54e7cc46e4731b1e6273242c4f4c39a1d2507a0e58706e25e3a85a7dbb891d62afa8496def8e260c1db863d9ace85ff0a184b894b117fe46d1225c82f2aa19efd52cf21d3e2022b3b868dcc1aca2741951ed5bf3bb25a34f5e9316a2841e8ff4c530b22ceaa1c5ce09c7cbb5732631510c20580e61723f5594de3aea497f195456a2ff2bdd0d13bad47289d8611b6f9cfeef0c46c91a455b94e90a66924f722292d21e24d31dcfb38ce0c0f353ffa5a9756fc2a9f2b40bc2113206a81e324fc4fd6823a29163fa845c8ae7eca1fcf6e5bb48b3200983c56c5ca81fffb151cca7402beddfc4a76b133447032ea7abedc098d2eb14a7' \ -H "x-goog-custom-audit-job: job name" \ -H "x-goog-custom-audit-user: test user"
Tieni presente che le intestazioni di controllo personalizzate devono essere incluse anche in
X-Goog-SignedHeaders
.
Per creare una richiesta di URL firmato che supporti l'aggiunta di intestazioni di controllo personalizzate, le intestazioni di controllo personalizzate che vuoi utilizzare nella richiesta devono essere incluse anche quando generi l'URL firmato. Ad esempio:
gcloud storage sign-url gs://example_bucket/example_object.jpeg --private-key-file=example-key.json --duration=10m --headers=x-goog-custom-audit-job:"job name",x-goog-custom-audit-user="test user"
Puoi anche utilizzare le librerie client per generare l'URL firmato quando imposti intestazioni personalizzate.
In alternativa all'utilizzo delle intestazioni firmate, puoi utilizzare parametri di ricerca per trasmettere voci di controllo personalizzate.
curl -X GET 'storage.googleapis.com/example_bucket?X-Goog-Custom-Audit-Key=Value&X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=example%40example-project.iam.gserviceaccount.com%2F20181026%2Fus-central1%2Fstorage%2Fgoog4_request&X-Goog-Date=20181026T181309Z&X-Goog-Expires=900&X-Goog-SignedHeaders=host&X-Goog-Signature=247a2aa45f169edf4d187d54e7cc46e4731b1e6273242c4f4c39a1d2507a0e58706e25e3a85a7dbb891d62afa8496def8e260c1db863d9ace85ff0a184b894b117fe46d1225c82f2aa19efd52cf21d3e2022b3b868dcc1aca2741951ed5bf3bb25a34f5e9316a2841e8ff4c530b22ceaa1c5ce09c7cbb5732631510c20580e61723f5594de3aea497f195456a2ff2bdd0d13bad47289d8611b6f9cfeef0c46c91a455b94e90a66924f722292d21e24d31dcfb38ce0c0f353ffa5a9756fc2a9f2b40bc2113206a81e324fc4fd6823a29163fa845c8ae7eca1fcf6e5bb48b3200983c56c5ca81fffb151cca7402beddfc4a76b133447032ea7abedc098d2eb14a7'
Questi parametri di ricerca devono essere inclusi quando generi l'URL firmato. Ad esempio:
gcloud storage sign-url gs://example_bucket/example_object.jpeg --private-key-file=example-key.json --duration=10m --query-params=x-goog-custom-audit-job=job_name,x-goog-custom-audit-user=test_user
Esempio di voce di log
protoPayload: { @type: "type.googleapis.com/google.cloud.audit.Auditlog", ... metadata: { audit_context: { app_context: "EXTERNAL", audit_info: { x-goog-custom-audit-job: "job name", x-goog-custom-audit-user: "test user" } } } }
Per saperne di più sui campi inclusi nell'oggetto protoPayload
con il tipo type.googleapis.com/google.cloud.audit.Auditlog
, consulta la documentazione di riferimento AuditLog
.
Log di controllo delle route
Puoi instradare i log di controllo verso le destinazioni supportate nello stesso modo in cui puoi instradare altri tipi di log. Ecco alcuni motivi per cui potresti voler instradare i tuoi audit log:
- Per conservare gli audit log più a lungo o utilizzare funzionalità di ricerca più avanzate, puoi instradare copie degli audit log a Cloud Storage, BigQuery o Pub/Sub. Utilizza Pub/Sub per eseguire il routing verso altre applicazioni, altri repository e terze parti.
- Per gestire gli audit log in tutta l'organizzazione, puoi creare dei sink aggregati che permettono di indirizzare i log da qualsiasi progetto o anche da tutti i progetti nell'organizzazione. Google Cloud
- Se i log di controllo dell'accesso ai dati abilitati causano il possibile superamento della soglia consentita per i tuoi Google Cloud progetti, puoi creare sink che escludano i log di controllo dell'accesso ai dati da Logging.
Per istruzioni sul routing dei log, consulta Configurare e gestire i sink .
Prezzi
Per informazioni sui prezzi di Cloud Logging, consulta Prezzi di Google Cloud Observability: Cloud Logging.