Activer les journaux d'audit des accès aux données

Ce guide explique comment activer ou désactiver tout ou partie des journaux d'audit des accès aux données dans vos projets, comptes de facturation, dossiers et organisations Google Cloud à l'aide de la console Google Cloud ou de l'API.

Avant de commencer

Avant de continuer à configurer les journaux d'audit pour l'accès aux données, prenez en compte les informations suivantes:

Important :Le volume des journaux d'audit pour l'accès aux données peut être important. L'activation des journaux d'accès aux données peut entraîner la facturation de l'utilisation de journaux supplémentaires dans votre projet Google Cloud. Pour en savoir plus sur la tarification, consultez la page Tarifs de la suite Operations Google Cloud: Cloud Logging.

Important :Si vous avez configuré les journaux d'accès aux données pour suivre l'accès aux objets. Les téléchargements authentifiés via un navigateur depuis storage.cloud.google.com peuvent renvoyer une réponse 403. Pour résoudre ce problème, consultez le guide de dépannage de Cloud Storage.

• Les journaux d'audit pour l'accès aux données sont désactivés par défaut (sauf dans BigQuery). Si vous souhaitez que les journaux d'audit des accès aux données soient écrits pour les services Google Cloud autres que BigQuery, vous devez les activer explicitement.

• Les journaux d'audit des accès aux données sont stockés dans le bucket _Default, sauf si vous les avez routés ailleurs. Pour en savoir plus, consultez la section Stocker et acheminer les journaux d'audit.

• Les journaux d'audit pour l'accès aux données aident l'assistance Google à résoudre les problèmes liés à votre compte. Par conséquent, nous vous recommandons d'activer les journaux d'audit d'accès aux données lorsque cela est possible.

Présentation de la configuration

Vous pouvez activer et configurer certains aspects des journaux d'audit pour l'accès aux données pour vos ressources et services Google Cloud:

• Organisations: vous pouvez activer et configurer les journaux d'audit des accès aux données dans une organisation, ce qui s'applique à tous les projets et dossiers Google Cloud existants et nouveaux dans l'organisation.

• Dossiers: vous pouvez activer et configurer les journaux d'audit des accès aux données dans un dossier, qui s'applique à tous les projets Google Cloud existants et nouveaux du dossier. Vous ne pouvez pas désactiver un journal d'audit des accès aux données activé dans l'organisation parente du projet.

• Projets: vous pouvez configurer des journaux d'audit des accès aux données pour un projet Google Cloud individuel. Vous ne pouvez pas désactiver un journal d'audit des accès aux données qui a été activé dans une organisation ou un dossier parent.

• Comptes de facturation: pour configurer les journaux d'audit des accès aux données pour les comptes de facturation, utilisez Google Cloud CLI. Pour en savoir plus sur l'utilisation de gcloud CLI avec les journaux d'audit des accès aux données et les comptes de facturation, consultez la documentation de référence sur gcloud beta billing accounts set-iam-policy.

• Configurations par défaut: vous pouvez spécifier une configuration de journal d'audit des accès aux données par défaut dans une organisation, un dossier ou un projet Google Cloud qui s'applique aux futurs services Google Cloud qui commencent à produire des journaux d'audit des accès aux données. Pour obtenir des instructions, consultez Définir la configuration par défaut.

• Services: vous pouvez spécifier les services dont vous souhaitez recevoir les journaux d'audit. Par exemple, pour recevoir des journaux d'audit de Compute Engine, mais pas de Cloud SQL. Pour obtenir la liste des services Google Cloud qui peuvent générer des journaux d'audit, consultez la page Services Google avec journaux d'audit.

• Types de journaux: vous pouvez configurer les types d'opérations enregistrés dans les journaux d'audit des accès aux données. Il existe trois types de journaux d'audit des accès aux données :

  • ADMIN_READ : enregistre les opérations de lecture des métadonnées ou des informations de configuration.

  • DATA_READ : enregistre les opérations de lecture des données fournies par l'utilisateur.

  • DATA_WRITE : enregistre les opérations d'écriture des données fournies par l'utilisateur.

  Par exemple, Cloud DNS écrit les trois types de journaux d'accès aux données, mais vous pouvez configurer vos journaux d'audit des accès aux données de sorte qu'ils n'enregistrent que les opérations DATA_WRITE.

