API 密钥审核日志记录

本文档介绍了 API 密钥的审核日志记录。 Google Cloud 服务会生成审核日志，以记录 Google Cloud 资源中的管理和访问活动。如需详细了解 Cloud Audit Logs，请参阅以下内容：

• 审核日志类型
• 审核日志条目结构
• 存储和路由审核日志
• Cloud Logging 价格摘要
• 启用数据访问审核日志

服务名称

API 密钥审核日志使用服务名称 apikeys.googleapis.com。 针对此服务的过滤条件：

    protoPayload.serviceName="apikeys.googleapis.com"
  

方法（按权限类型）

每个 IAM 权限都有一个 type 属性，该属性的值是一个枚举，可以是以下四个值之一：ADMIN_READ、ADMIN_WRITE、DATA_READ 或 DATA_WRITE。在您调用某个方法时，API 密钥会生成一个审核日志，其类别取决于执行该方法所需权限的 type 属性。需要 IAM 权限且 type 属性值为 DATA_READ、DATA_WRITE 或 ADMIN_READ 的方法会生成数据访问审核日志。需要 IAM 权限且 type 属性值为 ADMIN_WRITE 的方法会生成管理员活动审核日志。

以下列表中标记为 (LRO) 的 API 方法是长时间运行的操作 (LRO)。 这些方法通常会生成两个审核日志条目：一个在操作开始时生成，另一个在操作结束时生成。如需了解详情，请参阅长时间运行的操作的审核日志。

权限类型	方法
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

API 接口审核日志

如需了解如何评估每种方法的权限以及评估哪些权限，请参阅 API 密钥的 Identity and Access Management 文档。

google.api.apikeys.v2.ApiKeys

以下审核日志与属于 google.api.apikeys.v2.ApiKeys 的方法相关联。

CreateKey

• 方法：google.api.apikeys.v2.ApiKeys.CreateKey
  
• 审核日志类型：管理员活动
  
• 权限：
  • serviceusage.apiKeys.create - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.api.apikeys.v2.ApiKeys.CreateKey"
  

DeleteKey

• 方法：google.api.apikeys.v2.ApiKeys.DeleteKey
  
• 审核日志类型：管理员活动
  
• 权限：
  • serviceusage.apiKeys.delete - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.api.apikeys.v2.ApiKeys.DeleteKey"
  

GetKeyString

• 方法：google.api.apikeys.v2.ApiKeys.GetKeyString
  
• 审核日志类型：数据访问
  
• 权限：
  • apikeys.keys.getKeyString - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.api.apikeys.v2.ApiKeys.GetKeyString"
  

UndeleteKey

• 方法：google.api.apikeys.v2.ApiKeys.UndeleteKey
  
• 审核日志类型：管理员活动
  
• 权限：
  • apikeys.keys.undelete - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.api.apikeys.v2.ApiKeys.UndeleteKey"
  

UpdateKey

• 方法：google.api.apikeys.v2.ApiKeys.UpdateKey
  
• 审核日志类型：管理员活动
  
• 权限：
  • serviceusage.apiKeys.update - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：长时间运行的操作
  
• 此方法的过滤条件： protoPayload.methodName="google.api.apikeys.v2.ApiKeys.UpdateKey"
  

google.longrunning.Operations

以下审核日志与属于 google.longrunning.Operations 的方法相关联。

GetOperation

• 方法：google.longrunning.Operations.GetOperation
  
• 审核日志类型：管理员活动
  
• 权限：
  • apikeys.keys.create - ADMIN_WRITE
  • apikeys.keys.delete - ADMIN_WRITE
  • serviceusage.operations.get - DATA_READ
  • serviceusage.services.get - DATA_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.longrunning.Operations.GetOperation"