Audit-Logging für API-Schlüssel

In diesem Dokument wird das Audit-Logging für API-Schlüssel beschrieben.Dienste von Google Cloud generieren Audit-Logs, in denen Administrator- und Zugriffsaktivitäten innerhalb Ihrer Ressourcen für Google Cloud aufgezeichnet werden. Weitere Informationen zu Cloud-Audit-Logs finden Sie unter den folgenden Links:

• 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

Für Audit-Logs von API-Schlüsseln wird der Dienstname apikeys.googleapis.com verwendet. Filter für diesen Dienst:

    protoPayload.serviceName="apikeys.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 API Keys 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-Log-Einträ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
ADMIN_READ	google.api.apikeys.v2.ApiKeys.GetKeyString
ADMIN_WRITE	google.api.apikeys.v2.ApiKeys.CreateKey (LRO) google.api.apikeys.v2.ApiKeys.DeleteKey (LRO) google.api.apikeys.v2.ApiKeys.UndeleteKey (LRO) google.api.apikeys.v2.ApiKeys.UpdateKey (LRO) google.longrunning.Operations.GetOperation

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 API-Schlüssel.

google.api.apikeys.v2.ApiKeys

Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.api.apikeys.v2.ApiKeys gehören.

CreateKey

• Methode: google.api.apikeys.v2.ApiKeys.CreateKey
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • serviceusage.apiKeys.create - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Vorgang mit langer Ausführungszeit
  
• Filter für diese Methode: protoPayload.methodName="google.api.apikeys.v2.ApiKeys.CreateKey"
  

DeleteKey

• Methode: google.api.apikeys.v2.ApiKeys.DeleteKey
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • serviceusage.apiKeys.delete - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Vorgang mit langer Ausführungszeit
  
• Filter für diese Methode: protoPayload.methodName="google.api.apikeys.v2.ApiKeys.DeleteKey"
  

GetKeyString

• Methode: google.api.apikeys.v2.ApiKeys.GetKeyString
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • apikeys.keys.getKeyString - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.api.apikeys.v2.ApiKeys.GetKeyString"
  

UndeleteKey

• Methode: google.api.apikeys.v2.ApiKeys.UndeleteKey
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • apikeys.keys.undelete - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Vorgang mit langer Ausführungszeit
  
• Filter für diese Methode: protoPayload.methodName="google.api.apikeys.v2.ApiKeys.UndeleteKey"
  

UpdateKey

• Methode: google.api.apikeys.v2.ApiKeys.UpdateKey
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • serviceusage.apiKeys.update - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Vorgang mit langer Ausführungszeit
  
• Filter für diese Methode: protoPayload.methodName="google.api.apikeys.v2.ApiKeys.UpdateKey"
  

google.longrunning.Operations

Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.longrunning.Operations gehören.

GetOperation

• Methode: google.longrunning.Operations.GetOperation
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • apikeys.keys.create - ADMIN_WRITE
  • apikeys.keys.delete - ADMIN_WRITE
  • serviceusage.operations.get - DATA_READ
  • serviceusage.services.get - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.longrunning.Operations.GetOperation"