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

In diesem Dokument wird das Audit-Logging für Apigee API Management beschrieben. 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:

Dienstname

Für Apigee API Management-Audit-Logs wird der Dienstname apim.googleapis.com verwendet. Filter für diesen Dienst: 

    protoPayload.serviceName="apim.googleapis.com"

Methoden nach Berechtigungstyp

Jede IAM-Berechtigung hat ein type-Attribut, dessen Wert „enum“ ist. Er kann einen der folgenden vier Werte haben: ADMIN_READ, ADMIN_WRITE, DATA_READ oder DATA_WRITE. Wenn Sie eine Methode aufrufen, generiert Apigee API Management 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 Start und einen beim Ende 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.GetObservationSource
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 Identity and Access Management für 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"

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"

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

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.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