Registro de auditoría de Identity-Aware Proxy

Importante:

El 14 de febrero de 2024, el tipo de Cloud Audit Logging (CAL) se cambió por error de DATA_ACCESS a ADMIN_ACTIVITY. Este cambio provoca un cambio en el nombre del registro y la ubicación del bucket de registros para los métodos UpdateIapSettings y ValidateIapAttributeExpression.

El tipo de CAL se volvió a cambiar a DATA_ACCESS.

En este documento, se describe el registro de auditoría de Identity-Aware Proxy. Los servicios de Google Cloud generan registros de auditoría que registran las actividades administrativas y de acceso dentro de tus recursos de Google Cloud. Para obtener más información sobre los Registros de auditoría de Cloud, consulta los siguientes recursos:

• Tipos de registros de auditoría
• Estructura de entradas de registro de auditoría
• Almacena y enruta registros de auditoría
• Resumen de precios de Cloud Logging
• Habilita los registros de auditoría de acceso a los datos

Notas

En la sección de campos, se describen detalles importantes sobre algunos campos del registro de auditoría.

Nombre del servicio

Los registros de auditoría de Identity-Aware Proxy usan el nombre de servicio iap.googleapis.com. Filtra este servicio:

    protoPayload.serviceName="iap.googleapis.com"
  

Métodos por tipo de permiso

Cada permiso de IAM tiene una propiedad type, cuyo valor es una enumeración que puede ser uno de cuatro valores: ADMIN_READ, ADMIN_WRITE, DATA_READ o DATA_WRITE. Cuando llamas a un método, Identity-Aware Proxy genera un registro de auditoría cuya categoría depende de la propiedad type del permiso necesario para realizar el método. Los métodos que requieren un permiso de IAM con el valor de propiedad type de DATA_READ, DATA_WRITE o ADMIN_READ generan registros de auditoría de acceso a los datos. Los métodos que requieren un permiso de IAM con el valor de propiedad type de ADMIN_WRITE generan registros de auditoría de actividad del administrador.

Tipo de permiso	Métodos
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

Registros de auditoría de la interfaz de la API

Si quieres obtener información sobre cómo y qué permisos se evalúan para cada método, consulta la documentación de Identity and Access Management para Identity-Aware Proxy.

google.cloud.iap.v1.IdentityAwareProxyAdminService

Los siguientes registros de auditoría están asociados con métodos que pertenecen a google.cloud.iap.v1.IdentityAwareProxyAdminService.

CreateTunnelDestGroup

• Método: google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • iap.tunnelDestGroups.create - DATA_WRITE
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup"
  

DeleteTunnelDestGroup

• Método: google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • iap.tunnelDestGroups.delete - DATA_WRITE
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup"
  

GetIamPolicy

• Método: google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • iap.web.getIamPolicy - ADMIN_READ
  • iap.webServiceVersions.getIamPolicy - ADMIN_READ
  • iap.webServices.getIamPolicy - ADMIN_READ
  • iap.webTypes.getIamPolicy - ADMIN_READ
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy"
  

GetIapSettings

• Método: google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • 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
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings"
  

GetTunnelDestGroup

• Método: google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • iap.tunnelDestGroups.get - DATA_READ
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup"
  

ListTunnelDestGroups

• Método: google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • iap.tunnelDestGroups.list - DATA_READ
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups"
  

SetIamPolicy

• Método: google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy
  
• Tipo de registro de auditoría: actividad del administrador
  
• Permisos:
  • iap.web.setIamPolicy - ADMIN_WRITE
  • iap.webServiceVersions.setIamPolicy - ADMIN_WRITE
  • iap.webServices.setIamPolicy - ADMIN_WRITE
  • iap.webTypes.setIamPolicy - ADMIN_WRITE
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy"
  

UpdateIapSettings

• Método: google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • 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
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings"
  

UpdateTunnelDestGroup

• Método: google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • iap.tunnelDestGroups.update - DATA_WRITE
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup"
  

ValidateIapAttributeExpression

• Método: google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression
  
• Tipo de registro de auditoría: actividad del administrador
  
• Permisos:
  • iap.web.updateSettings - ADMIN_WRITE
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression"
  

google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1

Los siguientes registros de auditoría están asociados con métodos que pertenecen a google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.

GetIamPolicy

• Método: google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy
  
• Tipo de registro de auditoría: acceso a los datos
  
• Permisos:
  • iap.web.getIamPolicy - ADMIN_READ
  • iap.webServiceVersions.getIamPolicy - ADMIN_READ
  • iap.webServices.getIamPolicy - ADMIN_READ
  • iap.webTypes.getIamPolicy - ADMIN_READ
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy"
  

SetIamPolicy

• Método: google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy
  
• Tipo de registro de auditoría: actividad del administrador
  
• Permisos:
  • iap.webServiceVersions.setIamPolicy - ADMIN_WRITE
  • iap.webServices.setIamPolicy - ADMIN_WRITE
  • iap.webTypes.setIamPolicy - ADMIN_WRITE
• El método es una operación de larga duración o de transmisión: no.
  
• Filtra para este método: protoPayload.methodName="google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy"
  

Métodos que no producen registros de auditoría

Es posible que un método no produzca registros de auditoría por uno o más de los siguientes motivos:

• Es un método de gran volumen que implica costos significativos de generación y almacenamiento de registros.
• Tiene un valor de auditoría bajo.
• Otro registro de auditoría o de plataforma ya proporciona cobertura del método.

Los siguientes métodos no producen registros de auditoría:

• 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

Campos

Los registros solo contienen información sobre los niveles de acceso que un usuario cumplió. Los niveles de acceso que bloquearon una solicitud no autorizada no se incluyen en la entrada del registro. Para determinar qué condiciones son necesarias a fin de realizar una solicitud correcta para un recurso determinado, comprueba los niveles de acceso del recurso.

A continuación, se presentan detalles importantes sobre algunos campos del registro:

Campo	Valor
authenticationInfo	El correo electrónico del usuario que intentó acceder al recurso como principalEmail Esta información no está presente en los registros de las solicitudes no autenticadas.
requestMetadata.callerIp	La dirección IP desde la que se originó la solicitud
requestMetadata.requestAttributes	El método de solicitud y la URL.
authorizationInfo.resource	El recurso al que se accede
authorizationInfo.granted	Un valor booleano que representa si el IAP permitió el acceso solicitado