本文档介绍了 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 是否允许请求的访问。 |