Logging di controllo di API Gateway

Questo documento descrive l'audit logging per API Gateway. Google Cloud i servizi generano audit log che registrano le attività amministrative e di accesso all'interno delle tue Google Cloud risorse. Per ulteriori informazioni su Cloud Audit Logs, consulta quanto segue:

Nome servizio

Gli audit log di API Gateway utilizzano il nome servizio apigateway.googleapis.com. Filtra per questo servizio: 

    protoPayload.serviceName="apigateway.googleapis.com"

Metodi per tipo di autorizzazione

Ogni autorizzazione IAM ha una proprietà type, il cui valore è un enum che può essere uno dei quattro valori: ADMIN_READ, ADMIN_WRITE, DATA_READ o DATA_WRITE. Quando chiami un metodo, API Gateway genera un audit log la cui categoria dipende dalla proprietà type dell'autorizzazione richiesta per eseguire il metodo. I metodi che richiedono un'autorizzazione IAM con il valore della proprietà type corrispondente a DATA_READ, DATA_WRITE o ADMIN_READ generano audit log degli Accessi ai dati. I metodi che richiedono un'autorizzazione IAM con il valore della proprietà type ADMIN_WRITE generano audit log delle Attività di amministrazione.

I metodi API nel seguente elenco contrassegnati con (LRO) sono operazioni a lunga esecuzione (LRO). Questi metodi in genere generano due voci del log di controllo: una all'inizio dell'operazione e un'altra al termine. Per saperne di più, consulta Audit log per le operazioni a lunga esecuzione.
Tipo di autorizzazione Metodi
ADMIN_READ google.cloud.apigateway.v1.ApiGatewayService.GetApi
google.cloud.apigateway.v1.ApiGatewayService.GetApiConfig
google.cloud.apigateway.v1.ApiGatewayService.GetGateway
google.cloud.apigateway.v1.ApiGatewayService.ListApiConfigs
google.cloud.apigateway.v1.ApiGatewayService.ListApis
google.cloud.apigateway.v1.ApiGatewayService.ListGateways
google.cloud.apigateway.v1beta.ApiGatewayService.GetApi
google.cloud.apigateway.v1beta.ApiGatewayService.GetApiConfig
google.cloud.apigateway.v1beta.ApiGatewayService.GetGateway
google.cloud.apigateway.v1beta.ApiGatewayService.ListApis
GetIamPolicy
google.longrunning.Operations.GetOperation
google.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)
SetIamPolicy
google.longrunning.Operations.CancelOperation
google.longrunning.Operations.DeleteOperation

Audit log dell'interfaccia API

Per informazioni su come e quali autorizzazioni vengono valutate per ogni metodo, consulta la documentazione di Identity and Access Management per API Gateway.

google.cloud.apigateway.v1.ApiGatewayService

I seguenti audit log sono associati ai metodi appartenenti a google.cloud.apigateway.v1.ApiGatewayService.

CreateApi

  • Metodo: google.cloud.apigateway.v1.ApiGatewayService.CreateApi
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.apis.create - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.CreateApi"

CreateApiConfig

  • Metodo: google.cloud.apigateway.v1.ApiGatewayService.CreateApiConfig
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.apiconfigs.create - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.CreateApiConfig"

CreateGateway

  • Metodo: google.cloud.apigateway.v1.ApiGatewayService.CreateGateway
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.gateways.create - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.CreateGateway"

DeleteApi

  • Metodo: google.cloud.apigateway.v1.ApiGatewayService.DeleteApi
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.apis.delete - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.DeleteApi"

DeleteApiConfig

  • Metodo: google.cloud.apigateway.v1.ApiGatewayService.DeleteApiConfig
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.apiconfigs.delete - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.DeleteApiConfig"

DeleteGateway

  • Metodo: google.cloud.apigateway.v1.ApiGatewayService.DeleteGateway
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.gateways.delete - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.DeleteGateway"

GetApi

  • Metodo: google.cloud.apigateway.v1.ApiGatewayService.GetApi
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • apigateway.apis.get - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.GetApi"

GetApiConfig

  • Metodo: google.cloud.apigateway.v1.ApiGatewayService.GetApiConfig
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • apigateway.apiconfigs.get - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.GetApiConfig"

GetGateway

  • Metodo: google.cloud.apigateway.v1.ApiGatewayService.GetGateway
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • apigateway.gateways.get - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.GetGateway"

ListApiConfigs

  • Metodo: google.cloud.apigateway.v1.ApiGatewayService.ListApiConfigs
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • apigateway.apiconfigs.list - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.ListApiConfigs"

ListApis

  • Metodo: google.cloud.apigateway.v1.ApiGatewayService.ListApis
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • apigateway.apis.list - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.ListApis"

