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 aux ressourcesGoogle Cloud . Contrairement aux stratégies d'autorisation et de refus, les PAU vous permettent d'accorder et de refuser l'accès dans la même stratégie, ce qui simplifie la gestion des stratégies. Les règles d'accès utilisateur sont également réutilisables, ce qui signifie que vous pouvez appliquer la même règle d'accès utilisateur à plusieurs ressources.

Fonctionnement des stratégies d'accès unifiées

Pour accorder ou refuser l'accès dans IAM, vous devez spécifier qui doit être autorisé ou non à faire quoi sur quelle ressource.

Dans les UAP, vous spécifiez qui doit être autorisé ou non à faire quoi en créant des règles UAP. Chaque règle liste un ensemble de comptes principaux, un ensemble de rôles et d'autorisations, et un effet. L'effet (autorisation ou refus) spécifie si les comptes principaux listés se voient accorder les rôles et les autorisations de la règle, ou s'ils ne peuvent pas utiliser les autorisations de la règle. Vous pouvez avoir jusqu'à 100 règles dans une même UAP.

Pour spécifier à quelle ressource une UAP contrôle l'accès, vous utilisez une liaison d'UAP pour lier l'UAP à une ressource. Vous pouvez lier une seule UAP à cinq ressources au maximum. Une même ressource peut être associée à cinq stratégies au maximum.

Cas d'utilisation

Dans IAM, vous pouvez utiliser plusieurs types de stratégies pour autoriser et refuser l'accès :

Si vous utilisez déjà des stratégies d'autorisation ou de refus pour contrôler l'accès, nous vous recommandons de continuer à les utiliser. Ces types de stratégies sont également compatibles avec Policy Troubleshooter, ce qui permet de comprendre plus facilement la cause principale des erreurs d'accès.

Utilisez les UAP dans les cas suivants :

  • Vous configurez une nouvelle organisation et prévoyez d'utiliser des règles d'accès utilisateur pour contrôler l'accès dans l'ensemble de votre organisation.
  • Vous souhaitez configurer un contrôle ultraprécis des accès à l'aide de conditions UAP.

Règles de stratégie d'accès unifiée

Les règles d'accès utilisateur sont composées de règles d'autorisation et de refus. Ces règles contiennent les composants suivants :

  • Un effet : indique si la règle accorde ou refuse l'accès. Les règles qui accordent l'accès sont appelées règles d'autorisation. Les règles qui refusent l'accès sont appelées règles de refus.

  • Un ensemble de comptes principaux : les comptes principaux (par exemple, des utilisateurs, des groupes ou des comptes de service) que vous souhaitez inclure dans la règle. Dans les règles d'autorisation, ces comptes principaux se voient accorder l'accès. Dans les règles de refus, l'accès est refusé à ces comptes principaux.

  • Une liste de rôles et d'autorisations : les rôles et les autorisations que vous souhaitez inclure dans la règle. Dans les règles d'autorisation, ces autorisations sont accordées. Dans les règles de refus, ces autorisations sont refusées.

  • Facultatif : expression de condition : expression de conditions IAM spécifiant les conditions qui doivent être remplies pour que la règle s'applique. Pour en savoir plus, consultez la section Conditions dans les UAP sur cette page.

Comptes principaux dans les règles de stratégie d'accès unifiée

Pour spécifier les comptes principaux que vous souhaitez inclure dans la règle, définissez les éléments suivants :

  • Comptes principaux inclus : comptes principaux que vous souhaitez inclure dans la règle.
  • Comptes principaux exclus : comptes principaux que vous souhaitez exclure de la règle, même s'ils font partie d'un groupe de la liste des comptes principaux inclus.

Ces deux listes vous permettent de spécifier de manière concise les comptes principaux que vous souhaitez inclure dans la règle. Par exemple, imaginons que vous créez une règle d'autorisation pour accorder l'accès aux utilisateurs de example.com. Si vous souhaitez accorder l'accès à tous les membres du groupe all@example.com, à l'exception de l'utilisateur reduced-access@example.com, vous devez ajouter all@example.com à la liste des comptes principaux inclus et reduced-access@example.com à la liste des comptes principaux exclus.

Rôles et autorisations dans les règles de stratégie d'accès unifiée

Pour créer une liste exacte des autorisations que vous souhaitez inclure dans la règle, définissez les éléments suivants :

  • Autorisations incluses : autorisations que vous souhaitez inclure dans la règle.
  • Autorisations exclues : autorisations que vous ne souhaitez pas inclure dans la règle, même si elles se trouvent dans un rôle ou un groupe d'autorisations de la liste des autorisations incluses.

