Audit-Logging für API Gateway
In diesem Dokument wird das Audit-Logging für API Gateway 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:
- 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 Gateway wird der Dienstname apigateway.googleapis.com verwendet.
Filter für diesen Dienst:
protoPayload.serviceName="apigateway.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 API Gateway 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.
| Berechtigungstyp | Methoden |
|---|---|
ADMIN_READ |
google.cloud.apigateway.v1.ApiGatewayService.GetApigoogle.cloud.apigateway.v1.ApiGatewayService.GetApiConfiggoogle.cloud.apigateway.v1.ApiGatewayService.GetGatewaygoogle.cloud.apigateway.v1.ApiGatewayService.ListApiConfigsgoogle.cloud.apigateway.v1.ApiGatewayService.ListApisgoogle.cloud.apigateway.v1.ApiGatewayService.ListGatewaysgoogle.cloud.apigateway.v1beta.ApiGatewayService.GetApigoogle.cloud.apigateway.v1beta.ApiGatewayService.GetApiConfiggoogle.cloud.apigateway.v1beta.ApiGatewayService.GetGatewaygoogle.cloud.apigateway.v1beta.ApiGatewayService.ListApisGetIamPolicygoogle.longrunning.Operations.GetOperationgoogle.longrunning.Operations.ListOperations |
ADMIN_WRITE |
google.cloud.apigateway.v1.ApiGatewayService.CreateApi (LRO)google.cloud.apigateway.v1.ApiGatewayService.CreateApiConfig (LRO)google.cloud.apigateway.v1.ApiGatewayService.CreateGateway (LRO)google.cloud.apigateway.v1.ApiGatewayService.DeleteApi (LRO)google.cloud.apigateway.v1.ApiGatewayService.DeleteApiConfig (LRO)google.cloud.apigateway.v1.ApiGatewayService.DeleteGateway (LRO)google.cloud.apigateway.v1.ApiGatewayService.UpdateApi (LRO)google.cloud.apigateway.v1.ApiGatewayService.UpdateApiConfig (LRO)google.cloud.apigateway.v1.ApiGatewayService.UpdateGateway (LRO)google.cloud.apigateway.v1beta.ApiGatewayService.CreateApi (LRO)google.cloud.apigateway.v1beta.ApiGatewayService.CreateApiConfig (LRO)google.cloud.apigateway.v1beta.ApiGatewayService.CreateGateway (LRO)google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApi (LRO)google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApiConfig (LRO)google.cloud.apigateway.v1beta.ApiGatewayService.DeleteGateway (LRO)google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApi (LRO)google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApiConfig (LRO)google.cloud.apigateway.v1beta.ApiGatewayService.UpdateGateway (LRO)SetIamPolicygoogle.longrunning.Operations.CancelOperationgoogle.longrunning.Operations.DeleteOperation |
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 Gateway.
google.cloud.apigateway.v1.ApiGatewayService
Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.cloud.apigateway.v1.ApiGatewayService gehören.
CreateApi
- Methode:
google.cloud.apigateway.v1.ApiGatewayService.CreateApi - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.apis.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.apigateway.v1.ApiGatewayService.CreateApi"
CreateApiConfig
- Methode:
google.cloud.apigateway.v1.ApiGatewayService.CreateApiConfig - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.apiconfigs.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.apigateway.v1.ApiGatewayService.CreateApiConfig"
CreateGateway
- Methode:
google.cloud.apigateway.v1.ApiGatewayService.CreateGateway - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.gateways.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.apigateway.v1.ApiGatewayService.CreateGateway"
DeleteApi
- Methode:
google.cloud.apigateway.v1.ApiGatewayService.DeleteApi - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.apis.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.apigateway.v1.ApiGatewayService.DeleteApi"
DeleteApiConfig
- Methode:
google.cloud.apigateway.v1.ApiGatewayService.DeleteApiConfig - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.apiconfigs.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.apigateway.v1.ApiGatewayService.DeleteApiConfig"
DeleteGateway
- Methode:
google.cloud.apigateway.v1.ApiGatewayService.DeleteGateway - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.gateways.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.apigateway.v1.ApiGatewayService.DeleteGateway"
GetApi
- Methode:
google.cloud.apigateway.v1.ApiGatewayService.GetApi - Audit-Logtyp: Datenzugriff
- Berechtigungen:
apigateway.apis.get - ADMIN_READ
- Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang:
Nein.
- Filter für diese Methode:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.GetApi"
GetApiConfig
- Methode:
google.cloud.apigateway.v1.ApiGatewayService.GetApiConfig - Audit-Logtyp: Datenzugriff
- Berechtigungen:
apigateway.apiconfigs.get - ADMIN_READ
- Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang:
Nein.
- Filter für diese Methode:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.GetApiConfig"
GetGateway
- Methode:
google.cloud.apigateway.v1.ApiGatewayService.GetGateway - Audit-Logtyp: Datenzugriff
- Berechtigungen:
apigateway.gateways.get - ADMIN_READ
- Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang:
Nein.
- Filter für diese Methode:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.GetGateway"
ListApiConfigs
- Methode:
google.cloud.apigateway.v1.ApiGatewayService.ListApiConfigs - Audit-Logtyp: Datenzugriff
- Berechtigungen:
apigateway.apiconfigs.list - ADMIN_READ
- Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang:
Nein.
- Filter für diese Methode:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.ListApiConfigs"
ListApis
- Methode:
google.cloud.apigateway.v1.ApiGatewayService.ListApis - Audit-Logtyp: Datenzugriff
- Berechtigungen:
apigateway.apis.list - ADMIN_READ
- Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang:
Nein.
- Filter für diese Methode:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.ListApis"
ListGateways
- Methode:
google.cloud.apigateway.v1.ApiGatewayService.ListGateways - Audit-Logtyp: Datenzugriff
- Berechtigungen:
apigateway.gateways.list - ADMIN_READ
- Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang:
Nein.
- Filter für diese Methode:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.ListGateways"
UpdateApi
- Methode:
google.cloud.apigateway.v1.ApiGatewayService.UpdateApi - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.apis.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.cloud.apigateway.v1.ApiGatewayService.UpdateApi"
UpdateApiConfig
- Methode:
google.cloud.apigateway.v1.ApiGatewayService.UpdateApiConfig - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.apiconfigs.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.cloud.apigateway.v1.ApiGatewayService.UpdateApiConfig"
UpdateGateway
- Methode:
google.cloud.apigateway.v1.ApiGatewayService.UpdateGateway - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.gateways.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.cloud.apigateway.v1.ApiGatewayService.UpdateGateway"
google.cloud.apigateway.v1beta.ApiGatewayService
Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.cloud.apigateway.v1beta.ApiGatewayService gehören.
CreateApi
- Methode:
google.cloud.apigateway.v1beta.ApiGatewayService.CreateApi - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.apis.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.apigateway.v1beta.ApiGatewayService.CreateApi"
CreateApiConfig
- Methode:
google.cloud.apigateway.v1beta.ApiGatewayService.CreateApiConfig - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.apiconfigs.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.apigateway.v1beta.ApiGatewayService.CreateApiConfig"
CreateGateway
- Methode:
google.cloud.apigateway.v1beta.ApiGatewayService.CreateGateway - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.gateways.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.apigateway.v1beta.ApiGatewayService.CreateGateway"
DeleteApi
- Methode:
google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApi - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.apis.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.apigateway.v1beta.ApiGatewayService.DeleteApi"
DeleteApiConfig
- Methode:
google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApiConfig - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.apiconfigs.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.apigateway.v1beta.ApiGatewayService.DeleteApiConfig"
DeleteGateway
- Methode:
google.cloud.apigateway.v1beta.ApiGatewayService.DeleteGateway - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.gateways.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.apigateway.v1beta.ApiGatewayService.DeleteGateway"
GetApi
- Methode:
google.cloud.apigateway.v1beta.ApiGatewayService.GetApi - Audit-Logtyp: Datenzugriff
- Berechtigungen:
apigateway.apis.get - ADMIN_READ
- Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang:
Nein.
- Filter für diese Methode:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.GetApi"
GetApiConfig
- Methode:
google.cloud.apigateway.v1beta.ApiGatewayService.GetApiConfig - Audit-Logtyp: Datenzugriff
- Berechtigungen:
apigateway.apiconfigs.get - ADMIN_READ
- Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang:
Nein.
- Filter für diese Methode:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.GetApiConfig"
GetGateway
- Methode:
google.cloud.apigateway.v1beta.ApiGatewayService.GetGateway - Audit-Logtyp: Datenzugriff
- Berechtigungen:
apigateway.gateways.get - ADMIN_READ
- Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang:
Nein.
- Filter für diese Methode:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.GetGateway"
ListApis
- Methode:
google.cloud.apigateway.v1beta.ApiGatewayService.ListApis - Audit-Logtyp: Datenzugriff
- Berechtigungen:
apigateway.apis.list - ADMIN_READ
- Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang:
Nein.
- Filter für diese Methode:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.ListApis"
UpdateApi
- Methode:
google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApi - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.apis.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.cloud.apigateway.v1beta.ApiGatewayService.UpdateApi"
UpdateApiConfig
- Methode:
google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApiConfig - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.apiconfigs.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.cloud.apigateway.v1beta.ApiGatewayService.UpdateApiConfig"
UpdateGateway
- Methode:
google.cloud.apigateway.v1beta.ApiGatewayService.UpdateGateway - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.gateways.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.cloud.apigateway.v1beta.ApiGatewayService.UpdateGateway"
google.iam.v1.IAMPolicy
Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.iam.v1.IAMPolicy gehören.
GetIamPolicy
- Methode:
GetIamPolicy - Audit-Logtyp: Datenzugriff
- Berechtigungen:
apigateway.apis.getIamPolicy - ADMIN_READapigateway.gateways.getIamPolicy - ADMIN_READ
- Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang:
Nein.
- Filter für diese Methode:
protoPayload.methodName="GetIamPolicy"
SetIamPolicy
- Methode:
SetIamPolicy - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.apiconfigs.setIamPolicy - ADMIN_WRITEapigateway.apis.setIamPolicy - ADMIN_WRITEapigateway.gateways.setIamPolicy - ADMIN_WRITE
- Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang:
Nein.
- Filter für diese Methode:
protoPayload.methodName="SetIamPolicy"
google.longrunning.Operations
Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.longrunning.Operations gehören.
CancelOperation
- Methode:
google.longrunning.Operations.CancelOperation - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.operations.cancel - ADMIN_WRITE
- Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang:
Nein.
- Filter für diese Methode:
protoPayload.methodName="google.longrunning.Operations.CancelOperation"
DeleteOperation
- Methode:
google.longrunning.Operations.DeleteOperation - Audit-Logtyp: Administratoraktivität
- Berechtigungen:
apigateway.operations.delete - ADMIN_WRITE
- Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang:
Nein.
- Filter für diese Methode:
protoPayload.methodName="google.longrunning.Operations.DeleteOperation"
GetOperation
- Methode:
google.longrunning.Operations.GetOperation - Audit-Logtyp: Datenzugriff
- Berechtigungen:
apigateway.operations.get - ADMIN_READ
- Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang:
Nein.
- Filter für diese Methode:
protoPayload.methodName="google.longrunning.Operations.GetOperation"
ListOperations
- Methode:
google.longrunning.Operations.ListOperations - Audit-Logtyp: Datenzugriff
- Berechtigungen:
apigateway.operations.list - ADMIN_READ
- Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang:
Nein.
- Filter für diese Methode:
protoPayload.methodName="google.longrunning.Operations.ListOperations"
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.GetLocationgoogle.cloud.location.Locations.ListLocationsgoogle.longrunning.Operations.WaitOperation