Registros de auditoría de Identity-Aware Proxy

Importante:

El 14 de febrero de 2024, el tipo de Cloud Audit Logging (CAL) se mantuvo inadvertidamente cambió 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 CAL se volvió a cambiar a DATA_ACCESS.

En este documento, se describe el registro de auditoría de Identity-Aware Proxy, incluidos los métodos generar registros de auditoría, detalles sobre los registros de auditoría que produce cada método y qué métodos no producen registros de auditoría, si los hay. Google Cloud genera 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, consulta Descripción general de los registros de auditoría de Cloud, esta página incluye información sobre cómo ver los registros de auditoría, cómo almacenarlos y enrutarlos y más.

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. Filtrar por 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 La propiedad type del permiso necesario para realizar el método. Métodos que requieren un permiso de IAM con el valor de propiedad type de DATA_READ, DATA_WRITE o ADMIN_READ generan los registros de auditoría de acceso a los datos. Métodos que requieren un permiso de IAM con el valor de propiedad type de ADMIN_WRITE generados los registros de auditoría de la 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.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

Registros de auditoría de la interfaz de API

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

google.cloud.iap.v1.IdentityAwareProxyAdminService

En la siguiente sección, se brindan detalles sobre los registros de auditoría 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: Consulta la documentación de IAM para obtener información sobre los permisos.
• 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: Consulta la documentación de IAM para obtener información sobre los permisos.
• 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: Consulta la documentación de IAM para obtener información sobre los permisos.
• 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: acceso a los datos
  
• Permisos:
  • iap.web.updateSettings - ADMIN_WRITE
  • iap.web.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.ValidateIapAttributeExpression"
  

google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1

En la siguiente sección, se brindan detalles sobre los registros de auditoría 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: Consulta la documentación de IAM para obtener información sobre los permisos.
• 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 muestran 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 sin autenticar.
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