Audit logging di Certificate Manager

Questo documento descrive l'audit logging per i servizi Google Cloud Certificate Manager.generano audit log che registrano le attività amministrative e di accesso all'interno delle Google Cloud risorse. Per ulteriori informazioni su Cloud Audit Logs, consulta quanto segue:

• Tipi di log di controllo
• Struttura voce di log di controllo
• Archiviazione e inoltro dei log di controllo
• Riepilogo dei prezzi di Cloud Logging
• Attivare gli audit log di accesso ai dati

Nome servizio

Gli audit log di Certificate Manager utilizzano il nome del servizio certificatemanager.googleapis.com. Filtra per questo servizio:

    protoPayload.serviceName="certificatemanager.googleapis.com"
  

Metodi per tipo di autorizzazione

Ogni autorizzazione IAM ha una proprietà type, il cui valore è un enum che può essere uno dei quattro valori: ADMIN_READ, ADMIN_WRITE, DATA_READ o DATA_WRITE. Quando chiami un metodo, Certificate Manager genera un log di controllo la cui categoria dipende dalla proprietà type dell'autorizzazione richiesta per eseguire il metodo. I metodi che richiedono un'autorizzazione IAM con il valore della proprietà type corrispondente a DATA_READ, DATA_WRITE o ADMIN_READ generano log di controllo Accesso ai dati. I metodi che richiedono un'autorizzazione IAM con il valore della proprietà type ADMIN_WRITE generano log di controllo Attività amministratore.

Tipo di autorizzazione	Metodi
ADMIN_READ	google.cloud.certificatemanager.v1.CertificateManager.GetCertificate google.cloud.certificatemanager.v1.CertificateManager.GetCertificateIssuanceConfig google.cloud.certificatemanager.v1.CertificateManager.GetCertificateMap google.cloud.certificatemanager.v1.CertificateManager.GetCertificateMapEntry google.cloud.certificatemanager.v1.CertificateManager.GetDnsAuthorization google.cloud.certificatemanager.v1.CertificateManager.GetTrustConfig google.cloud.certificatemanager.v1.CertificateManager.ListCertificateIssuanceConfigs google.cloud.certificatemanager.v1.CertificateManager.ListCertificateMapEntries google.cloud.certificatemanager.v1.CertificateManager.ListCertificateMaps google.cloud.certificatemanager.v1.CertificateManager.ListCertificates google.cloud.certificatemanager.v1.CertificateManager.ListDnsAuthorizations google.cloud.certificatemanager.v1.CertificateManager.ListTrustConfigs google.longrunning.Operations.GetOperation google.longrunning.Operations.ListOperations
ADMIN_WRITE	google.cloud.certificatemanager.v1.CertificateManager.CreateCertificate google.cloud.certificatemanager.v1.CertificateManager.CreateCertificateIssuanceConfig google.cloud.certificatemanager.v1.CertificateManager.CreateCertificateMap google.cloud.certificatemanager.v1.CertificateManager.CreateCertificateMapEntry google.cloud.certificatemanager.v1.CertificateManager.CreateDnsAuthorization google.cloud.certificatemanager.v1.CertificateManager.CreateTrustConfig google.cloud.certificatemanager.v1.CertificateManager.DeleteCertificate google.cloud.certificatemanager.v1.CertificateManager.DeleteCertificateIssuanceConfig google.cloud.certificatemanager.v1.CertificateManager.DeleteCertificateMap google.cloud.certificatemanager.v1.CertificateManager.DeleteCertificateMapEntry google.cloud.certificatemanager.v1.CertificateManager.DeleteDnsAuthorization google.cloud.certificatemanager.v1.CertificateManager.DeleteTrustConfig google.cloud.certificatemanager.v1.CertificateManager.UpdateCertificate google.cloud.certificatemanager.v1.CertificateManager.UpdateCertificateIssuanceConfig google.cloud.certificatemanager.v1.CertificateManager.UpdateCertificateMap google.cloud.certificatemanager.v1.CertificateManager.UpdateCertificateMapEntry google.cloud.certificatemanager.v1.CertificateManager.UpdateDnsAuthorization google.cloud.certificatemanager.v1.CertificateManager.UpdateTrustConfig google.longrunning.Operations.CancelOperation google.longrunning.Operations.DeleteOperation