Pour ajouter des autorisations à la liste des autorisations incluses ou exclues, vous pouvez référencer l'un des éléments suivants :

  • Autorisations : noms d'autorisations individuels au format de nom de domaine complet (FQDN). Exemple : cloudresourcemanager.googleapis.com/projects.get.

  • Rôles (règles d'autorisation uniquement) : noms de rôles prédéfinis, tels que roles/logging.logsViewer. Si vous incluez un nom de rôle dans une règle, celle-ci inclut toutes les autorisations de ce rôle. Pour afficher toutes les autorisations d'un rôle, consultez la documentation de référence sur les rôles et les autorisations.

    Dans le fichier JSON UAP, ces noms sont toujours précédés de role: (par exemple, role:roles/logging.logsViewer).

    Les rôles ne sont autorisés que dans les règles d'autorisation. Les rôles personnalisés ne sont compatibles avec aucune règle.

  • Groupes d'autorisations : ensembles d'autorisations, tels que aiplatform.googleapis.com/*.*. Les groupes d'autorisations sont des ensembles d'autorisations qui correspondent à un modèle spécifié. Il existe certaines restrictions concernant les groupes d'autorisations que vous pouvez référencer et les autorisations incluses dans ces groupes. Pour en savoir plus, consultez la section Groupes d'autorisations sur cette page.

Groupes d'autorisations

Les groupes d'autorisations sont des ensembles d'autorisations qui correspondent à un modèle spécifié. Vous pouvez utiliser un groupe d'autorisations pour accorder ou refuser des ensembles d'autorisations associées. Par exemple, vous pouvez refuser toutes les autorisations pour un seul service ou accorder toutes les autorisations qui se terminent par un certain verbe.

Les groupes d'autorisations fonctionnent différemment dans les règles d'autorisation et de refus. Les sections suivantes expliquent comment utiliser des groupes d'autorisations dans chaque type de règle.

Groupes d'autorisations dans les règles d'autorisation

Pour identifier un groupe d'autorisations dans une règle d'autorisation, remplacez une ou plusieurs sections d'un nom d'autorisation par un caractère générique (*). Les autorisations incluses dans chaque groupe dépendent de la position du caractère générique :

  • SERVICE_FQDN/RESOURCE.* : inclut toutes les autorisations pour la ressource spécifiée.
  • SERVICE_FQDN/*.* : inclut toutes les autorisations pour le service spécifié.
  • SERVICE_FQDN/*.VERB : inclut toutes les autorisations pour un service qui se termine par le verbe spécifié.
  • */*.VERB : inclut toutes les autorisations qui se terminent par le verbe spécifié.
  • * : inclut toutes les autorisations. Cette valeur n'est autorisée que lors de l'affichage des autorisations incluses, et non des autorisations exclues.

Les groupes d'autorisations n'incluent que les autorisations compatibles avec les rôles personnalisés. Les autres autorisations ne sont pas incluses, même si elles correspondent au format spécifié.

Pour savoir quelles autorisations sont compatibles avec les rôles personnalisés, consultez Niveaux de compatibilité des autorisations dans les rôles personnalisés.

Les autorisations listées sur cette page n'utilisent pas le même format que les autorisations des règles d'accès utilisateur :

  • Les rôles personnalisés utilisent le format v1 pour les noms d'autorisation, qui est SERVICE_ID.RESOURCE.VERB.
  • Les UAP utilisent le format de nom de domaine complet pour les noms d'autorisation, à savoir SERVICE_FQDN/RESOURCE.VERB.

Toutefois, les valeurs de SERVICE_ID et SERVICE_FQDN sont généralement similaires. Dans la plupart des cas, la valeur de SERVICE_FQDN correspond à la valeur de SERVICE_ID de l'API v1, suivie de .googleapis.com. Par exemple, l'autorisation permettant de supprimer un rôle peut être écrite de l'une des manières suivantes :

  • Format v1 : iam.roles.delete
  • Format du nom de domaine complet : iam.googleapis.com/roles.delete

Vous pouvez utiliser cette similitude pour traduire entre les deux formats lors de l'examen des groupes d'autorisations pour les règles d'autorisation.

Il existe quelques exceptions à cette règle. Pour voir ces exceptions, consultez la liste des autorisations compatibles avec les stratégies de refus et recherchez IAM v1 API dans le champ de filtre.

Groupes d'autorisations dans les règles de refus

Les règles de refus ne sont compatibles qu'avec certains groupes d'autorisations. Les groupes d'autorisations compatibles sont listés dans Autorisations compatibles avec les stratégies de refus. Les identifiants des groupes d'autorisations compatibles remplacent une ou plusieurs sections d'un nom d'autorisation par un caractère générique (*). Les autorisations incluses dans chaque groupe dépendent de la position du caractère générique :

  • SERVICE_FQDN/RESOURCE.* : refuse toutes les autorisations pour la ressource spécifiée.
  • SERVICE_FQDN/*.* : refuse toutes les autorisations pour le service spécifié.
  • SERVICE_FQDN/*.VERB : refuse toutes les autorisations pour un service qui se termine par le verbe spécifié.

Les groupes d'autorisations incluent toutes les autorisations actuelles et futures qui correspondent au modèle spécifié. Par exemple, imaginez que vous utilisez le groupe d'autorisations example.googleapis.com/exampleResource.* pour refuser à un utilisateur toutes les autorisations pour le type de ressource exampleResource. Si example.googleapis.com ajoute une autorisation pour le type de ressource exampleResource, telle que example.googleapis.com/exampleResource.newPermission, l'utilisateur se verra automatiquement refuser la nouvelle autorisation.

Vous ne pouvez utiliser des caractères génériques que dans les groupes d'autorisations compatibles. L'utilisation de caractères génériques dans d'autres noms d'autorisations dans les règles de refus n'est pas acceptée.

Créer des stratégies d'accès unifiées

Vous pouvez créer des règles d'accès utilisateur dans un projet, un dossier ou une organisation. La ressource dans laquelle vous créez la règle d'accès utilisateur devient le parent de la règle d'accès utilisateur. Toutefois, la règle d'accès utilisateur n'a aucun effet tant que vous ne l'avez pas appliquée.

Le parent de l'UAP apparaît dans le nom de l'UAP. Les noms des règles sont au format RESOURCE_TYPE/RESOURCE_ID/locations/global/accessPolicies/POLICY_ID, où les espaces réservés représentent les éléments suivants :

  • RESOURCE_TYPE : type de la ressource où l'UAP a été créée. Cette valeur est projects, folders ou organizations.
  • RESOURCE_ID : ID de la ressource dans laquelle la règle d'accès utilisateur a été créée.
  • POLICY_ID : ID alphanumérique de l'UAP.

Par exemple, si vous créez une UAP example-policy dans le projet example-project, la ressource parente de cette UAP est example-project et le nom de l'UAP est projects/example-project/locations/global/accessPolicies/example-policy.

Où créer des stratégies d'accès unifiées

Le parent d'une stratégie d'accès utilisateur n'affecte pas les ressources auxquelles vous pouvez appliquer la stratégie d'accès utilisateur. Toutefois, cela affecte les personnes autorisées à afficher et à modifier l'UAP. Pour vous assurer que les utilisateurs appropriés sont autorisés à afficher et à modifier les règles d'accès utilisateur appropriées, nous vous recommandons de choisir une ressource parente qui reflète au mieux le champ d'application de la règle d'accès utilisateur.

Par exemple, si vous souhaitez appliquer une UAP à votre organisation, nous vous recommandons de la créer dans l'organisation.

Appliquer des règles aux ressources

Pour appliquer une UAP, vous devez créer une liaison. Chaque liaison spécifie une UAP et une ressource à laquelle lier l'UAP. Une fois que vous avez créé la liaison, les règles de la stratégie d'accès utilisateur s'appliquent à cette ressource, ainsi qu'à tous ses descendants.

Par exemple, imaginons que vous disposiez d'une règle d'accès utilisateur, compute-access-management. Cette stratégie d'accès utilisateur accorde le rôle Éditeur Compute (roles/compute.editor) au groupe compute-users@example.com et refuse les autorisations compute.googleapis.com/instances.* à tous les utilisateurs, sauf à compute-users@example.com.

Sans aucune liaison, cette UAP n'a aucun effet.

Vous souhaitez que cette stratégie d'accès utilisateur s'applique à toutes les ressources de votre organisation example.com. Vous créez donc une liaison qui associe la stratégie d'accès utilisateur compute-access-management à example.com. Une fois la liaison créée, la règle d'accès utilisateur a les effets suivants :

  • Les membres de compute-users@example.com peuvent utiliser les autorisations du rôle Éditeur Compute pour accéder aux ressources de example.com.
  • Tous les utilisateurs qui ne sont pas membres de compute-users@example.com ne peuvent pas utiliser les autorisations liées à l'instance pour accéder aux ressources de example.com.

Ressources compatibles

Le tableau suivant liste les ressources auxquelles vous pouvez lier des UAP. Chaque ligne contient les éléments suivants :

  • Le type de ressource
  • Le format des ID de cette ressource
  • Ressource Resource Manager (projet, dossier ou organisation) qui est le parent des liaisons pour ce type de ressource
Ressource ID de ressource Ressource parente des liaisons
Projets Resource Manager //cloudresourcemanager.googleapis.com/projects/PROJECT_ID Le projet dans la liaison
Dossiers Resource Manager //cloudresourcemanager.googleapis.com/folders/FOLDER_ID Le dossier dans la liaison
Organisations Resource Manager //cloudresourcemanager.googleapis.com/organizations/ORG_ID L'organisation dans la liaison
Applications d'IA Agent Registry //agentregistry.googleapis.com/projects/PROJECT_ID/locations/LOCATION/aiApplications/APPLICATION_ID Projet parent de l'application
Passerelles d'agent de l'API Network Services //networkservices.googleapis.com/projects/PROJECT_ID/locations/LOCATION/agentGateways/GATEWAY_ID Projet parent de la passerelle

Désactiver la création de liaisons

Si vous souhaitez désactiver la création de liaisons dans votre organisation, vous pouvez appliquer la contrainte de règle d'administration iam.managed.disableAccessPolicyBinding dans votre organisation. Cette contrainte empêche les comptes principaux de votre organisation de créer des liaisons pour les UAP.

Pour savoir comment activer ou désactiver cette contrainte, consultez Utiliser des contraintes gérées dans une règle d'administration.

Héritage des règles

Si vous associez une stratégie d'accès utilisateur à un projet, un dossier ou une organisation, elle est héritée via la hiérarchie des ressources.

La hiérarchie des ressources se compose de l'organisation (racine) en haut, suivie de dossiers (facultatifs) pour le regroupement, puis de projets, qui contiennent des ressources spécifiques aux services, telles que des machines virtuelles Compute Engine et des buckets Cloud Storage.

Dans cette hiérarchie, les projets, les dossiers et les organisations sont des ressources parentes. En d'autres termes, il s'agit de ressources qui contiennent d'autres ressources :

  • Les projets contiennent des ressources spécifiques aux services.
  • Les dossiers contiennent d'autres dossiers, des projets et les ressources des projets.
  • Les organisations contiennent des dossiers, des projets et les ressources des projets.

Les ressources contenues dans une ressource parente sont les descendantes de cette ressource.

Lorsque vous liez une UAP à une ressource parente, elle s'applique à la ressource parente et à tous ses descendants. En d'autres termes, l'UAP est héritée par les descendants de la ressource.

L'héritage des stratégies vous permet d'appliquer des stratégies à de grands ensembles de ressources avec une seule liaison. Par exemple, imaginons que vous créez une stratégie d'accès utilisateur qui attribue à taylor@example.com le rôle d'administrateur Compute Engine (roles/compute.admin). La stratégie d'accès utilisateur refuse également à noam@example.com l'autorisation compute.googleapis.com/instances.delete.

Vous souhaitez que cette UAP soit effective pour toutes les ressources de votre organisation, example.com. Pour ce faire, vous devez lier cette UAP à votre ressource d'organisation. Une fois que vous avez lié l'UAP à l'organisation, l'UAP est héritée par toutes les ressources de cette organisation.

La liaison de la règle d'accès utilisateur à l'organisation a les effets suivants :

  • taylor@example.com peut utiliser les autorisations du rôle d'administrateur Compute Engine pour accéder à n'importe quelle ressource de example.com.
  • noam@example.com ne peut pas utiliser l'autorisation compute.googleapis.com/instances.delete sur une ressource de example.com, même si une règle d'accès utilisateur sur une ressource descendante lui accorde l'accès.

Si vous souhaitez qu'une UAP s'applique à moins de ressources, vous pouvez la lier à un niveau inférieur de la hiérarchie des ressources, par exemple à un projet ou à une ressource spécifique à un service compatible.

Liaisons entre organisations

Vous ne pouvez pas créer de liaison inter-organisations pour une règle d'accès utilisateur. Une liaison inter-organisations est une liaison qui associe un UAP d'une organisation à une ressource d'une autre organisation.

IAM supprime régulièrement toutes les liaisons inter-organisations existantes. Des liaisons inter-organisations peuvent se produire lorsque vous déplacez un projet d'une organisation à une autre. Prenons l'exemple suivant :

  • Vous disposez d'un projet, example-project, dans l'organisation example.com.
  • Vous créez une UAP dans le projet example-project et la liez à example-project.
  • Vous déplacez example-project de example.com vers cymbalgroup.com.

Dans ce cas, le déplacement du projet crée une liaison inter-organisation. En effet, la règle d'accès utilisateur dans example.com est liée à une ressource dans cymbalgroup.com. Si vous ne supprimez pas la liaison manuellement, IAM la supprimera automatiquement au bout d'un certain temps. La suppression de cette liaison permet de s'assurer que les administrateurs cymbalgroup.com ont accès à toutes les règles d'accès utilisateur liées aux ressources de leur organisation.

Liaisons pour les stratégies d'accès unifiées supprimées

En règle générale, vous devez supprimer les liaisons d'une règle d'accès utilisateur avant de supprimer la règle elle-même. Toute tentative de suppression d'une règle d'accès utilisateur comportant des liaisons existantes entraîne une erreur.

Toutefois, si vous souhaitez supprimer une UAP sans supprimer les liaisons existantes, vous pouvez forcer la suppression de l'UAP.

La suppression forcée d'une stratégie d'accès utilisateur la supprime de toutes les ressources auxquelles elle est liée. Toutes les liaisons qui font référence à l'UAP seront supprimées. Toutefois, tant qu'elles ne sont pas supprimées, les liaisons sont toujours comptabilisées dans la limite du nombre de liaisons pouvant faire référence à une seule ressource.

Conditions dans les stratégies d'accès unifiées

Les conditions IAM vous permettent de définir et d'appliquer un contrôle des accès conditionnel et basé sur des attributs pour les ressources Google Cloud . Dans les règles d'accès utilisateur, vous pouvez ajouter des conditions à des règles individuelles pour contrôler quand elles s'appliquent. Vous ne pouvez pas ajouter de conditions aux liaisons UAP.

Les conditions sont composées d'un titre, d'une description et d'une expression booléenne. Si l'expression renvoie true pour la requête, la règle s'applique à la requête. Si elle renvoie false, la règle ne s'applique pas à la requête.

Les différents services proposent différents attributs et fonctions que vous pouvez utiliser pour écrire des expressions de condition. Lorsque vous ajoutez des conditions à une règle, vous devez toujours faire précéder la condition du nom du service dont vous utilisez les attributs et les fonctions. Vous pouvez ajouter plusieurs conditions à une règle, mais une même condition ne peut pas combiner des attributs de différents services.

Par exemple, si vous ajoutez une condition qui utilise un attribut fourni par IAM, vous devez faire précéder la condition de iam.googleapis.com :

"conditions": {
  "iam.googleapis.com": {
    "title": "CONDITION_TITLE",
    "description": "CONDITION_DESCRIPTION",
    "expression": "CONDITION_EXPRESSION"
  }
}

Pour savoir comment créer des règles UAP avec des conditions, consultez Créer et appliquer des règles UAP.

Autorisations applicables aux attributs de condition

Certains attributs spécifiques au service ne s'appliquent qu'aux requêtes impliquant certaines autorisations. Par exemple, l'attribut message.id de eventarc.googleapis.com ne s'applique qu'aux requêtes nécessitant l'autorisation eventarc.googleapis.com/messageBuses.publish.

Vous ne pouvez utiliser ces attributs que dans les règles qui incluent l'autorisation applicable. Si vous essayez d'utiliser l'attribut dans une règle sans l'autorisation applicable, la création de la règle d'accès utilisateur échouera.

Attributs de condition disponibles

Les attributs suivants sont acceptés dans les règles UAP :

Service Attribut Autorisations applicables En savoir plus
iam.googleapis.com (preview) Tags de ressource Tous Attribut des tags de ressource
eventarc.googleapis.com (preview) Messages eventarc.googleapis.com/messageBuses.publish Attributs des messages Eventarc
iap.googleapis.com (GA) Destinations iap.googleapis.com/resources.egressViaIAP Attributs des destinations Identity-Aware Proxy

Étapes suivantes