Journal d'audit Identity-Aware Proxy

Cloud Audit Logs pour Identity-Aware Proxy vous permettent de suivre les opérations d'administration et d'accès aux données sur vos ressources afin de vous aider à surveiller les accès et les modifications de configuration. Vous pouvez interroger ces journaux dans l'explorateur de journaux et vérifier quelles méthodes de l'API Identity-Aware Proxy génèrent des journaux Cloud Audit Logs.

Pour en savoir plus sur Cloud Audit Logs, consultez les documents suivants :

Remarques

La section "Champs" décrit des détails importants sur certains champs du journal d'audit.

Nom du service

Pour afficher les journaux d'audit Identity-Aware Proxy, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Explorateur de journaux.

    Accéder à l'explorateur de journaux

  2. Copiez et collez la requête suivante dans le champ Requête de l'explorateur de journaux, puis cliquez sur Exécuter la requête.

        protoPayload.serviceName="iap.googleapis.com"

Méthodes par type d'autorisation

Chaque autorisation IAM possède une propriété type, dont la valeur est une énumération. Il peut s'agir de l'une des quatre valeurs suivantes : ADMIN_READ, ADMIN_WRITE, DATA_READ ou DATA_WRITE. Lorsque vous appelez une méthode, Identity-Aware Proxy génère un journal d'audit dont la catégorie dépend de la propriété type de l'autorisation requise pour exécuter la méthode. Les méthodes nécessitant une autorisation IAM avec la valeur de la propriété type de DATA_READ, DATA_WRITE ou ADMIN_READ génèrent des journaux d'audit des accès aux données. Les méthodes nécessitant une autorisation IAM avec la valeur de propriété type de ADMIN_WRITE génèrent des journaux d'audit pour les activités d'administration.

Les méthodes d'API de la liste suivante marquées (LRO) sont des opérations de longue durée (LRO, Long-running operations). Ces méthodes génèrent généralement deux entrées de journal d'audit : une au début de l'opération et une autre à la fin. Pour en savoir plus, consultez Journaux d'audit pour les opérations de longue durée.
Type d'autorisation Méthodes
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

Journaux d'audit d'interface API

Pour en savoir plus sur la manière dont les autorisations sont évaluées, pour chaque méthode, consultez la documentation Identity and Access Management pour Identity-Aware Proxy.

google.cloud.iap.v1.IdentityAwareProxyAdminService

Les journaux d'audit suivants sont associés aux méthodes appartenant à google.cloud.iap.v1.IdentityAwareProxyAdminService.

CreateTunnelDestGroup

  • Méthode : google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • iap.tunnelDestGroups.create - DATA_WRITE
  • La méthode est une opération de longue durée ou en flux continu : Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup"

DeleteTunnelDestGroup

  • Méthode : google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • iap.tunnelDestGroups.delete - DATA_WRITE
  • La méthode est une opération de longue durée ou en flux continu : Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup"

GetIamPolicy

  • Méthode : google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • iap.tunnelServices.getIamPolicy - ADMIN_READ
    • iap.web.getIamPolicy - ADMIN_READ
    • iap.webServices.getIamPolicy - ADMIN_READ
    • iap.webTypes.getIamPolicy - ADMIN_READ
  • La méthode est une opération de longue durée ou en flux continu : Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy"

GetIapSettings

  • Méthode : google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • 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
  • La méthode est une opération de longue durée ou en flux continu : Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings"

GetTunnelDestGroup

  • Méthode : google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • iap.tunnelDestGroups.get - DATA_READ
  • La méthode est une opération de longue durée ou en flux continu : Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup"

ListTunnelDestGroups

  • Méthode : google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • iap.tunnelDestGroups.list - DATA_READ
  • La méthode est une opération de longue durée ou en flux continu : Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups"

