Geração de registros de auditoria do gerenciamento de APIs da Apigee

Neste documento, descrevemos a geração de registros de auditoria do gerenciamento de APIs da Apigee.Os serviços do Google Cloud geram registros de auditoria das atividades administrativas e de acesso nos recursos do Google Cloud . Para mais informações sobre os Registros de auditoria do Cloud, consulte:

Nome do serviço

Os registros de auditoria do gerenciamento de APIs da Apigee usam o nome de serviço apim.googleapis.com. Filtrar por este serviço: 

    protoPayload.serviceName="apim.googleapis.com"

Métodos por tipo de permissão

Cada permissão do IAM tem uma propriedade type, que tem o valor de um tipo enumerado que pode ser um dos quatro valores: ADMIN_READ, ADMIN_WRITE, DATA_READ ou DATA_WRITE. Quando você chama um método, o gerenciamento de APIs da Apigee gera um registro de auditoria com categoria dependente da propriedade type da permissão necessária para executar o método. Métodos que exigem uma permissão do IAM com o valor da propriedade type de DATA_READ, DATA_WRITE ou ADMIN_READ geram registros de auditoria de acesso aos dados. Métodos que exigem uma permissão do IAM com o valor da propriedade type de ADMIN_WRITE geram registros de auditoria de Atividade do administrador.

Os métodos de API na lista a seguir marcados com (LRO) são operações de longa duração (LROs). Esses métodos geralmente geram duas entradas de registro de auditoria: uma quando a operação começa e outra quando ela termina. Para mais informações, consulte Registros de auditoria para operações de longa duração.
Tipo de permissão Métodos
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)

Registros de auditoria da interface da API

Para informações sobre como e quais permissões são avaliadas para cada método, consulte a documentação do Identity and Access Management para o gerenciamento de APIs da Apigee.

google.cloud.apim.v1alpha.ApiDiscoveryObservation

Os registros de auditoria a seguir estão associados a métodos que pertencem a google.cloud.apim.v1alpha.ApiDiscoveryObservation.

BatchEditTagsApiObservations

  • Método: google.cloud.apim.v1alpha.ApiDiscoveryObservation.BatchEditTagsApiObservations
  • Tipo de registro de auditoria: atividade do administrador
  • Permissões:
    • apim.apiObservations.batchEditTags - ADMIN_WRITE
  • O método é uma operação de streaming ou de longa duração: No
  • Filtrar para este método: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.BatchEditTagsApiObservations"

CreateObservationJob

  • Método: google.cloud.apim.v1alpha.ApiDiscoveryObservation.CreateObservationJob
  • Tipo de registro de auditoria: atividade do administrador
  • Permissões:
    • apim.observationJobs.create - ADMIN_WRITE
  • O método é uma operação de streaming ou de longa duração: operação de longa duração
  • Filtrar para este método: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.CreateObservationJob"

CreateObservationSource

  • Método: google.cloud.apim.v1alpha.ApiDiscoveryObservation.CreateObservationSource
  • Tipo de registro de auditoria: atividade do administrador
  • Permissões:
    • apim.observationSources.create - ADMIN_WRITE
  • O método é uma operação de streaming ou de longa duração: operação de longa duração
  • Filtrar para este método: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.CreateObservationSource"

DeleteObservationJob

  • Método: google.cloud.apim.v1alpha.ApiDiscoveryObservation.DeleteObservationJob
  • Tipo de registro de auditoria: atividade do administrador
  • Permissões:
    • apim.observationJobs.delete - ADMIN_WRITE
  • O método é uma operação de streaming ou de longa duração: operação de longa duração
  • Filtrar para este método: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.DeleteObservationJob"

DeleteObservationSource

  • Método: google.cloud.apim.v1alpha.ApiDiscoveryObservation.DeleteObservationSource
  • Tipo de registro de auditoria: atividade do administrador
  • Permissões:
    • apim.observationSources.delete - ADMIN_WRITE
  • O método é uma operação de streaming ou de longa duração: operação de longa duração
  • Filtrar para este método: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.DeleteObservationSource"

DisableObservationJob

  • Método: google.cloud.apim.v1alpha.ApiDiscoveryObservation.DisableObservationJob
  • Tipo de registro de auditoria: atividade do administrador
  • Permissões:
    • apim.observationJobs.disable - ADMIN_WRITE
  • O método é uma operação de streaming ou de longa duração: operação de longa duração
  • Filtrar para este método: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.DisableObservationJob"

EnableObservationJob

  • Método: google.cloud.apim.v1alpha.ApiDiscoveryObservation.EnableObservationJob
  • Tipo de registro de auditoria: atividade do administrador
  • Permissões:
    • apim.observationJobs.enable - ADMIN_WRITE
  • O método é uma operação de streaming ou de longa duração: operação de longa duração
  • Filtrar para este método: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.EnableObservationJob"

GetObservationSource

  • Método: google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetObservationSource
  • Tipo de registro de auditoria: acesso a dados
  • Permissões:
    • apim.observationSources.get - ADMIN_READ
  • O método é uma operação de streaming ou de longa duração: No
  • Filtrar para este método: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.GetObservationSource"

ListObservationJobs

  • Método: google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListObservationJobs
  • Tipo de registro de auditoria: acesso a dados
  • Permissões:
    • apim.observationJobs.list - ADMIN_READ
  • O método é uma operação de streaming ou de longa duração: No
  • Filtrar para este método: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListObservationJobs"

ListObservationSources

  • Método: google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListObservationSources
  • Tipo de registro de auditoria: acesso a dados
  • Permissões:
    • apim.observationSources.list - ADMIN_READ
  • O método é uma operação de streaming ou de longa duração: No
  • Filtrar para este método: protoPayload.methodName="google.cloud.apim.v1alpha.ApiDiscoveryObservation.ListObservationSources"

Métodos que não geram registros de auditoria

Um método pode não gerar registros de auditoria por um ou mais dos seguintes motivos:

  • É um método de alto volume que envolve geração de registros significativos e custos de armazenamento.
  • Tem pouco valor para a auditoria.
  • Outro registro de auditoria ou plataforma já oferece cobertura do método.

Os métodos abaixo não geram registros de auditoria:

  • 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