Audit log dell'interfaccia API

Per informazioni su come e quali autorizzazioni vengono valutate per ciascun metodo, consulta la documentazione di Identity and Access Management per Certificate Manager.

google.cloud.certificatemanager.v1.CertificateManager

I seguenti log di controllo sono associati ai metodi appartenenti a google.cloud.certificatemanager.v1.CertificateManager.

CreateCertificate

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.CreateCertificate
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.certs.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.CreateCertificate"
  

CreateCertificateIssuanceConfig

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.CreateCertificateIssuanceConfig
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.certissuanceconfigs.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.CreateCertificateIssuanceConfig"
  

CreateCertificateMap

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.CreateCertificateMap
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.certmaps.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.CreateCertificateMap"
  

CreateCertificateMapEntry

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.CreateCertificateMapEntry
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.certmapentries.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.CreateCertificateMapEntry"
  

CreateDnsAuthorization

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.CreateDnsAuthorization
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.dnsauthorizations.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.CreateDnsAuthorization"
  

CreateTrustConfig

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.CreateTrustConfig
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.trustconfigs.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.CreateTrustConfig"
  

DeleteCertificate

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.DeleteCertificate
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.certs.delete - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.DeleteCertificate"
  

DeleteCertificateIssuanceConfig

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.DeleteCertificateIssuanceConfig
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.certissuanceconfigs.delete - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.DeleteCertificateIssuanceConfig"
  

DeleteCertificateMap

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.DeleteCertificateMap
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.certmaps.delete - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.DeleteCertificateMap"
  

DeleteCertificateMapEntry

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.DeleteCertificateMapEntry
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.certmapentries.delete - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.DeleteCertificateMapEntry"
  

DeleteDnsAuthorization

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.DeleteDnsAuthorization
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.dnsauthorizations.delete - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.DeleteDnsAuthorization"
  

DeleteTrustConfig

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.DeleteTrustConfig
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.trustconfigs.delete - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.DeleteTrustConfig"
  

GetCertificate

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.GetCertificate
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • certificatemanager.certs.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.GetCertificate"
  

GetCertificateIssuanceConfig

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.GetCertificateIssuanceConfig
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • certificatemanager.certissuanceconfigs.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.GetCertificateIssuanceConfig"
  

GetCertificateMap

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.GetCertificateMap
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • certificatemanager.certmaps.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.GetCertificateMap"
  

GetCertificateMapEntry

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.GetCertificateMapEntry
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • certificatemanager.certmapentries.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.GetCertificateMapEntry"
  

GetDnsAuthorization

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.GetDnsAuthorization
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • certificatemanager.dnsauthorizations.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.GetDnsAuthorization"
  

GetTrustConfig

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.GetTrustConfig
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • certificatemanager.trustconfigs.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.GetTrustConfig"
  

ListCertificateIssuanceConfigs

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.ListCertificateIssuanceConfigs
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • certificatemanager.certissuanceconfigs.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.ListCertificateIssuanceConfigs"
  

ListCertificateMapEntries

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.ListCertificateMapEntries
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • certificatemanager.certmapentries.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.ListCertificateMapEntries"
  

ListCertificateMaps

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.ListCertificateMaps
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • certificatemanager.certmaps.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.ListCertificateMaps"
  

ListCertificates

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.ListCertificates
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • certificatemanager.certs.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.ListCertificates"
  

ListDnsAuthorizations

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.ListDnsAuthorizations
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • certificatemanager.dnsauthorizations.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.ListDnsAuthorizations"
  

ListTrustConfigs

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.ListTrustConfigs
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • certificatemanager.trustconfigs.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.ListTrustConfigs"
  

UpdateCertificate

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.UpdateCertificate
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.certs.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.UpdateCertificate"
  

UpdateCertificateIssuanceConfig

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.UpdateCertificateIssuanceConfig
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.certissuanceconfigs.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.UpdateCertificateIssuanceConfig"
  

UpdateCertificateMap

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.UpdateCertificateMap
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.certmaps.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.UpdateCertificateMap"
  