• Comptes principaux exemptés: vous pouvez empêcher l'enregistrement des accès aux données de certains comptes principaux. Par exemple, vous pouvez empêcher vos comptes de test internes d'enregistrer leurs opérations Cloud Monitoring. Pour obtenir la liste des comptes principaux valides, y compris les utilisateurs et les groupes, consultez la documentation de référence sur le type Binding.

Vous pouvez configurer vos journaux d'audit des accès aux données via la page Journaux d'audit d'IAM de la console Google Cloud ou à l'aide de l'API. Ces méthodes sont décrites dans les sections ci-dessous.

Configurations spécifiques aux services

S'il existe à la fois une configuration pour tous les services Google Cloud (allServices) et une configuration pour un service Google Cloud spécifique, la configuration pour le service correspond à l'union des deux configurations. Autrement dit :

• Vous pouvez activer les journaux d'audit pour l'accès aux données pour des services Google Cloud spécifiques, mais vous ne pouvez pas les désactiver pour les services Google Cloud activés dans la configuration globale.

• Vous pouvez ajouter des types d'informations supplémentaires au journal d'audit pour l'accès aux données d'un service Google Cloud, mais vous ne pouvez pas supprimer les types d'informations spécifiés dans la configuration globale.

• Vous pouvez ajouter des comptes principaux à des listes d'exemptions, mais vous ne pouvez pas les supprimer des listes d'exemptions dans la configuration globale.

• Pour le service de transfert de données BigQuery, la configuration des journaux d'audit des accès aux données est héritée de la configuration des journaux d'audit par défaut.

Configurations de ressources Google Cloud

Vous pouvez configurer des journaux d'audit des accès aux données pour les projets, les comptes de facturation, les dossiers et les organisations Google Cloud. S'il existe une configuration pour un service Google Cloud dans la hiérarchie, la configuration obtenue est l'union des configurations. En d'autres termes, au niveau du projet Google Cloud:

• Vous pouvez activer les journaux pour un service Google Cloud, mais vous ne pouvez pas les désactiver pour un service Google Cloud activé dans une organisation ou un dossier parent.

• Vous pouvez activer des types d'informations, mais pas ceux activés dans une organisation ou un dossier parent.

• Vous pouvez ajouter des comptes principaux à des listes d'exemptions, mais vous ne pouvez pas les supprimer des listes d'exemptions d'une organisation ou d'un dossier parent.

• Au niveau d'une organisation parente ou d'un dossier parent, vous pouvez activer les journaux d'audit des accès aux données pour un projet Google Cloud dans cette organisation ou ce dossier, même si les journaux d'audit des accès aux données n'ont pas été configurés dans le projet Google Cloud.

Contrôle des accès

Les rôles et autorisations Identity and Access Management régissent l'accès aux données de Logging, y compris l'affichage et la gestion des stratégies IAM sous-jacentes aux configurations des journaux d'audit pour l'accès aux données.

Pour afficher ou définir les stratégies associées à la configuration de l'accès aux données, vous devez disposer d'un rôle doté d'autorisations au niveau des ressources approprié. Pour savoir comment attribuer ces rôles au niveau des ressources, consultez Gérer l'accès aux projets, aux dossiers et aux organisations Google Cloud.

• Pour définir des stratégies IAM, vous devez disposer d'un rôle doté de l'autorisation resourcemanager.RESOURCE_TYPE.setIamPolicy.

• Pour afficher les stratégies IAM, vous devez disposer d'un rôle doté de l'autorisation resourcemanager.RESOURCE_TYPE.getIamPolicy.

  Important :Lorsque vous affichez les configurations d'accès aux données dans la console Google Cloud au niveau du projet ou du dossier Google Cloud, si vous ne disposez pas de l'autorisation getIamPolicy pour une organisation ou un dossier parent, aucune configuration d'accès aux données présente dans ces entités parentes n'est affichée dans la console Google Cloud. Ces configurations d'accès aux données s'appliquent toujours à tous les appels d'API du projet ou du dossier Google Cloud que vous consultez.

Pour obtenir la liste des autorisations et des rôles dont vous avez besoin pour afficher les journaux d'audit des accès aux données, consultez la page Contrôle des accès avec IAM.

