Modifier les stratégies d'accès unifiées

Les stratégies d'accès unifiées (UAP) vous permettent d'accorder et de refuser l'accès des comptes principaux aux ressourcesGoogle Cloud . Ce document explique comment modifier les règles d'accès des utilisateurs existantes et les ressources auxquelles elles s'appliquent.

Avant de commencer

  1. Configurez l'authentification.

    Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

    Console

    Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud , vous n'avez pas besoin de configurer l'authentification.

    gcloud

    Dans la console Google Cloud , activez Cloud Shell.

    Activer Cloud Shell

    En bas de la console Google Cloud , une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement de shell dans lequel la Google Cloud CLI est déjà installée, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.

    REST

    Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.

      Installez la Google Cloud CLI.

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

    Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud .

  2. Vérifiez que la facturation est activée pour votre projet Google Cloud .

  3. Facultatif. Consultez la présentation des règles d'accès utilisateur.

Rôles requis

Pour obtenir les autorisations nécessaires pour modifier des UAP, demandez à votre administrateur de vous accorder le rôle IAM Administrateur des règles d'accès (roles/iam.accessPolicyAdmin) sur le projet, le dossier ou l'organisation propriétaire de l'UAP que vous souhaitez modifier. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour modifier les règles d'accès des utilisateurs. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour modifier les règles d'accès utilisateur :

  • iam.accesspolicies.update
  • Modifiez les règles d'accès utilisateur dans la console Google Cloud  :
    • iam.accesspolicies.get
    • iam.accessPolicies.list

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Modifier une stratégie d'accès unifiée existante

Vous pouvez modifier une UAP pour mettre à jour son nom à afficher ou ses règles.

Vous pouvez modifier une stratégie d'accès utilisateur à l'aide de la console Google Cloud , de la gcloud CLI ou de l'API REST IAM.

Console

  1. Dans la console Google Cloud , accédez à la page Stratégies d'accès unifiées.

    Accéder à la page "Stratégies d'accès unifiées"
  2. Sélectionnez le projet, le dossier ou l'organisation propriétaire de la règle d'accès utilisateur que vous souhaitez modifier.
  3. Cliquez sur l'ID de la règle UAP que vous souhaitez modifier.
  4. Pour ajouter des règles, cliquez sur Ajouter une règle, puis ajoutez les détails de la règle. Pour enregistrer la règle, cliquez sur Ajouter une règle.

    Pour en savoir plus sur les champs d'une règle, consultez Créer une règle d'accès utilisateur.

  5. Pour modifier d'autres champs de la règle d'accès utilisateur, cliquez sur Modifier la règle.
  6. Modifiez l'un des champs suivants :

    • Nom de la règle : saisissez un nouveau nom à afficher pour l'UAP.
    • Règles : mettez à jour, ajoutez ou supprimez des règles dans l'UAP.
  7. Lorsque vous avez terminé de modifier l'UAP, cliquez sur Mettre à jour la règle.

gcloud