SetIamPolicy

  • Méthode : google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy
  • Type de journaux d'audit : journaux d'audit des activités d'administration
  • Autorisations :
    • iap.tunnelServices.setIamPolicy - ADMIN_WRITE
    • iap.web.setIamPolicy - ADMIN_WRITE
    • iap.webServices.setIamPolicy - ADMIN_WRITE
    • iap.webTypes.setIamPolicy - ADMIN_WRITE
  • La méthode est une opération de longue durée ou en flux continu : Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy"

UpdateIapSettings

  • Méthode : google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • iap.projects.updateSettings - DATA_WRITE
    • iap.web.updateSettings - DATA_WRITE
    • iap.webServiceVersions.updateSettings - DATA_WRITE
    • iap.webServices.updateSettings - DATA_WRITE
    • iap.webTypes.updateSettings - DATA_WRITE
  • La méthode est une opération de longue durée ou en flux continu : Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings"

UpdateTunnelDestGroup

  • Méthode : google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • iap.tunnelDestGroups.update - DATA_WRITE
  • La méthode est une opération de longue durée ou en flux continu : Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup"

ValidateIapAttributeExpression

  • Méthode : google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • iap.projects.updateSettings - DATA_WRITE
    • iap.web.updateSettings - DATA_WRITE
    • iap.webServices.updateSettings - DATA_WRITE
  • La méthode est une opération de longue durée ou en flux continu : Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression"

google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1

Les journaux d'audit suivants sont associés aux méthodes appartenant à google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.

GetIamPolicy

  • Méthode : google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy
  • Type de journaux d'audit : journaux d'audit des accès aux données
  • Autorisations :
    • iap.tunnelServices.getIamPolicy - ADMIN_READ
    • iap.web.getIamPolicy - ADMIN_READ
    • iap.webServiceVersions.getIamPolicy - ADMIN_READ
    • iap.webServices.getIamPolicy - ADMIN_READ
    • iap.webTypes.getIamPolicy - ADMIN_READ
  • La méthode est une opération de longue durée ou en flux continu : Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy"

SetIamPolicy

  • Méthode : google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy
  • Type de journaux d'audit : journaux d'audit des activités d'administration
  • Autorisations :
    • iap.tunnelServices.setIamPolicy - ADMIN_WRITE
    • iap.webServiceVersions.setIamPolicy - ADMIN_WRITE
    • iap.webServices.setIamPolicy - ADMIN_WRITE
    • iap.webTypes.setIamPolicy - ADMIN_WRITE
  • La méthode est une opération de longue durée ou en flux continu : Non.
  • Filtre pour cette méthode : protoPayload.methodName="google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy"

Méthodes ne produisant pas de journaux d'audit

Il est possible qu'une méthode ne produise pas de journaux d'audit pour une ou plusieurs des raisons suivantes :

  • Il s'agit d'une méthode à volume élevé impliquant des coûts significatifs de génération de journaux et de stockage.
  • Sa valeur d'audit est faible.
  • Un autre journal d'audit ou de plate-forme couvre déjà cette méthode.

Les méthodes suivantes ne génèrent pas de journaux d'audit :

  • 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

Champs

Les journaux ne contiennent que des informations sur les niveaux d'accès qu'un utilisateur a atteints. Les niveaux d'accès ayant bloqué une requête non autorisée ne sont pas répertoriés dans l'entrée de journal. Pour déterminer les conditions nécessaires à la réussite d'une requête pour une ressource donnée, vérifiez les niveaux d'accès de cette ressource.

Voici quelques informations importantes sur certains champs du journal :

Champ Value
authenticationInfo Adresse e-mail de l'utilisateur qui a tenté d'accéder à la ressource (principalEmail). Ces informations ne sont pas présentes dans les journaux des requêtes non authentifiées.
requestMetadata.callerIp Adresse IP d'origine de la requête.
requestMetadata.requestAttributes Méthode de la requête et URL.
authorizationInfo.resource Ressource concernée par l'accès.
authorizationInfo.granted Valeur booléenne indiquant si IAP a autorisé ou non l'accès demandé.