Configurer les journaux d'audit des accès aux données avec la console Google Cloud

Cette section explique comment utiliser la console Google Cloud pour configurer les journaux d'audit des accès aux données.

Vous pouvez également utiliser l'API ou Google Cloud CLI pour effectuer ces tâches de manière automatisée. Pour en savoir plus, consultez la page Configurer les journaux d'audit des accès aux données avec l'API.

Pour accéder aux options de configuration des journaux d'audit dans la console Google Cloud, procédez comme suit:

1. Dans la console Google Cloud, sélectionnez IAM et administration, puis Journaux d'audit ou cliquez sur le bouton suivant:

   Accéder aux journaux d'audit IAM

2. Sélectionnez un projet, une organisation ou un dossier Google Cloud existant.

Activer les journaux d'audit

Pour activer les journaux d'audit des accès aux données, procédez comme suit:

1. Dans le tableau Configuration des journaux d'audit des accès aux données, sélectionnez un ou plusieurs services Google Cloud dans la colonne Service.

2. Dans l'onglet Types de journaux, sélectionnez les types de journaux d'audit des accès aux données que vous souhaitez activer pour les services sélectionnés.

3. Cliquez sur Enregistrer.

Lorsque vous avez activé les journaux d'audit, la table inclut une icône Vérification .

Dans l'exemple suivant, le type de journal d'audit Lecture de données est activé pour le service Access Approval:

Vous pouvez également activer les journaux d'audit pour tous les services Google Cloud qui génèrent des journaux d'audit d'accès aux données. Dans le tableau Configuration des journaux d'audit des accès aux données, sélectionnez tous les services Google Cloud.

Notez que cette méthode de configuration groupée ne s'applique qu'aux services Google Cloud actuellement disponibles pour votre ressource. Si un nouveau service Google Cloud est ajouté, il hérite de la configuration d'audit par défaut.

Désactiver les journaux d'audit pour l'accès aux données

Pour désactiver les journaux d'audit des accès aux données, procédez comme suit:

1. Dans le tableau Configuration des journaux d'audit des accès aux données, sélectionnez un ou plusieurs services Google Cloud.

2. Dans l'onglet Types de journaux du panneau d'informations, sélectionnez les types de journaux d'audit des accès aux données que vous souhaitez désactiver pour les services sélectionnés.

3. Cliquez sur Enregistrer.

Le tableau affiche des tirets lorsque vous avez désactivé les journaux d'audit des accès aux données. Tous les journaux d'audit des accès aux données activés sont signalés par l'icône Vérifier .

Définir des exceptions

Vous pouvez définir des exceptions pour contrôler les comptes principaux qui génèrent des journaux d'audit pour l'accès aux données pour des services particuliers. Lorsque vous ajoutez un compte principal exempté, les journaux d'audit ne sont pas créés pour ces types de journaux.

Attention :Si vous ajoutez un compte principal exempté à un service pour un type de journal d'audit, cela active le type de journal d'audit, même s'il était précédemment désactivé.

Pour définir des exceptions, procédez comme suit:

1. Dans le tableau Configuration des journaux d'audit des accès aux données, sélectionnez un service Google Cloud dans la colonne Service.

2. Sélectionnez l'onglet Comptes principaux exemptés du panneau d'informations.

3. Dans le champ Ajouter un compte principal exempté, saisissez le compte principal pour lequel vous ne souhaitez pas générer de journaux d'audit des accès aux données pour le service sélectionné.

   Pour ajouter plusieurs comptes principaux, cliquez sur le bouton Ajouter un compte principal exempté autant de fois que nécessaire.

   Pour obtenir la liste des comptes principaux valides, y compris les utilisateurs et les groupes, consultez la documentation de référence sur le type Binding.

4. Dans Types de journaux désactivés, sélectionnez les types de journaux d'audit des accès aux données que vous souhaitez désactiver.

5. Cliquez sur Enregistrer.

Lorsque vous avez ajouté des comptes principaux exemptés à un service, le tableau de la configuration des journaux d'audit des accès aux données indique la valeur indiquée dans la colonne Comptes principaux exemptés.

Pour supprimer un compte principal de votre liste d'exemptions, procédez comme suit:

1. Dans le tableau Configuration des journaux d'audit des accès aux données, sélectionnez un service Google Cloud dans la colonne Service.

2. Sélectionnez l'onglet Comptes principaux exemptés du panneau d'informations.

3. Pointez sur le nom d'un compte principal, puis sélectionnez l'icône de suppression qui s'affiche.

4. Une fois que le nom du compte principal s'affiche en texte barré, cliquez sur Enregistrer.

Pour modifier les informations d'un compte principal exempté:

1. Dans le tableau Configuration des journaux d'audit des accès aux données, sélectionnez un service Google Cloud dans la colonne Service.

2. Sélectionnez l'onglet Comptes principaux exemptés du panneau d'informations.

3. Développez en nommage principal.

4. Sélectionnez ou désélectionnez les types de journaux d'audit des accès aux données en fonction du compte principal.

5. Cliquez sur Enregistrer.

Définir la configuration par défaut

Vous pouvez définir une configuration que tous les services Google Cloud nouveaux et existants de votre projet, dossier ou organisation Google héritent. La configuration de cette configuration par défaut s'applique si un nouveau service Google Cloud devient disponible et que les comptes principaux de votre organisation commencent à l'utiliser: le service hérite de la règle de journalisation d'audit que vous avez déjà définie pour d'autres services Google Cloud, garantissant ainsi la capture des journaux d'audit des accès aux données.

Pour définir ou modifier la configuration par défaut:

1. Cliquez sur Définir la configuration par défaut.

2. Dans l'onglet Types de journaux du panneau d'informations, sélectionnez les types de journaux d'audit des accès aux données que vous souhaitez activer ou désactiver.

3. Cliquez sur Enregistrer.

4. Sélectionnez l'onglet Comptes principaux exemptés du panneau d'informations.

5. Dans le champ Ajouter un compte principal exempté, saisissez le compte principal pour lequel vous ne souhaitez pas générer de journaux d'audit des accès aux données pour le service sélectionné.

   Pour ajouter plusieurs comptes principaux, cliquez sur le bouton Ajouter un compte principal exempté autant de fois que nécessaire.

   Pour obtenir la liste des comptes principaux valides, y compris les utilisateurs et les groupes, consultez la documentation de référence sur le type Binding.

6. Dans Types de journaux désactivés, sélectionnez les types de journaux d'audit des accès aux données que vous souhaitez désactiver.

7. Cliquez sur Enregistrer.

Configurer les journaux d'audit pour l'accès aux données à l'aide de l'API

Cette section explique comment utiliser l'API et gcloud CLI pour configurer des journaux d'audit des accès aux données de manière automatisée.

La plupart de ces tâches peuvent également être effectuées via la console Google Cloud. Pour obtenir des instructions, consultez la section Configurer les journaux d'audit des accès aux données avec la console Google Cloud de cette page.

Objets des stratégies IAM

Pour configurer les journaux d'audit des accès aux données à l'aide de l'API, vous devez modifier la stratégie IAM associée à votre projet, dossier ou organisation Google Cloud. La configuration des journaux d'audit se trouve dans la section auditConfigs de la stratégie :

"auditConfigs": [
  {
    object(AuditConfig)
  }
]

Pour en savoir plus, reportez-vous au type de stratégie IAM.

Les sections suivantes décrivent l'objet AuditConfig plus en détail. Pour découvrir les commandes de l'API et de gcloud CLI permettant de modifier la configuration, consultez les méthodes setIamPolicy et setIamPolicy.

AuditConfig objets

La configuration des journaux d'audit consiste en une liste d'objets AuditConfig. Chaque objet configure les journaux pour un service spécifique ou établit une configuration globale applicable à tous les services. Voici à quoi ressemblent les objets :

{
  "service": SERVICE_NAME,
  "auditLogConfigs": [
    {
      "logType": "ADMIN_READ"
      "exemptedMembers": [ PRINCIPAL,]
    },
    {
      "logType": "DATA_READ"
      "exemptedMembers": [ PRINCIPAL,]
    },
    {
      "logType": "DATA_WRITE"
      "exemptedMembers": [ PRINCIPAL,]
    },
  ]
},