La commande gcloud iam access-policies update met à jour une stratégie d'accès utilisateur existante.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • UAP_ID : ID de la stratégie d'accès utilisateur que vous souhaitez mettre à jour (par exemple, example-policy).
  • UAP_PARENT_RESOURCE_TYPE : type de la ressource Resource Manager (projet, dossier ou organisation) propriétaire de l'UAP que vous souhaitez mettre à jour. Utilisez la valeur project, folder ou organization.
  • UAP_PARENT_RESOURCE_ID : ID du projet, du dossier ou de l'organisation propriétaire de la stratégie d'accès utilisateur que vous souhaitez mettre à jour. Les ID de projet sont des chaînes alphanumériques, telles que my-project. Les ID de dossier et d'organisation sont numériques, tels que 123456789012.
  • FIELD_TO_UPDATE=UPDATED_VALUE : champs que vous souhaitez mettre à jour et valeur mise à jour correspondante.

    Voici des exemples d'indicateurs que vous pouvez utiliser pour mettre à jour les champs de la règle :

    • --display-name=DISPLAY_NAME : remplacez le nom à afficher de la règle d'accès utilisateur par le nom spécifié.
    • --details-rules=RULES_FILE : remplacez les règles UAP par les règles du fichier spécifié. Chaque règle du fichier doit avoir le format suivant :

      {
        "description": "DESCRIPTION",
        "effect": "EFFECT",
        "principals": [
          INCLUDED_PRINCIPALS
        ],
        "excludedPrincipals": [
          EXCLUDED_PRINCIPALS
        ],
        "operation": {
          "permissions": [
            INCLUDED_PERMISSIONS
          ],
          "excludedPermissions": [
            EXCLUDED_PERMISSIONS
          ]
        },
        CONDITIONS
      }

      Remplacez les valeurs suivantes :

      • DESCRIPTION : description de la règle dans un format lisible par l'humain.
      • EFFECT : impact de la règle sur l'accès. Les valeurs acceptées sont ALLOW et DENY :

        • ALLOW : accorde les autorisations spécifiées aux comptes principaux spécifiés.
        • DENY : empêche les comptes principaux spécifiés d'utiliser les autorisations spécifiées.
      • Remplacez les valeurs suivantes pour spécifier les comptes principaux inclus dans la règle :

        • INCLUDED_PRINCIPALS : comptes principaux à inclure dans la règle.
        • EXCLUDED_PRINCIPALS : facultatif. Comptes principaux à exclure de la règle, même s'ils figurent dans la liste des comptes principaux inclus. Par exemple, vous pouvez ajouter un groupe Google à la liste des comptes principaux inclus, puis exclure des utilisateurs spécifiques appartenant à ce groupe.

        Pour obtenir la liste des identifiants de comptes principaux compatibles, consultez Types de comptes principaux pour les UAP.

      • Remplacez les valeurs suivantes pour spécifier les autorisations à inclure dans la règle :

        • INCLUDED_PERMISSIONS : autorisations à inclure dans la règle.
        • EXCLUDED_PERMISSIONS : facultatif. Autorisations à exclure de la règle, même si elles figurent dans la liste des autorisations incluses. Par exemple, vous pouvez ajouter un rôle à la liste des autorisations incluses, puis exclure des autorisations spécifiques de ce rôle.

        Lorsque vous créez ces listes d'autorisations, vous pouvez référencer des noms d'autorisations, des noms de rôles et des groupes d'autorisations. Pour en savoir plus, consultez Rôles et autorisations dans les règles UAP.

      • CONDITIONS : facultatif. Conditions dans lesquelles la règle s'applique. Utilisez le format suivant :

        "conditions": {
          "SERVICE": {
            "title": "CONDITION_TITLE",
            "description": "CONDITION_DESCRIPTION",
            "expression": "CONDITION_EXPRESSION"
          }
        }
            

        Remplacez les valeurs suivantes :

        • SERVICE : service qui fournit les attributs utilisés dans l'expression de condition.
        • CONDITION_TITLE : facultatif. Un bref résumé de l'objectif de la condition.
        • CONDITION_DESCRIPTION : facultatif. Une description plus longue de la condition.
        • CONDITION_EXPRESSION : expression booléenne faisant référence aux attributs de la tentative d'accès, tels que les tags associés à la ressource dans la tentative d'accès. Si l'expression renvoie true, la règle s'applique à la tentative d'accès. Si elle renvoie false, la règle ne s'applique pas à la tentative d'accès.

        Pour obtenir la liste des attributs compatibles et de leurs services, consultez Attributs de condition compatibles.

    • --add-details-rules=RULES_FILE : ajoutez les règles du fichier spécifié aux règles existantes de l'UAP.

    • --remove-details-rules=RULES_FILE : supprimez les règles du fichier spécifié des règles existantes de la stratégie d'accès utilisateur. Seules les règles qui correspondent exactement à l'une des règles du fichier spécifié sont supprimées.

    • --clear-details-rules : effacer toutes les règles de la stratégie d'accès des comptes principaux.

    Pour obtenir la liste complète des indicateurs que vous pouvez utiliser pour mettre à jour une UAP, consultez la documentation de référence de la commande gcloud iam access-policies update. Certaines options s'excluent mutuellement.

  • FORMAT : format de la réponse. Utilisez json ou yaml.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud iam access-policies update UAP_ID \
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \
    --location=global --FIELD_TO_UPDATE=UPDATED_VALUE \
    --format=FORMAT

Windows (PowerShell)

