Gestisci gli audit log

Supportata in:

I serviziGoogle Cloud scrivono gli audit log per aiutarti a capire chi ha fatto cosa, dove e quando all'interno delle tue risorse Google Cloud . Questa pagina descrive gli audit log creati da Google Security Operations e scritti come Cloud Audit Logs.

Per una panoramica generale di Cloud Audit Logs, consulta Panoramica di Cloud Audit Logs. Per informazioni più approfondite sul formato degli audit log, consulta Informazioni sugli audit log.

Audit log disponibili

Il nome del servizio di audit log e le operazioni controllate variano a seconda del programma di anteprima a cui hai eseguito la registrazione. Gli audit log di Google SecOps utilizzano uno dei seguenti nomi di servizio:

  • chronicle.googleapis.com
  • chronicleservicemanager.googleapis.com
  • malachitefrontend-pa.googleapis.com

Le operazioni di controllo utilizzano il tipo di risorsa audited_resource per tutti gli audit log scritti, indipendentemente dal programma di anteprima. Non c'è alcuna differenza in base al Programma Anteprima a cui hai effettuato la registrazione.

Log con nome servizio chronicle.googleapis.com

I seguenti tipi di log sono disponibili per gli audit log di Google SecOps con il nome servizio chronicle.googleapis.com.

Per saperne di più, consulta Autorizzazioni di Google SecOps in IAM.

Tipo di audit log Descrizione
Audit log delle attività di amministrazione Include le operazioni admin write che scrivono i metadati o le informazioni di configurazione. Le azioni in Google SecOps che generano questo tipo di log includono l'aggiornamento dei feed e la creazione di regole.

chronicle.googleapis.com/feeds.update
chronicle.googleapis.com/rules.create
chronicle.googleapis.com/parsers.activate
Audit log degli accessi ai dati Include le operazioni admin read che leggono i metadati o le informazioni di configurazione. Include anche le operazioni data read e data write che leggono o scrivono i dati forniti dagli utenti. Le azioni in Google SecOps che generano questo tipo di log includono il recupero dei feed e l'elenco delle regole. Attiva l'impostazione data read per il tuo progetto Google Cloud per registrare le query di ricerca SIEM eseguite dagli utenti.

chronicle.googleapis.com/feeds.get
chronicle.googleapis.com/rules.list
chronicle.googleapis.com/curatedRuleSets.countCuratedRuleSetDetections

Log con nome servizio chronicleservicemanager.googleapis.com

Gli audit log di Google SecOps scritti utilizzando il nome servizio chronicleservicemanager.googleapis.com sono disponibili solo a livello di organizzazione, non di progetto.

I seguenti tipi di log sono disponibili per gli audit log di Google SecOps scritti utilizzando il nome servizio chronicleservicemanager.googleapis.com.

Tipo di audit log Descrizione
Audit log delle attività di amministrazione Include le operazioni di scrittura amministratore che scrivono i metadati o le informazioni di configurazione. Le azioni in Google SecOps che generano questo tipo di log includono la creazione di un'associazione Google Cloud e l'aggiornamento dei filtri dei log Google Cloud .

chronicleservicemanager.googleapis.com/gcpAssociations.create
chronicleservicemanager.googleapis.com/gcpAssociations.delete
chronicleservicemanager.googleapis.com/gcpSettings.delete
Audit log degli accessi ai dati Include le operazioni di lettura amministratore che leggono i metadati o le informazioni di configurazione. Include anche le operazioni di lettura dati e scrittura dati che leggono o scrivono i dati forniti dall'utente. Le azioni in Google SecOps che generano questo tipo di log includono l'elenco delle istanze e dei metadati dei clienti.

chronicleservicemanager.googleapis.com/gcpAssociations.get
chronicleservicemanager.googleapis.com/gcpSettings.get

Log con nome servizio malachitefrontend-pa.googleapis.com

I seguenti tipi di log sono disponibili per gli audit log di Google SecOps con il nome servizio malachitefrontend-pa.googleapis.com.

Le operazioni dell'API Chronicle Frontend forniscono dati da e verso la UI di Google SecOps. L'API Chronicle Frontend è composta principalmente da operazioni di accesso ai dati.

