Audit-Logging für wichtige Kontakte

Mit Cloud-Audit-Logs für wichtige Kontakte können Sie Verwaltungs- und Datenzugriffsvorgänge für Ihre Ressourcen verfolgen, um Zugriffs- und Konfigurationsänderungen zu überwachen. Sie können diese Logs im Log-Explorer abfragen und prüfen, welche Essential Contacts API-Methoden Cloud-Audit-Logs generieren.

Weitere Informationen zu Cloud-Audit-Logs finden Sie in den folgenden Dokumenten:

• Typen von Audit-Logs
• Struktur von Audit-Logeinträgen
• Audit-Logs speichern und weiterleiten
• Preisübersicht für Cloud Logging
• Audit-Logs zum Datenzugriff aktivieren

Dienstname

So rufen Sie die Audit-Logs für wichtige Kontakte auf:

1. Rufen Sie in der Google Cloud Console die Seite „Log-Explorer“ auf:

   Zum Log-Explorer

2. Kopieren Sie die folgende Abfrage und fügen Sie sie in das Feld Abfrage des Log-Explorers ein. Klicken Sie dann auf Abfrage ausführen.

       protoPayload.serviceName="essentialcontacts.googleapis.com"
     

Methoden nach Berechtigungstyp

Jede IAM-Berechtigung hat ein type-Attribut, das ein „enum“ ist und einen der folgenden vier Werte haben kann: ADMIN_READ, ADMIN_WRITE, DATA_READ oder DATA_WRITE. Wenn Sie eine Methode aufrufen, generiert „Wichtige Kontakte“ ein Audit-Log, dessen Kategorie vom Attribut type der Berechtigung abhängt, die für die Ausführung der Methode erforderlich ist. Methoden, die eine IAM-Berechtigung mit dem type-Attributwert DATA_READ, DATA_WRITE oder ADMIN_READ erfordern, generieren Audit-Logs zum Datenzugriff. Methoden, die eine IAM-Berechtigung mit dem type-Attributwert ADMIN_WRITE erfordern, generieren Audit-Logs zur Administratoraktivität.

API-Methoden in der folgenden Liste, die mit (LRO) gekennzeichnet sind, sind Vorgänge mit langer Ausführungszeit. Diese Methoden generieren in der Regel zwei Audit-Logeinträge: einen beim Starten und einen beim Beenden des Vorgangs. Weitere Informationen finden Sie unter Audit-Logs für Vorgänge mit langer Ausführungszeit.

Berechtigungstyp	Methoden
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-Logs der API-Schnittstelle

Informationen dazu, wie und welche Berechtigungen für die einzelnen Methoden evaluiert werden, finden Sie in der Dokumentation zu Identity and Access Management für wichtige Kontakte.

google.cloud.essentialcontacts.v1.EssentialContactsService

Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.cloud.essentialcontacts.v1.EssentialContactsService gehören.

ComputeContacts

• Methode: google.cloud.essentialcontacts.v1.EssentialContactsService.ComputeContacts
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.get - DATA_READ
  • essentialcontacts.contacts.list - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.ComputeContacts"
  

CreateContact

• Methode: google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.create - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.CreateContact"
  

DeleteContact

• Methode: google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.delete - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.DeleteContact"
  

GetContact

• Methode: google.cloud.essentialcontacts.v1.EssentialContactsService.GetContact
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.get - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.GetContact"
  

ListContacts

• Methode: google.cloud.essentialcontacts.v1.EssentialContactsService.ListContacts
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.list - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.ListContacts"
  

SendTestMessage

• Methode: google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.send - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.SendTestMessage"
  

UpdateContact

• Methode: google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.update - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1.EssentialContactsService.UpdateContact"
  

google.cloud.essentialcontacts.v1alpha1.EssentialContactsService

Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.cloud.essentialcontacts.v1alpha1.EssentialContactsService gehören.

ComputeContacts

• Methode: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.list - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ComputeContacts"
  

CreateContact

• Methode: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.create - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.CreateContact"
  

DeleteContact

• Methode: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.delete - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.DeleteContact"
  

GetContact

• Methode: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.get - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.GetContact"
  

ListContacts

• Methode: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.list - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.ListContacts"
  

SendTestMessage

• Methode: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.send - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.SendTestMessage"
  

UpdateContact

• Methode: google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.update - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1alpha1.EssentialContactsService.UpdateContact"
  

google.cloud.essentialcontacts.v1beta1.EssentialContactsService

Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.cloud.essentialcontacts.v1beta1.EssentialContactsService gehören.

ComputeContacts

• Methode: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.get - DATA_READ
  • essentialcontacts.contacts.list - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ComputeContacts"
  

CreateContact

• Methode: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.create - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.CreateContact"
  

DeleteContact

• Methode: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.delete - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.DeleteContact"
  

GetContact

• Methode: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.get - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.GetContact"
  

ListContacts

• Methode: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.list - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.ListContacts"
  

SendTestMessage

• Methode: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.send - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.SendTestMessage"
  

UpdateContact

• Methode: google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • essentialcontacts.contacts.update - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.essentialcontacts.v1beta1.EssentialContactsService.UpdateContact"
  

Methoden, die keine Audit-Logs generieren

Folgende Gründe können dazu führen, dass eine Methode möglicherweise keine Audit-Logs generiert:

• Es ist eine Methode mit hohem Volumen, die erhebliche Kosten für die Generierung und Speicherung von Logs erzeugt.
• Die Methode hat einen geringen Audit-Wert.
• Die Methode wird bereits von einem anderen Audit- oder Plattformlog abgedeckt.

Die folgenden Methoden generieren keine Audit-Logs:

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

Audit-Logs zur Administratoraktivität für Schreibvorgänge

Zusätzlich zu Audit-Logs zum Datenzugriff (DATA_WRITE) generieren die folgenden google.cloud.essentialcontacts.v1.EssentialContactsService-Schreibmethoden Audit-Logs für Administratoraktivitäten (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

Audit-Logs zu Administratoraktivitäten sind standardmäßig aktiviert. Für die Aufnahme in Cloud Logging fallen keine Gebühren an.

Wenn Sie auch Audit-Logs zum Datenzugriff (DATA_WRITE) für Essential Contacts aktivieren, wird beim Aufrufen dieser vier Methoden sowohl ein Audit-Logeintrag für Administratoraktivitäten (cloudaudit.googleapis.com/activity) als auch ein Audit-Logeintrag für den Datenzugriff (cloudaudit.googleapis.com/data_access) generiert. Wenn Sie Audit-Logs an Export-Senken weiterleiten oder logbasierte Benachrichtigungen konfigurieren, filtern Sie nach Logname oder Konto für beide Logeinträge, um doppelte Benachrichtigungen oder unerwartetes Exportvolumen zu vermeiden.

Beispielabfragen

Sie können die folgende Beispielabfrage im Log-Explorer ausführen, um Audit-Logs für Administratoraktivitäten für Schreibvorgänge in Essential Contacts aufzurufen:

Beschreibung der Abfrage	Ausdruck
Audit-Logs zur Administratoraktivität für Schreibvorgänge in „Wichtige Kontakte“	log_id("cloudaudit.googleapis.com/activity") protoPayload.serviceName="essentialcontacts.googleapis.com"