ListGateways

  • Metodo: google.cloud.apigateway.v1.ApiGatewayService.ListGateways
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • apigateway.gateways.list - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.ListGateways"

UpdateApi

  • Metodo: google.cloud.apigateway.v1.ApiGatewayService.UpdateApi
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.apis.update - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.UpdateApi"

UpdateApiConfig

  • Metodo: google.cloud.apigateway.v1.ApiGatewayService.UpdateApiConfig
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.apiconfigs.update - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.UpdateApiConfig"

UpdateGateway

  • Metodo: google.cloud.apigateway.v1.ApiGatewayService.UpdateGateway
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.gateways.update - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.UpdateGateway"

google.cloud.apigateway.v1beta.ApiGatewayService

I seguenti audit log sono associati ai metodi appartenenti a google.cloud.apigateway.v1beta.ApiGatewayService.

CreateApi

  • Metodo: google.cloud.apigateway.v1beta.ApiGatewayService.CreateApi
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.apis.create - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.CreateApi"

CreateApiConfig

  • Metodo: google.cloud.apigateway.v1beta.ApiGatewayService.CreateApiConfig
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.apiconfigs.create - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.CreateApiConfig"

CreateGateway

  • Metodo: google.cloud.apigateway.v1beta.ApiGatewayService.CreateGateway
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.gateways.create - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.CreateGateway"

DeleteApi

  • Metodo: google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApi
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.apis.delete - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApi"

DeleteApiConfig

  • Metodo: google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApiConfig
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.apiconfigs.delete - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApiConfig"

DeleteGateway

  • Metodo: google.cloud.apigateway.v1beta.ApiGatewayService.DeleteGateway
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.gateways.delete - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.DeleteGateway"

GetApi

  • Metodo: google.cloud.apigateway.v1beta.ApiGatewayService.GetApi
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • apigateway.apis.get - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.GetApi"

GetApiConfig

  • Metodo: google.cloud.apigateway.v1beta.ApiGatewayService.GetApiConfig
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • apigateway.apiconfigs.get - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.GetApiConfig"

GetGateway

  • Metodo: google.cloud.apigateway.v1beta.ApiGatewayService.GetGateway
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • apigateway.gateways.get - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.GetGateway"

ListApis

  • Metodo: google.cloud.apigateway.v1beta.ApiGatewayService.ListApis
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • apigateway.apis.list - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.ListApis"

UpdateApi

  • Metodo: google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApi
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.apis.update - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApi"

UpdateApiConfig

  • Metodo: google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApiConfig
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.apiconfigs.update - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApiConfig"

UpdateGateway

  • Metodo: google.cloud.apigateway.v1beta.ApiGatewayService.UpdateGateway
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.gateways.update - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.UpdateGateway"

google.iam.v1.IAMPolicy

I seguenti audit log sono associati ai metodi appartenenti a google.iam.v1.IAMPolicy.

GetIamPolicy

  • Metodo: GetIamPolicy
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • apigateway.apis.getIamPolicy - ADMIN_READ
    • apigateway.gateways.getIamPolicy - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="GetIamPolicy"

SetIamPolicy

  • Metodo: SetIamPolicy
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.apiconfigs.setIamPolicy - ADMIN_WRITE
    • apigateway.apis.setIamPolicy - ADMIN_WRITE
    • apigateway.gateways.setIamPolicy - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="SetIamPolicy"

google.longrunning.Operations

I seguenti audit log sono associati ai metodi appartenenti a google.longrunning.Operations.

CancelOperation

  • Metodo: google.longrunning.Operations.CancelOperation
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.operations.cancel - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.longrunning.Operations.CancelOperation"

DeleteOperation

  • Metodo: google.longrunning.Operations.DeleteOperation
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • apigateway.operations.delete - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.longrunning.Operations.DeleteOperation"

GetOperation

  • Metodo: google.longrunning.Operations.GetOperation
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • apigateway.operations.get - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.longrunning.Operations.GetOperation"

ListOperations

  • Metodo: google.longrunning.Operations.ListOperations
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • apigateway.operations.list - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.longrunning.Operations.ListOperations"

Metodi che non generano audit log

Un metodo potrebbe non generare audit log per uno o più dei seguenti motivi:

  • Si tratta di un metodo ad alto volume che comporta costi significativi per la generazione e l'archiviazione dei log.
  • Ha un valore di auditing basso.
  • Un altro audit log o log della piattaforma fornisce già la copertura del metodo.

I seguenti metodi non generano audit log:

  • google.cloud.location.Locations.GetLocation
  • google.cloud.location.Locations.ListLocations
  • google.longrunning.Operations.WaitOperation