gcloud iam access-policies update UAP_ID `
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID `
    --location=global --FIELD_TO_UPDATE=UPDATED_VALUE `
    --format=FORMAT

Windows (cmd.exe)

gcloud iam access-policies update UAP_ID ^
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^
    --location=global --FIELD_TO_UPDATE=UPDATED_VALUE ^
    --format=FORMAT

La réponse contient une opération de longue durée représentant votre requête. Une fois l'opération terminée, la réponse affiche l'UAP mise à jour.

Request issued for: [example-policy]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374208720-6181fae5e2034-2d8a712b-5c92e5b9] to complete...done.
Updated accessPolicy [example-policy].
{
  "createTime": "2026-08-31T21:43:39.822441Z",
  "details": {
    "rules": [
      {
        "conditions": {
          "iam.googleapis.com": {
            "expression": "resource.matchTag('environment', 'prod')"
          }
        },
        "description": "Grant non-delete compute permissions to compute admins in prod",
        "effect": "ALLOW",
        "excludedPrincipals": [
          "principal://goog/subject/access-restricted@example.com"
        ],
        "operation": {
          "excludedPermissions": [
            "*/*.delete"
          ],
          "permissions": [
            "role:roles/compute.admin"
          ]
        },
        "principals": [
          "principalSet://goog/group/compute-admins@example.com"
        ]
      }
    ]
  },
  "displayName": "Updated display name",
  "etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
  "name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
  "uid": "puid_0123456789012345678",
  "updateTime": "2026-08-31T21:43:39.822441Z"
}

REST

La méthode accessPolicies.patch met à jour une stratégie d'accès utilisateur existante.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • UAP_PARENT_RESOURCE_TYPE : type de la ressource Resource Manager (projet, dossier ou organisation) propriétaire de l'UAP que vous souhaitez mettre à jour. Utilisez la valeur projects, folders ou organizations.
  • UAP_PARENT_RESOURCE_ID : ID du projet, du dossier ou de l'organisation propriétaire de la stratégie d'accès utilisateur que vous souhaitez mettre à jour. Les ID de projet sont des chaînes alphanumériques, telles que my-project. Les ID de dossier et d'organisation sont numériques, tels que 123456789012.
  • UAP_ID : ID de la stratégie d'accès utilisateur que vous souhaitez mettre à jour (par exemple, example-policy).
  • DISPLAY_NAME : facultatif. Description lisible par l'humain de la stratégie d'accès des utilisateurs (par exemple, Example policy). Le nom à afficher ne peut pas comporter plus de 63 caractères.
  • UAP_RULES : liste de règles UAP, qui définissent l'accès à accorder ou à refuser, ainsi que les comptes principaux auxquels accorder ou refuser l'accès. Un UAP peut comporter jusqu'à 100 règles. Chaque règle a le format suivant :

    {
      "description": "DESCRIPTION",
      "effect": "EFFECT",
      "principals": [
        INCLUDED_PRINCIPALS
      ],
      "excludedPrincipals": [
        EXCLUDED_PRINCIPALS
      ],
      "operation": {
        "permissions": [
          INCLUDED_PERMISSIONS
        ],
        "excludedPermissions": [
          EXCLUDED_PERMISSIONS
        ]
      },
      CONDITIONS
    }

    Remplacez les valeurs suivantes :

    • DESCRIPTION : description de la règle dans un format lisible par l'humain.
    • EFFECT : impact de la règle sur l'accès. Les valeurs acceptées sont ALLOW et DENY :

      • ALLOW : accorde les autorisations spécifiées aux comptes principaux spécifiés.
      • DENY : empêche les comptes principaux spécifiés d'utiliser les autorisations spécifiées.
    • Remplacez les valeurs suivantes pour spécifier les comptes principaux inclus dans la règle :

      • INCLUDED_PRINCIPALS : comptes principaux à inclure dans la règle.
      • EXCLUDED_PRINCIPALS : facultatif. Comptes principaux à exclure de la règle, même s'ils figurent dans la liste des comptes principaux inclus. Par exemple, vous pouvez ajouter un groupe Google à la liste des comptes principaux inclus, puis exclure des utilisateurs spécifiques appartenant à ce groupe.

      Pour obtenir la liste des identifiants de comptes principaux compatibles, consultez Types de comptes principaux pour les UAP.

    • Remplacez les valeurs suivantes pour spécifier les autorisations à inclure dans la règle :

      • INCLUDED_PERMISSIONS : autorisations à inclure dans la règle.
      • EXCLUDED_PERMISSIONS : facultatif. Autorisations à exclure de la règle, même si elles figurent dans la liste des autorisations incluses. Par exemple, vous pouvez ajouter un rôle à la liste des autorisations incluses, puis exclure des autorisations spécifiques de ce rôle.

      Lorsque vous créez ces listes d'autorisations, vous pouvez référencer des noms d'autorisations, des noms de rôles et des groupes d'autorisations. Pour en savoir plus, consultez Rôles et autorisations dans les règles UAP.

    • CONDITIONS : facultatif. Conditions dans lesquelles la règle s'applique. Utilisez le format suivant :

      "conditions": {
        "SERVICE": {
          "title": "CONDITION_TITLE",
          "description": "CONDITION_DESCRIPTION",
          "expression": "CONDITION_EXPRESSION"
        }
      }
          

      Remplacez les valeurs suivantes :

      • SERVICE : service qui fournit les attributs utilisés dans l'expression de condition.
      • CONDITION_TITLE : facultatif. Un bref résumé de l'objectif de la condition.
      • CONDITION_DESCRIPTION : facultatif. Une description plus longue de la condition.
      • CONDITION_EXPRESSION : expression booléenne faisant référence aux attributs de la tentative d'accès, tels que les tags associés à la ressource dans la tentative d'accès. Si l'expression renvoie true, la règle s'applique à la tentative d'accès. Si elle renvoie false, la règle ne s'applique pas à la tentative d'accès.

      Pour obtenir la liste des attributs compatibles et de leurs services, consultez Attributs de condition compatibles.

Méthode HTTP et URL :

PATCH https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID

Corps JSON de la requête :

{
  "displayName": "DISPLAY_NAME",
  "details": {
    "rules": [
      UAP_RULES
    ]
  }
}

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse contient une opération de longue durée représentant votre requête. Pour savoir comment obtenir l'état d'une opération de longue durée, consultez la section Vérifier l'état d'une opération de longue durée sur cette page.

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715626721931-6185a7953ef76-76f80ee4-19cd1bf7",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2026-05-13T18:58:43.721277235Z",
    "target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

Modifier les ressources auxquelles la règle s'applique

Une fois que vous avez créé une liaison pour une UAP, vous ne pouvez plus modifier l'ID de la stratégie ni la ressource dans la liaison. Par conséquent, si vous souhaitez modifier la ressource à laquelle une UAP s'applique, vous devez effectuer l'une des opérations suivantes :

  • Pour appliquer la stratégie d'accès utilisateur à une autre ressource, créez une liaison qui lie la stratégie d'accès utilisateur à cette ressource.
  • Pour supprimer une stratégie d'accès utilisateur d'une ressource, supprimez la liaison qui lie la stratégie d'accès utilisateur à la ressource.

Vérifier l'état d'une opération de longue durée

Lorsque vous utilisez l'API REST ou les bibliothèques clientes, toute méthode modifiant une stratégie ou une liaison renvoie une opération de longue durée (LRO). L'opération de longue durée suit l'état de la requête et indique si la modification de la stratégie ou de la liaison est terminée.

REST

La méthode operations.get renvoie l'état d'une opération de longue durée.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • OPERATION_NAME : nom complet de l'opération. Vous recevez ce nom dans la réponse à votre requête d'origine.

    Le nom de l'opération est au format suivant :

    RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
        

Méthode HTTP et URL :

GET https://iam.googleapis.com/v3/OPERATION_NAME

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "organizations/314340013352/locations/global/operations/operation-1732752311821-627edd607a3df-9a62cdea-2a7d9f07",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-11-28T00:05:12.006289686Z",
    "endTime": "2024-11-28T00:05:12.192141801Z",
    "target": "organizations/314340013352/locations/global/POLICY_TYPE/POLICY_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": true,
  "response": {
    POLICY
  }
}

Si le champ done de l'opération n'est pas présent, continuez à surveiller son état en récupérant l'opération de manière répétée. Utilisez une temporisation de retransmission exponentielle tronquée pour introduire un délai entre chaque requête. Lorsque le champ done est défini sur true, l'opération est terminée et vous pouvez cesser de l'obtenir.

Étapes suivantes