Identity-Aware Proxy 审核日志记录

本文档介绍了 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.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression
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

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
  • 审核日志类型：数据访问
  • 权限：
    • 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.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
  • 审核日志类型：管理员活动
  • 权限：
    • iap.web.setIamPolicy - ADMIN_WRITE
    • iap.webServiceVersions.setIamPolicy - ADMIN_WRITE
    • iap.webServices.setIamPolicy - ADMIN_WRITE
    • iap.webTypes.setIamPolicy - ADMIN_WRITE
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy"

UpdateIapSettings

  • 方法：google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings
  • 审核日志类型：数据访问
  • 权限：
    • iap.projects.updateSettings - DATA_WRITE
    • iap.web.updateSettings - ADMIN_WRITE
    • iap.webServiceVersions.updateSettings - DATA_WRITE
    • iap.webServices.updateSettings - DATA_WRITE
    • iap.webTypes.updateSettings - DATA_WRITE
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： 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
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： 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
  • 审核日志类型：管理员活动
  • 权限：
    • iap.webServiceVersions.setIamPolicy - ADMIN_WRITE
    • iap.webServices.setIamPolicy - ADMIN_WRITE
    • iap.webTypes.setIamPolicy - ADMIN_WRITE
  • 方法是长时间运行的操作或流式传输操作：否。
  • 此方法的过滤条件： 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 是否允许请求的访问。