Audit-Logging für die API-Verwaltung mit Apigee

In diesem Dokument werden die geprüften Methoden für Apigee API Management aufgeführt. Google Cloud Dienste generieren Audit-Logs, in denen Verwaltungs- und Zugriffsaktivitäten in Ihren Google Cloud Ressourcen 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

So rufen Sie die Audit-Logs von Apigee API Management 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="apim.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 Apigee API Management ein Audit-Log, dessen Kategorie vom type-Attribut der Berechtigung abhängt, die für die Ausführung der Methode erforderlich ist. Methoden, die eine IAM-Berechtigung mit dem type-Attributwert von 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.cloud.apim.v1alpha.ApiDiscoveryObservation.GetEntitlement google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetObservationJob google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetObservationSource google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListApiObservationTags google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListObservationJobs google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListObservationSources
ADMIN_WRITE	google.cloud.apim.v1alpha.ApiDiscoveryObservation.BatchEditTagsApiObservations google.cloud.apim.v1alpha.ApiDiscoveryObservation.CreateObservationJob (LRO) google.cloud.apim.v1alpha.ApiDiscoveryObservation.CreateObservationSource (LRO) google.cloud.apim.v1alpha.ApiDiscoveryObservation.DeleteObservationJob (LRO) google.cloud.apim.v1alpha.ApiDiscoveryObservation.DeleteObservationSource (LRO) google.cloud.apim.v1alpha.ApiDiscoveryObservation.DisableObservationJob (LRO) google.cloud.apim.v1alpha.ApiDiscoveryObservation.EnableObservationJob (LRO)

Audit-Logs der API-Schnittstelle

Informationen dazu, wie und welche Berechtigungen für die einzelnen Methoden evaluiert werden, finden Sie in der Dokumentation zu Apigee API Management.

google.cloud.apim.v1alpha.ApiDiscoveryObservation

Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.cloud.apim.v1alpha.ApiDiscoveryObservation gehören.

BatchEditTagsApiObservations

• Methode: google.cloud.apim.v1alpha.ApiDiscoveryObservation.BatchEditTagsApiObservations
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • apim.apiObservations.batchEditTags - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.BatchEditTagsApiObservations"
  

CreateObservationJob

• Methode: google.cloud.apim.v1alpha.ApiDiscoveryObservation.CreateObservationJob
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • apim.observationJobs.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.cloud.apim.v1alpha.ApiDiscoveryObservation.CreateObservationJob"
  

CreateObservationSource

• Methode: google.cloud.apim.v1alpha.ApiDiscoveryObservation.CreateObservationSource
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • apim.observationSources.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.cloud.apim.v1alpha.ApiDiscoveryObservation.CreateObservationSource"
  

DeleteObservationJob

• Methode: google.cloud.apim.v1alpha.ApiDiscoveryObservation.DeleteObservationJob
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • apim.observationJobs.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.cloud.apim.v1alpha.ApiDiscoveryObservation.DeleteObservationJob"
  

DeleteObservationSource

• Methode: google.cloud.apim.v1alpha.ApiDiscoveryObservation.DeleteObservationSource
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • apim.observationSources.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.cloud.apim.v1alpha.ApiDiscoveryObservation.DeleteObservationSource"
  

DisableObservationJob

• Methode: google.cloud.apim.v1alpha.ApiDiscoveryObservation.DisableObservationJob
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • apim.observationJobs.disable - 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.cloud.apim.v1alpha.ApiDiscoveryObservation.DisableObservationJob"
  

EnableObservationJob

• Methode: google.cloud.apim.v1alpha.ApiDiscoveryObservation.EnableObservationJob
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • apim.observationJobs.enable - 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.cloud.apim.v1alpha.ApiDiscoveryObservation.EnableObservationJob"
  

GetEntitlement

• Methode: google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetEntitlement
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • apim.entitlements.get - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetEntitlement"
  

GetObservationJob

• Methode: google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetObservationJob
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • apim.observationJobs.get - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetObservationJob"
  

GetObservationSource

• Methode: google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetObservationSource
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • apim.observationSources.get - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetObservationSource"
  

ListApiObservationTags

• Methode: google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListApiObservationTags
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • apim.locations.listApiObservationTags - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListApiObservationTags"
  

ListObservationJobs

• Methode: google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListObservationJobs
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • apim.observationJobs.list - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListObservationJobs"
  

ListObservationSources

• Methode: google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListObservationSources
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • apim.observationSources.list - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListObservationSources"
  

Methoden, die keine Audit-Logs generieren

Eine Methode kann aus folgenden Gründen keine Audit-Logs erstellen:

• 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.location.Locations.GetLocation
• google.cloud.location.Locations.ListLocations
• google.longrunning.Operations.CancelOperation
• google.longrunning.Operations.DeleteOperation
• google.longrunning.Operations.GetOperation
• google.longrunning.Operations.ListOperations
• google.longrunning.Operations.WaitOperation