Log di controllo di Essential Contacts

Cloud Audit Logs per Contatti fondamentali ti consente di monitorare le operazioni amministrative e di accesso ai dati sulle tue risorse per aiutarti a monitorare l'accesso e le modifiche alla configurazione. Puoi eseguire query su questi log in Esplora log e controllare quali metodi dell'API Essential Contacts generano Cloud Audit Logs.

Per saperne di più su Cloud Audit Logs, consulta i seguenti documenti:

Nome servizio

Per visualizzare gli audit log di Contatti fondamentali:

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

    Vai a Esplora log

  2. Copia e incolla la seguente query nel campo Query di Esplora log, quindi fai clic su Esegui query.

        protoPayload.serviceName="essentialcontacts.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, Contatti essenziali genera un audit log 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 audit log degli accessi ai dati. I metodi che richiedono un'autorizzazione IAM con il valore della proprietà type corrispondente a ADMIN_WRITE generano audit log delle attività di amministrazione.

I metodi API nel seguente elenco contrassegnati con (LRO) sono operazioni a lunga esecuzione (LRO). Questi metodi di solito generano due voci di log di controllo: una all'inizio dell'operazione e un'altra al termine. Per saperne di più, consulta Audit log per le operazioni a lunga esecuzione.
Tipo di autorizzazione Metodi
DATA_READ google.cloud.essentialcontacts.v1.EssentialContactsService.ComputeContacts
google.cloud.essentialcontacts.v1.EssentialContactsService.GetContact
google.cloud.essentialcontacts.v1.EssentialContactsService.ListContacts
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts
DATA_WRITE google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact
google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact
google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage
google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage
google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage
google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact

Audit log dell'interfaccia API

Per informazioni su come e quali autorizzazioni vengono valutate per ogni metodo, consulta la documentazione di Identity and Access Management per Contatti fondamentali.

google.cloud.essentialcontacts.v1.EssentialContactsService

I seguenti audit log sono associati ai metodi appartenenti a google.cloud.essentialcontacts.v1.EssentialContactsService.

ComputeContacts

  • Metodo: google.cloud.essentialcontacts.v1.EssentialContactsService.ComputeContacts
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.get - DATA_READ
    • essentialcontacts.contacts.list - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.ComputeContacts"

CreateContact

  • Metodo: google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.create - DATA_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact"

DeleteContact

  • Metodo: google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.delete - DATA_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact"

GetContact

  • Metodo: google.cloud.essentialcontacts.v1.EssentialContactsService.GetContact
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.get - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.GetContact"

ListContacts

  • Metodo: google.cloud.essentialcontacts.v1.EssentialContactsService.ListContacts
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.list - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.ListContacts"

SendTestMessage

  • Metodo: google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.send - DATA_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage"

UpdateContact

  • Metodo: google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.update - DATA_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact"

google.cloud.essentialcontacts.v1alpha1.EssentialContactsService

I seguenti audit log sono associati ai metodi appartenenti a google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.

ComputeContacts

  • Metodo: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.list - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts"

CreateContact

  • Metodo: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.create - DATA_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact"

DeleteContact

  • Metodo: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.delete - DATA_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact"

GetContact

  • Metodo: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.get - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact"

ListContacts

  • Metodo: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.list - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts"

SendTestMessage

  • Metodo: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.send - DATA_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage"

UpdateContact

  • Metodo: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.update - DATA_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact"

google.cloud.essentialcontacts.v1beta1.EssentialContactsService

I seguenti audit log sono associati ai metodi appartenenti a google.cloud.essentialcontacts.v1beta1.EssentialContactsService.

ComputeContacts

  • Metodo: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.get - DATA_READ
    • essentialcontacts.contacts.list - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts"

CreateContact

  • Metodo: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.create - DATA_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact"

DeleteContact

  • Metodo: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.delete - DATA_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact"

GetContact

  • Metodo: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.get - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact"

ListContacts

  • Metodo: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.list - DATA_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts"

SendTestMessage

  • Metodo: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.send - DATA_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage"

UpdateContact

  • Metodo: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • essentialcontacts.contacts.update - DATA_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact"

Metodi che non generano audit log

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 auditing basso.
  • Un altro audit log o log della piattaforma fornisce già la copertura del metodo.

I seguenti metodi non generano audit log:

  • google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ResendVerification
  • google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.VerifyContact

Audit log delle attività di amministrazione per le operazioni di scrittura

Oltre agli audit log di accesso ai dati (DATA_WRITE), i seguenti metodi di scrittura google.cloud.essentialcontacts.v1.EssentialContactsService generano audit log delle attività di amministrazione (ADMIN_WRITE):

  • google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact
  • google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact
  • google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact
  • google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage

Gli audit log delle attività di amministrazione sono abilitati per impostazione predefinita e non comportano costi di importazione di Cloud Logging.

Se abiliti anche i log di controllo dell'accesso ai dati (DATA_WRITE) per Essential Contacts, la chiamata di questi quattro metodi genera sia una voce di audit log di Attività di amministrazione (cloudaudit.googleapis.com/activity) sia una voce di log di controllo dell'accesso ai dati (cloudaudit.googleapis.com/data_access). Se esegui il routing degli audit log ai sink di esportazione o configuri avvisi basati su log, filtra per nome log o tieni conto di entrambe le voci di log per evitare avvisi duplicati o un volume dell'esportazione imprevisto.

Query di esempio

Puoi eseguire la seguente query di esempio in Esplora log per visualizzare gli audit log delle attività di amministrazione per le operazioni di scrittura di Contatti necessari:

Descrizione query Espressione
Audit log delle attività di amministrazione per le operazioni di scrittura di Contatti fondamentali 
log_id("cloudaudit.googleapis.com/activity")
protoPayload.serviceName="essentialcontacts.googleapis.com"