SERVICE_NAME a une valeur spécifique comme "appengine.googleapis.com" ou il s'agit de la valeur spéciale "allServices". Si une configuration ne mentionne pas un service spécifique, la configuration globale s'applique. Si aucune configuration n'est définie, les journaux d'audit pour l'accès aux données ne sont pas activés sur le service en question. Pour obtenir la liste des noms de service, consultez la section Services de journalisation.

La section auditLogConfigs de l'objet AuditConfig est une liste de 0 à 3 objets, chacun d'entre eux configurant un type de journal d'audit. Si vous omettez l'un des types de la liste, ce type d'information n'est pas activé pour le service.

PRINCIPAL est un utilisateur pour lequel les journaux d'audit pour l'accès aux données ne sont pas collectés. Le type Binding décrit différents types de comptes principaux, y compris les utilisateurs et les groupes, mais ils ne peuvent pas tous être utilisés pour configurer les journaux d'audit des accès aux données.

Vous trouverez ci-dessous un exemple de configuration d'audit aux formats JSON et YAML. Le format YAML est utilisé par défaut lorsque vous utilisez Google Cloud CLI.

JSON

"auditConfigs": [
  {
    "auditLogConfigs": [
      {
        "logType": "ADMIN_READ"
      },
      {
        "logType": "DATA_WRITE"
      },
      {
        "logType": "DATA_READ"
      }
    ],
    "service": "allServices"
  },
  {
    "auditLogConfigs": [
      {
        "exemptedMembers": [
          "[e-mail]"
        ],
        "logType": "ADMIN_READ"
      }
    ],
    "service": "cloudsql.googleapis.com"
  }
],

YAML

auditConfigs:
- auditLogConfigs:
  - logType: ADMIN_READ
  - logType: DATA_WRITE
  - logType: DATA_READ
  service: allServices
- auditLogConfigs:
  - exemptedMembers:
    - [e-mail]
    logType: ADMIN_READ
  service: cloudsql.googleapis.com

Configurations courantes

Voici quelques configurations courantes de journaux d'audit pour les projets Google Cloud.

Activer tous les journaux d'audit pour l'accès aux données

La section auditConfigs suivante active les journaux d'audit des accès aux données pour tous les services et comptes principaux:

JSON

"auditConfigs": [
      {
        "service": "allServices",
        "auditLogConfigs": [
          { "logType": "ADMIN_READ" },
          { "logType": "DATA_READ"  },
          { "logType": "DATA_WRITE" },
        ]
      },
    ]

YAML

auditConfigs:
- auditLogConfigs:
  - logType: ADMIN_READ
  - logType: DATA_WRITE
  - logType: DATA_READ
  service: allServices

Activer un service et un type d'information

La configuration suivante active les journaux d'audit des accès aux données DATA_WRITE pour Cloud SQL:

JSON

"auditConfigs": [
  {
    "service": "cloudsql.googleapis.com",
    "auditLogConfigs": [
      { "logType": "DATA_WRITE" },
    ]
  },
]

YAML

auditConfigs:
- auditLogConfigs:
  - logType: DATA_WRITE
  service: cloudsql.googleapis.com

Désactiver tous les journaux d'audit pour l'accès aux données

Pour désactiver tous les journaux d'audit des accès aux données (à l'exception de BigQuery) dans un projet Google Cloud, incluez une section auditConfigs: vide dans votre nouvelle stratégie IAM:

JSON

"auditConfigs": [],

YAML

auditConfigs:

Si vous supprimez entièrement la section auditConfigs de votre nouvelle stratégie, alors setIamPolicy ne modifie pas la configuration des journaux d'audit pour l'accès aux données. Pour en savoir plus, consultez la section Masque de mise à jour de la méthode setIamPolicy.

Les journaux d'audit pour l'accès aux données BigQuery ne peuvent pas être désactivés.

getIamPolicy et setIamPolicy

Vous pouvez consulter et écrire votre stratégie IAM à l'aide des méthodes getIamPolicy et setIamPolicy de l'API Resource Manager. Plusieurs options s'offrent à vous :

• L'API Resource Manager propose les méthodes suivantes :

  projects.getIamPolicy
  projects.setIamPolicy
  organizations.getIamPolicy
  organizations.setIamPolicy
  