Tipo di audit log Operazioni di Google SecOps
Audit log delle attività di amministrazione Include l'attività relativa agli aggiornamenti, ad esempio UpdateRole e UpdateSubject.
Audit log degli accessi ai dati Include l'attività relativa alle visualizzazioni, ad esempio ListRoles e ListSubjects.

Formato degli audit log

Le voci di log di controllo includono i seguenti oggetti:

  • La voce di log stessa, che è un oggetto di tipo LogEntry. Di seguito sono elencati alcuni campi utili:

    • logName contiene l'ID risorsa e il tipo di audit log.
    • resource contiene il target dell'operazione sottoposta ad audit.
    • timeStamp contiene l'ora dell'operazione sottoposta ad audit.
    • protoPayload contiene le informazioni sottoposte ad audit.
  • I dati di audit logging, 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 più recenti utilizzano il campo metadata.

  • Il campo protoPayload.authenticationInfo.principalSubject contiene l'entità utente. Indica chi ha eseguito l'azione.

  • Il campo protoPayload.methodName contiene il nome del metodo API richiamato dalla UI per conto dell'utente.

  • Il campo protoPayload.status contiene lo stato della chiamata API. Un valore status vuoto indica che l'operazione è riuscita. Un valore status non vuoto indica un errore e contiene una descrizione dell'errore. Il codice di stato 7 indica autorizzazione negata.

  • Il servizio chronicle.googleapis.com include il campo protoPayload.authorizationInfo. Contiene il nome della risorsa richiesta, il nome dell'autorizzazione controllata e se l'accesso è stato concesso o negato.

Per informazioni sugli altri campi in questi oggetti e su come interpretarli, consulta Informazioni sugli audit log.

L'esempio seguente mostra i nomi dei log per gli audit log Attività di amministrazione e controllo dell'accesso ai dati a livello di progetto. Le variabili indicano gli identificatori del progetto Google Cloud .

projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity
projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access

Attivazione degli audit log

Per abilitare l'audit logging per il servizio chronicle.googleapis.com, consulta Abilita i log di controllo dell'accesso ai dati. Per abilitare l'audit logging per altri servizi, contatta l'assistenza Google SecOps.

Archiviazione degli audit log

  • Audit log di Google SecOps: archiviati in un progetto Google Cloud di tua proprietà dopo l'abilitazione dell'API Google SecOps.
  • Audit log legacy (incluso malachitefrontend-pa.googleapis.com): archiviati in un progettoGoogle Cloud .
  • Audit log delle attività di amministrazione: sempre attivati e non possono essere disattivati. Per visualizzarli, esegui prima la migrazione dell'istanza Google SecOps a IAM per controllo dell'accesso.
  • Log di controllo dell'accesso ai dati: abilitati per impostazione predefinita. Per disabilitarla nel progetto di proprietà del cliente, contatta il tuo rappresentante Google SecOps. Google SecOps scrive gli audit log di accesso ai dati e di attività di amministrazione nel progetto.

Configura i log di controllo dell'accesso ai dati in modo che includano i dati di ricerca

Per compilare le query di ricerca UDM e di ricerca nei log non elaborati negli audit log di Google SecOps, aggiorna la configurazione dei log di controllo dell'accesso ai dati con le autorizzazioni necessarie.

  1. Nel pannello di navigazione della console Google Cloud , seleziona IAM e amministrazione > Audit log.
  2. Seleziona un progetto, una cartella o un'organizzazione Google Cloud esistente.
  3. In Configurazione dei log di controllo dell'accesso ai dati, seleziona API Chronicle.
  4. Nella scheda Tipi di autorizzazione, seleziona tutte le autorizzazioni elencate (Lettura amministratore, Lettura dati, Scrittura dati).
  5. Fai clic su Salva.
  6. Ripeti i passaggi da 3 a 5 per l'API Chronicle Service Manager.

Visualizza i log

