Os registros de auditoria do Cloud para chaves de API permitem rastrear operações administrativas e de acesso a dados nos seus recursos para ajudar a monitorar o acesso e as alterações de configuração. É possível consultar esses registros na Análise de Registros e verificar quais métodos da API de chaves de API geram registros de auditoria do Cloud.
Para mais informações sobre os Registros de Auditoria do Cloud, consulte os seguintes documentos:
- Tipos de registros de auditoria
- Estrutura da entrada de registro de auditoria
- Como armazenar e rotear registros de auditoria
- Resumo dos preços do Cloud Logging
- Ativar registros de auditoria de acesso aos dados
Nome do serviço
Para ver os registros de auditoria das chaves de API, faça o seguinte:
No console do Cloud de Confiance , acesse a página Análise de registros:
Copie e cole a consulta a seguir no campo Consulta da Análise de registros e clique em Executar consulta.
protoPayload.serviceName="apikeys.googleapis.com"
Métodos por tipo de permissão
Cada permissão do IAM tem uma propriedade type, com um tipo enumerado
que pode ser um dos quatro seguintes valores: ADMIN_READ, ADMIN_WRITE,
DATA_READ ou DATA_WRITE. Quando você chama um método,
as chaves de API geram 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.
| Tipo de permissão | Métodos |
|---|---|
ADMIN_READ |
google.api.apikeys.v2.ApiKeys.GetKeyString |
ADMIN_WRITE |
google.api.apikeys.v2.ApiKeys.CreateKey (LRO)google.api.apikeys.v2.ApiKeys.DeleteKey (LRO)google.api.apikeys.v2.ApiKeys.UndeleteKey (LRO)google.api.apikeys.v2.ApiKeys.UpdateKey (LRO)google.longrunning.Operations.GetOperation |
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 chaves de API.
google.api.apikeys.v2.ApiKeys
Os registros de auditoria a seguir estão associados a métodos que pertencem a
google.api.apikeys.v2.ApiKeys.
CreateKey
- Método:
google.api.apikeys.v2.ApiKeys.CreateKey - Tipo de registro de auditoria: atividade do administrador
- Permissões:
serviceusage.apiKeys.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.api.apikeys.v2.ApiKeys.CreateKey"
DeleteKey
- Método:
google.api.apikeys.v2.ApiKeys.DeleteKey - Tipo de registro de auditoria: atividade do administrador
- Permissões:
serviceusage.apiKeys.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.api.apikeys.v2.ApiKeys.DeleteKey"
GetKeyString
- Método:
google.api.apikeys.v2.ApiKeys.GetKeyString - Tipo de registro de auditoria: acesso aos dados
- Permissões:
apikeys.keys.getKeyString - ADMIN_READ
- O método é uma operação de streaming ou de longa duração:
nenhum
- Filtrar para este método:
protoPayload.methodName="google.api.apikeys.v2.ApiKeys.GetKeyString"
UndeleteKey
- Método:
google.api.apikeys.v2.ApiKeys.UndeleteKey - Tipo de registro de auditoria: atividade do administrador
- Permissões:
apikeys.keys.undelete - 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.api.apikeys.v2.ApiKeys.UndeleteKey"
UpdateKey
- Método:
google.api.apikeys.v2.ApiKeys.UpdateKey - Tipo de registro de auditoria: atividade do administrador
- Permissões:
serviceusage.apiKeys.update - 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.api.apikeys.v2.ApiKeys.UpdateKey"
google.longrunning.Operations
Os registros de auditoria a seguir estão associados a métodos que pertencem a
google.longrunning.Operations.
GetOperation
- Método:
google.longrunning.Operations.GetOperation - Tipo de registro de auditoria: atividade do administrador
- Permissões:
apikeys.keys.create - ADMIN_WRITEapikeys.keys.delete - ADMIN_WRITEserviceusage.operations.get - DATA_READserviceusage.services.enable - ADMIN_WRITEserviceusage.services.get - DATA_READ
- O método é uma operação de streaming ou de longa duração:
nenhum
- Filtrar para este método:
protoPayload.methodName="google.longrunning.Operations.GetOperation"
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.api.apikeys.v2.ApiKeys.GetKeygoogle.api.apikeys.v2.ApiKeys.ListKeysgoogle.api.apikeys.v2.ApiKeys.LookupKey