Identity-Aware Proxy 审核日志记录

<ph type="x-smartling-placeholder">

</ph> 重要提示：

2024 年 2 月 14 日，Cloud Audit Logging (CAL) 类型出现了意外 已从“DATA_ACCESS”更改为“ADMIN_ACTIVITY”。此更改会导致 UpdateIapSettings 和 ValidateIapAttributeExpression 方法的日志名称和日志存储桶位置发生变化。

CAL 类型已更改回 DATA_ACCESS。

本文档介绍了 Identity-Aware Proxy 的审核日志记录，包括哪些方法 生成审核日志，详细了解每种方法生成的审核日志，以及 哪些方法不会生成审核日志（如果有）。Google Cloud 会生成审核日志，用于记录 Google Cloud 资源中的管理和访问活动。如需了解详情，请参阅 Cloud Audit Logs 概览、 本页包含 如何查看审核日志， 如何存储和路由它们， 等等。

备注

字段部分介绍了关于审核日志中某些字段的重要详细信息。

服务名称

Identity-Aware Proxy 审核日志使用服务名称 iap.googleapis.com。 此服务的过滤条件：

    protoPayload.serviceName="iap.googleapis.com"
  

方法（按权限类型）

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

权限类型	方法
ADMIN_READ	google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy
ADMIN_WRITE	google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy
DATA_READ	google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups
DATA_WRITE	google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression

API 界面审核日志

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

google.cloud.iap.v1.IdentityAwareProxyAdminService

以下部分包含与属于 google.cloud.iap.v1.IdentityAwareProxyAdminService 的方法关联的审核日志的详细信息。

CreateTunnelDestGroup

• 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup
  
• 审核日志类型：数据访问
  
• 权限：
  • iap.tunnelDestGroups.create - DATA_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup"
  

DeleteTunnelDestGroup

• 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup
  
• 审核日志类型：数据访问
  
• 权限：
  • iap.tunnelDestGroups.delete - DATA_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup"
  

GetIamPolicy

• 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy
  
• 审核日志类型：数据访问
  
• 权限：如需了解权限，请参阅 IAM 文档。
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy"
  

GetIapSettings

• 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings
  
• 审核日志类型：数据访问
  
• 权限：
  • iap.projects.getSettings - ADMIN_READ
  • iap.web.getSettings - ADMIN_READ
  • iap.webServiceVersions.getSettings - ADMIN_READ
  • iap.webServices.getSettings - ADMIN_READ
  • iap.webTypes.getSettings - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings"
  

GetTunnelDestGroup

• 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup
  
• 审核日志类型：数据访问
  
• 权限：
  • iap.tunnelDestGroups.get - DATA_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup"
  

ListTunnelDestGroups

• 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups
  
• 审核日志类型：数据访问
  
• 权限：
  • iap.tunnelDestGroups.list - DATA_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups"
  

SetIamPolicy

• 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy
  
• 审核日志类型：管理员活动
  
• 权限：如需了解权限，请参阅 IAM 文档。
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy"
  

UpdateIapSettings

• 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings
  
• 审核日志类型：数据访问
  
• 权限：如需了解权限，请参阅 IAM 文档。
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings"
  

UpdateTunnelDestGroup

• 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup
  
• 审核日志类型：数据访问
  
• 权限：
  • iap.tunnelDestGroups.update - DATA_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup"
  

ValidateIapAttributeExpression

• 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression
  
• 审核日志类型：数据访问
  
• 权限：
  • iap.web.updateSettings - ADMIN_WRITE
  • iap.web.updateSettings - DATA_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression"
  

google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1

以下部分包含与属于 google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1 的方法关联的审核日志的详细信息。

GetIamPolicy

• 方法：google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy
  
• 审核日志类型：数据访问
  
• 权限：
  • iap.web.getIamPolicy - ADMIN_READ
  • iap.webServiceVersions.getIamPolicy - ADMIN_READ
  • iap.webServices.getIamPolicy - ADMIN_READ
  • iap.webTypes.getIamPolicy - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy"
  

SetIamPolicy

• 方法：google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy
  
• 审核日志类型：管理员活动
  
• 权限：如需了解权限，请参阅 IAM 文档。
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy"
  

不会生成审核日志的方法

由于以下一个或多个原因，方法可能不会生成审核日志：

• 这是一种高容量方法，涉及较高的日志生成和存储费用。
• 它的审核价值较低。
• 其他审核或平台日志已提供方法。

以下方法不会生成审核日志：

• google.cloud.iap.v1.IdentityAwareProxyOAuthService.CreateBrand
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.CreateIdentityAwareProxyClient
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.DeleteIdentityAwareProxyClient
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.GetBrand
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.GetIdentityAwareProxyClient
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.ListBrands
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.ListIdentityAwareProxyClients
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.ResetIdentityAwareProxyClientSecret
• google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.TestIamPermissions

字段

日志仅包含有关用户已达到的访问权限级别的信息。阻止未经授权请求的访问权限级别未列在日志条目中。如需确定针对给定资源成功发出请求所需的条件，请检查该资源的访问权限级别。

以下是关于日志中某些字段的重要详细信息：

字段	值
authenticationInfo	尝试以 principalEmail 身份访问资源的用户的电子邮件地址。对于未经身份验证的请求，此信息不会出现在日志中。
requestMetadata.callerIp	发出请求的 IP 地址。
requestMetadata.requestAttributes	请求方法和网址。
authorizationInfo.resource	要访问的资源。
authorizationInfo.granted	一个布尔值，表示 IAP 是否允许请求的访问。