UpdateCertificateMapEntry

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.UpdateCertificateMapEntry
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.certmapentries.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.UpdateCertificateMapEntry"
  

UpdateDnsAuthorization

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.UpdateDnsAuthorization
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.dnsauthorizations.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.UpdateDnsAuthorization"
  

UpdateTrustConfig

• Metodo: google.cloud.certificatemanager.v1.CertificateManager.UpdateTrustConfig
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.trustconfigs.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o di streaming: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.certificatemanager.v1.CertificateManager.UpdateTrustConfig"
  

google.longrunning.Operations

I seguenti log di controllo sono associati ai metodi appartenenti a google.longrunning.Operations.

CancelOperation

• Metodo: google.longrunning.Operations.CancelOperation
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.operations.cancel - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.longrunning.Operations.CancelOperation"
  

DeleteOperation

• Metodo: google.longrunning.Operations.DeleteOperation
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • certificatemanager.operations.delete - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.longrunning.Operations.DeleteOperation"
  

GetOperation

• Metodo: google.longrunning.Operations.GetOperation
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • certificatemanager.operations.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.longrunning.Operations.GetOperation"
  

ListOperations

• Metodo: google.longrunning.Operations.ListOperations
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • certificatemanager.operations.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.longrunning.Operations.ListOperations"
  

Metodi che non generano log di controllo

Un metodo potrebbe non generare audit log per uno o più dei seguenti motivi:

• Si tratta di un metodo ad alto volume che comporta costi significativi per la generazione e l'archiviazione dei log.
• Ha un valore di controllo basso.
• Un altro log di controllo o della piattaforma fornisce già la copertura del metodo.

I seguenti metodi non generano log di controllo:

• google.cloud.location.Locations.GetLocation
• google.cloud.location.Locations.ListLocations
• google.longrunning.Operations.WaitOperation

Log di controllo disponibili

Per le autorità di certificazione pubbliche sono disponibili i seguenti tipi di log di controllo:

• Audit log delle attività di amministrazione

  Sono incluse le operazioni di "scrittura amministratore" che scrivono i metadati o le informazioni di configurazione.

  Non puoi disattivare gli audit log delle attività di amministrazione.

• Audit log degli accessi ai dati

  Sono incluse le operazioni di "lettura amministratore" che leggono i metadati o le informazioni di configurazione.

  Per ricevere gli audit log di accesso ai dati, devi attivarli esplicitamente.

Per descrizioni più complete dei tipi di log di controllo, consulta Tipi di log di controllo.

Formato degli audit log

Le voci dei log di controllo includono i seguenti oggetti:

• La voce di log stessa, che è un oggetto di tipo 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.
  • protoPayload contiene le informazioni sottoposte a verifica.

• I dati di registrazione degli audit, che sono un oggetto AuditLog contenuto nel campo protoPayload della voce di log.

• Informazioni di audit facoltative e specifiche del servizio, che sono un oggetto specifico del servizio. Per le integrazioni precedenti, questo oggetto è contenuto nel campo serviceData dell'oggetto AuditLog; le integrazioni successive utilizzano il campo metadata.

Per informazioni sugli altri campi in questi oggetti e su come interpretarli, consulta Comprendere i log di controllo.

Nome log

I nomi dei log di Audit log di Cloud includono identificatori delle risorse che indicano il progetto Google Cloud o un'altra entità Google Cloud proprietaria degli audit log, oltre a specificare se il log contiene dati di audit logging per attività di amministrazione, accesso ai dati, rifiuto delle norme o eventi di sistema.

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
   projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event
   projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fpolicy

   folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Factivity
   folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Fdata_access
   folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Fsystem_event
   folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Fpolicy

   billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Factivity
   billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Fdata_access
   billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event
   billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Fpolicy

   organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Factivity
   organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Fdata_access
   organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Fsystem_event
   organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Fpolicy

Nota: la parte del nome del log che segue /logs/ deve essere codificata come URL. Il carattere della barra (/) deve essere scritto come %2F.

Abilitazione degli audit log

Gli audit log per le attività di amministrazione sono sempre abilitati; non puoi disabilitarli.