Per trovare e visualizzare gli audit log, utilizza l'ID progetto Google Cloud . Per l'audit logging legacy di malachitefrontend-pa.googleapis.com configurato utilizzando un progetto di proprietà diGoogle Cloud, l'assistenza Google SecOps ti ha fornito queste informazioni. Puoi specificare ulteriormente altri campi LogEntry indicizzati, come resource.type. Per saperne di più, consulta Trova rapidamente le voci di log.

Nella console Google Cloud , utilizza Esplora log per recuperare le voci di log di controllo per il progetto Google Cloud :

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

    Vai a Esplora log

  2. Nella pagina Esplora log, seleziona un progetto, una cartella o un'organizzazioneGoogle Cloud esistente.

  3. Nel riquadro Query Builder, segui questi passaggi:

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

    • In Nome log seleziona il tipo di audit log che vuoi visualizzare:

    • Per gli audit log Attività di amministrazione, seleziona activity.

    • Per gli audit log Accesso ai dati, seleziona data_access.

    Se non vedi queste opzioni, significa che non sono disponibili audit log di questo tipo nel progetto, nella cartella o nell'organizzazione Google Cloud .

    Per saperne di più sull'esecuzione di query utilizzando Esplora log, consulta Crea query di log.

Per un esempio di voce di log dell'audit e per scoprire come trovare le informazioni più importanti al suo interno, consulta Esempio di voce di log dell'audit.

Esempi: log del nome del servizio chronicle.googleapis.com

Le sezioni seguenti descrivono i casi d'uso comuni di Cloud Audit Logs che utilizzano il nome servizio chronicle.googleapis.com.

Elenco delle azioni eseguite da un utente specifico

Per trovare le azioni eseguite da un determinato utente, esegui questa query in Esplora log:

resource.type="audited_resource"
resource.labels.service="chronicle.googleapis.com"
protoPayload.authenticationInfo.principalSubject=USER

Identificare gli utenti che hanno eseguito un'azione specifica

Per trovare gli utenti che hanno aggiornato una regola di rilevamento, esegui questa query in Esplora log:

resource.type="audited_resource"
resource.labels.service="chronicle.googleapis.com"
protoPayload.methodName="google.cloud.chronicle.v1main.RuleService.UpdateRule"

Esempio: log del nome del servizio cloudresourcemanager.googleapis.com

Per trovare gli utenti che hanno aggiornato un ruolo o un soggetto di controllo dell'accesso#39;accesso, esegui la seguente query in Esplora log:

resource.type="project"
resource.labels.service="cloudresourcemanager.googleapis.com"
protoPayload.methodName="SetIamPolicy"

Esempi: log del nome del servizio malachitefrontend-pa.googleapis.com

Le sezioni seguenti descrivono i casi d'uso comuni di Cloud Audit Logs che utilizzano il nome servizio malachitefrontend-pa.googleapis.com.

Elenco delle azioni eseguite da un utente specifico

Per trovare le azioni eseguite da un determinato utente, esegui questa query in Esplora log:

resource.type="audited_resource"
resource.labels.service="malachitefrontend-pa.googleapis.com"
protoPayload.authenticationInfo.principalSubject=USER

Identificare gli utenti che hanno eseguito un'azione specifica

Per trovare gli utenti che hanno aggiornato un soggetto controllo dell'accesso, esegui la seguente query in Esplora log:

resource.type="audited_resource"
resource.labels.service="malachitefrontend-pa.googleapis.com"
protoPayload.methodName="malachite.frontend.v1.MalachiteFrontendService.UpdateSubject"

Per trovare gli utenti che hanno aggiornato un ruolo di controllo dell'accesso, esegui questa query in Esplora log:

resource.type="audited_resource"
resource.labels.service="malachitefrontend-pa.googleapis.com"
protoPayload.methodName="malachite.frontend.v1.MalachiteFrontendService.UpdateRole"

Per trovare gli utenti che hanno aggiornato una regola di rilevamento, esegui questa query in Esplora log:

resource.type="audited_resource"
resource.labels.service="malachitefrontend-pa.googleapis.com"
protoPayload.methodName="malachite.frontend.v1.MalachiteFrontendService.UpdateRule"

Passaggi successivi

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.