• Google Cloud CLI propose les commandes Resource Manager suivantes:

  gcloud projects get-iam-policy
  gcloud projects set-iam-policy
  gcloud resource-manager folders get-iam-policy
  gcloud resource-manager folders set-iam-policy
  gcloud organizations get-iam-policy
  gcloud organizations set-iam-policy
  gcloud beta billing accounts get-iam-policy
  gcloud beta billing accounts set-iam-policy
  

Remarque :Lorsque vous appelez projects.getIamPolicy ou projects get-iam-policy, le résultat affiche uniquement les stratégies définies dans le projet Google Cloud, et non les stratégies héritées d'une organisation ou d'un dossier parent.

Quel que soit votre choix, suivez ces trois étapes :

1. Consultez la stratégie actuelle en utilisant l'une des méthodes getIamPolicy. Enregistrez-la dans un fichier temporaire.
2. Modifiez la stratégie dans le fichier temporaire. Ne modifiez (ou n'ajoutez) que la section auditConfigs.
3. Rédigez la stratégie modifiée dans le fichier temporaire à l'aide de l'une des méthodes setIamPolicy.

La méthode setIamPolicy échoue si Resource Manager détecte qu'un autre utilisateur a modifié la stratégie depuis votre dernier accès lors de l'étape 1. Si cela se produit, répétez les trois étapes.

Attention : Votre stratégie IAM modifiée remplace la stratégie actuelle. Si vous modifiez des parties de votre stratégie sans rapport avec les journaux d'audit, votre projet Google Cloud peut devenir inaccessible.

Examples

Les exemples suivants montrent comment configurer les journaux d'audit pour l'accès aux données de votre projet à l'aide de la commande gcloud et de l'API Resource Manager.

Pour configurer les journaux d'audit pour l'accès aux données de votre organisation, remplacez la version "projects" des commandes et méthodes d'API par la version "organizations".

Attention : Suivez attentivement les instructions. Vous allez modifier un objet de stratégie qui contient des informations critiques sur les personnes pouvant accéder à votre ressource. Toute modification accidentelle de ces informations pourrait rendre votre ressource inutilisable.

gcloud

Pour configurer vos journaux d'audit pour l'accès aux données à l'aide de la commande gcloud projects, procédez comme suit :

1. Consultez la stratégie IAM de votre projet et stockez-la dans un fichier :

   gcloud projects get-iam-policy PROJECT_ID > /tmp/policy.yaml
   

   La stratégie renvoyée est présentée ci-dessous. Elle ne comporte pas encore de section auditConfigs:

   bindings:
   - members:
     - user:[e-mail]
     role: roles/editor
   - members:
     - user:[e-mail]
     role: roles/owner
   etag: BwVM-FDzeYM=
   version: 1
   

2. Modifiez votre stratégie dans /tmp/policy.yaml. Vous ne pouvez ajouter ou modifier que la configuration des journaux d'audit pour l'accès aux données.

   Attention : Vous devez conserver les sections bindings: et etag: sans les modifier. Dans le cas contraire, votre projet Google Cloud deviendra inutilisable. Pour en savoir plus, consultez la section Masque de mise à jour de la méthode setIamPolicy sur cette page.

   Vous trouverez ci-dessous un exemple de stratégie modifiée, qui active les journaux d'audit pour l'accès en écriture aux données dans Cloud SQL. Quatre lignes ont été ajoutées au début :

   auditConfigs:
   - auditLogConfigs:
     - logType: DATA_WRITE
     service: cloudsql.googleapis.com
   bindings:
   - members:
     - user:[e-mail]
     role: roles/editor
   - members:
     - user:[e-mail]
     role: roles/owner
   etag: BwVM-FDzeYM=
   version: 1
   

3. Rédigez votre nouvelle stratégie IAM :

   gcloud projects set-iam-policy PROJECT_ID /tmp/policy.yaml
   

   Si la commande précédente signale un conflit avec une autre modification, répétez ces étapes depuis le début.

JSON

Pour exploiter votre stratégie IAM au format JSON au lieu de YAML, utilisez les commandes gcloud suivantes dans l'exemple :

gcloud projects get-iam-policy PROJECT_ID --format=json >/tmp/policy.json
gcloud projects set-iam-policy PROJECT_ID /tmp/policy.json

API

Pour configurer les journaux d'audit pour l'accès aux données à l'aide de l'API Resource Manager, procédez comme suit :

1. Consultez la stratégie IAM de votre projet en spécifiant les paramètres suivants dans la méthode d'API getIamPolicy :

   • resource : projects/PROJECT_ID
   • Corps de la requête : empty

   La méthode renvoie l'objet de la stratégie actuelle décrit ci-dessous. La stratégie de ce projet ne comporte pas encore de section auditConfigs:

   {
     "version": 1,
     "etag": "BwXqwxkr40M=",
     "bindings": [
       {
         "role": "roles/owner",
         "members": [
           "user:[e-mail]"
         ]
       }
     ]
   }
   

2. Modifiez la stratégie actuelle :

   • Modifiez ou ajoutez la section auditConfigs.

     Pour désactiver vos journaux d'audit pour l'accès aux données, indiquez une valeur vide pour la section : auditConfigs:[].

   • Conservez la valeur de etag.

   Vous pouvez également supprimer toutes les autres informations du nouvel objet de stratégie, à condition de définir updateMask à l'étape suivante. La stratégie modifiée, qui active les journaux d'audit d'écriture de données dans Cloud SQL, est décrite ci-dessous :

   {
     "policy": {
       "auditConfigs": [
         {
           "auditLogConfigs": [
             {
               "logType": "DATA_WRITE"
             }
           ],
           "service": "cloudsql.googleapis.com"
         }
       ],
       "etag": "BwXqwxkr40M="
     },
     "updateMask": "auditConfigs,etag"
   }
   

3. Rédigez la nouvelle stratégie à l'aide de la méthode d'API setIamPolicy, en spécifiant les paramètres suivants :

   • resource : projects/PROJECT_ID
   • Corps de la requête: inclut la stratégie modifiée.

Attention : Vous devez spécifier le paramètre updateMask comme indiqué. Si vous ne spécifiez pas updateMask, vous risquez de perdre tout accès à votre projet Google Cloud. Pour en savoir plus, consultez la section Masque de mise à jour de la méthode setIamPolicy.

Masque de mise à jour setIamPolicy

Cette section explique l'importance du paramètre updateMask dans la méthode setIamPolicy et explique pourquoi vous devez utiliser la commande set-iam-policy de gcloud CLI pour ne pas causer de dommages accidentels sur votre projet ou votre organisation Google Cloud.

La méthode setIamPolicy API method utilise un paramètre updateMask pour contrôler les champs de stratégie mis à jour. Par exemple, si le masque ne contient pas de section bindings, vous ne pouvez pas modifier accidentellement cette section de la stratégie. En revanche, si le masque contient une section bindings, celle-ci est systématiquement mise à jour. Si vous n'incluez pas de valeur à jour pour bindings, cette section est entièrement supprimée de la stratégie.

La commande gcloud projects set-iam-policy, qui appelle setIamPolicy, ne vous permet pas de spécifier le paramètre updateMask. À la place, la commande calcule une valeur pour updateMask de la façon suivante :

• Le paramètre updateMask contient toujours les champs bindings et etag.
• Si l'objet de stratégie fourni dans set-iam-policy contient d'autres champs de premier niveau, tels que auditConfigs, ces champs sont ajoutés à updateMask.

Compte tenu de ces règles, la commande set-iam-policy présente les comportements suivants :

• Si vous omettez la section auditConfigs dans votre nouvelle stratégie, la valeur précédente de la section auditConfigs (le cas échéant) n'est pas modifiée, car cette section ne se trouve pas dans le masque de mise à jour. Cela n'a aucune incidence, mais cela peut porter à confusion.

• Si vous omettez bindings dans votre nouvel objet de stratégie, la section bindings est supprimée de votre stratégie, car elle apparaît dans le masque de mise à jour. Cela est très dangereux et entraîne la perte d'accès de tous les comptes principaux à votre projet Google Cloud.

• Si vous omettez etag dans votre nouvel objet de stratégie, la vérification des modifications simultanées apportées à votre stratégie est désactivée. Cela peut entraîner l'écrasement accidentel des modifications effectuées par un autre utilisateur.