Gli audit log di accesso ai dati sono disabilitati per impostazione predefinita e non vengono scritti a meno che non vengano abilitati esplicitamente (fa eccezione gli audit log di accesso ai dati per BigQuery, che non possono essere disattivati).

Per informazioni su come attivare alcuni o tutti gli audit log di accesso ai dati, consulta Attivare gli audit log di accesso ai dati.

Visualizza audit log

Puoi eseguire query su tutti i log di controllo o su log specifici in base al nome del log di controllo. Il nome dell'audit log include l'identificatore della risorsa del progetto, della cartella, dell'account di fatturazione o dell'organizzazione Google Cloud per cui vuoi visualizzare le informazioni di log di controllo. Le query possono specificare campi LogEntry indicizzati e, se utilizzi la pagina Analisi dei log, che supporta le query SQL, puoi visualizzare i risultati della query sotto forma di grafico.

Per ulteriori informazioni su come eseguire query sui log, consulta le seguenti pagine:

• Crea query in Esplora log.
• Esegui query e visualizza i log in Analisi dei log.
• Query di esempio per gli approfondimenti sulla sicurezza.

Puoi visualizzare gli audit log in Cloud Logging utilizzando la console Google Cloud, Google Cloud CLI o l'API Logging.

Console

Nella console Google Cloud, puoi utilizzare Esplora log per recuperare le voci degli audit log per il progetto, la cartella o l'organizzazione Google Cloud:

Nota: non puoi visualizzare i log di controllo per gli account di fatturazione Cloud nella console Google Cloud. Devi utilizzare l'API o gcloud CLI.

1. Nella console Google Cloud, vai alla pagina Esplora log:

   Vai a Esplora log

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

2. Seleziona un progetto, una cartella o un'organizzazione Google Cloud esistente.

3. Per visualizzare tutti i log di controllo, inserisci una delle seguenti query nel campo dell'editor di query e poi fai clic su Esegui query:

   logName:"cloudaudit.googleapis.com"
   

   protoPayload."@type"="type.googleapis.com/google.cloud.audit.AuditLog"
   

4. Per visualizzare gli audit log per una risorsa e un tipo di audit log specifici, nel riquadro Query Builder:

   • In Tipo di risorsa, seleziona la Google Cloud risorsa di cui vuoi visualizzare gli audit log.

   • In Nome log, seleziona il tipo di log di controllo 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 di accesso negato in base ai criteri, seleziona policy.

   • Fai clic su Esegui query.

   Se non visualizzi queste opzioni, vuol dire 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 sulla risoluzione dei problemi.

   Per ulteriori informazioni su come eseguire query utilizzando Esplora log, consulta Creare query in Esplora log.

gcloud

Google Cloud CLI fornisce un'interfaccia a riga di comando per l'API Logging. Fornisci un identificatore della risorsa valido in ciascuno dei nomi del log. Ad esempio, se la query include un PROJECT_ID, l'identificatore del progetto fornito deve fare riferimento al progetto Google Cloud attualmente selezionato.

Per leggere le voci dei 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 dei log di controllo a livello di cartella, esegui il seguente comando:

gcloud logging read "logName : folders/FOLDER_ID/logs/cloudaudit.googleapis.com" \
    --folder=FOLDER_ID

Per leggere le voci degli audit log a livello di organizzazione, esegui il seguente 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 il seguente 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 risalenti a più di un giorno prima.

Per ulteriori informazioni sull'utilizzo dell'interfaccia a riga di comando gcloud, consulta gcloud logging read.

API

Quando crei le query, fornisci un identificatore di risorse valido in ciascuno delle denominazioni dei log. Ad esempio, se la query include un PROJECT_ID, l'identificatore del progetto fornito deve fare riferimento al progetto Google Cloud selezionato al momento.

Ad esempio, per utilizzare l'API Logging per visualizzare le voci di audit log a livello di progetto:

1. Vai alla sezione Prova questa API nella documentazione del metodo entries.list.

2. 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 valore PROJECT_ID valido in ciascuno dei nomi dei log.

   {
     "resourceNames": [
       "projects/PROJECT_ID"
     ],
     "pageSize": 5,
     "filter": "logName : projects/PROJECT_ID/logs/cloudaudit.googleapis.com"
   }
   

3. Fai clic su Esegui.