Gérer l'accès aux autres ressources

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Cette page décrit le processus général d'attribution, de modification et de révocation de l'accès aux ressources compatibles avec les stratégies d'autorisation.

Dans la gestion de l'authentification et des accès (IAM), l'accès est accordé via des stratégies d'autorisation, également appelées stratégies IAM. Une stratégie d'autorisation est associée à une ressource Google Cloud. Chaque stratégie d'autorisation contient un ensemble de liaisons de rôles qui associent un ou plusieurs comptes principaux, tels que des utilisateurs ou des comptes de service, à un rôle IAM. Ces liaisons de rôles accordent les rôles spécifiés aux comptes principaux, à la fois sur la ressource associée à la stratégie d'autorisation et sur tous les descendants de cette ressource. Pour en savoir plus sur les stratégies d'autorisation, consultez la section Comprendre les stratégies d'autorisation.

Cette page explique comment gérer les accès aux ressources à l'aide de Google Cloud Console, de la CLI Google Cloud et de l'API REST. Vous pouvez également gérer l'accès à l'aide des bibliothèques clientes Google Cloud.

Avant de commencer

Consultez la liste des types de ressources compatibles avec les stratégies d'autorisation.

Autorisations requises

Pour gérer l'accès à une ressource, vous devez disposer des autorisations nécessaires pour l'obtenir, ainsi que pour obtenir et définir la stratégie d'autorisation de la ressource. Ces autorisations présentent le format suivant, où SERVICE est le nom du service propriétaire de la ressource et RESOURCE_TYPE est le nom du type de ressource dont vous souhaitez gérer l'accès :

  • SERVICE.RESOURCE_TYPE.get
  • SERVICE.RESOURCE_TYPE.getIamPolicy
  • SERVICE.RESOURCE_TYPE.setIamPolicy

Par exemple, pour gérer l'accès à une instance Compute Engine, vous devez disposer des autorisations suivantes :

  • compute.instances.get
  • compute.instances.getIamPolicy
  • compute.instances.setIamPolicy

Pour obtenir les autorisations requises, demandez à votre administrateur de vous attribuer un rôle prédéfini ou personnalisé qui inclut ces autorisations. Par exemple, votre administrateur peut vous accorder le rôle "Administrateur de sécurité" (roles/iam.securityAdmin), qui inclut des autorisations permettant de gérer l'accès à presque toutes les ressources Google Cloud.

Afficher l'accès actuel

La section suivante explique comment utiliser la console Google Cloud, la CLI gcloud et l'API REST pour voir qui a accès à une ressource. Vous pouvez également consulter l'accès à l'aide des bibliothèques clientes Google Cloud pour obtenir la stratégie d'autorisation de la ressource.

Console

  1. Dans la console Google Cloud, accédez à la page qui répertorie la ressource à laquelle vous souhaitez afficher l'accès.

    Par exemple, pour gérer l'accès à une instance Compute Engine, accédez à la page Instances de VM.

    Accéder à la page Instances de VM

  2. Cochez la case située à côté de la ressource dont vous souhaitez consulter l'accès.

  3. Assurez-vous que le panneau d'informations est visible. S'il n'est pas visible, cliquez sur Afficher le panneau d'informations. L'onglet Autorisations du panneau d'informations fournit la liste de tous les comptes principaux qui ont accès à la ressource.

    Si le bouton Afficher les autorisations héritées est activé, la liste inclut les comptes principaux avec des rôles hérités, c'est-à-dire les comptes principaux dont l'accès provient de rôles sur les ressources parentes plutôt que de rôles sur la ressource elle-même. Pour en savoir plus sur l'héritage des stratégies, consultez la section Héritage des stratégies et hiérarchie des ressources.

gcloud

Pour savoir qui a accès à votre ressource, obtenez la stratégie d'autorisation pour la ressource. Pour apprendre à interpréter les stratégies d'autorisation, consultez la page Comprendre les stratégies d'autorisation.

Pour obtenir la stratégie d'autorisation associée à la ressource, exécutez la commande get-iam-policy correspondante.

Le format de cette commande varie en fonction du type de ressource dont vous gérez l'accès. Pour connaître le format de votre ressource, recherchez la documentation de référence de la commande get-iam-policy de la ressource dans la documentation de référence de la CLI Google Cloud. Cette documentation est organisée par service, puis par ressource. Par exemple, pour obtenir la stratégie d'autorisation d'une instance de VM Compute Engine, suivez le format décrit dans la documentation de référence sur gcloud compute instances get-iam-policy.

Vous pouvez également ajouter les arguments suivants à la commande pour spécifier le format et exporter les résultats :

--format=FORMAT > PATH

Indiquez les valeurs suivantes :

  • FORMAT : format souhaité pour la stratégie. Utilisez json ou yaml.
  • PATH : le chemin d'accès à un nouveau fichier de sortie pour la stratégie.

Lorsque vous exécutez la commande, la stratégie d'autorisation de la ressource est soit affichée sur la console, soit exportée vers le fichier spécifié.

REST

Pour savoir qui a accès à votre ressource, obtenez la stratégie d'autorisation de la ressource. Pour apprendre à interpréter les stratégies d'autorisation, consultez la page Comprendre les stratégies d'autorisation.

Pour obtenir la stratégie d'autorisation de la ressource, utilisez la méthode getIamPolicy de la ressource.

La méthode HTTP, l'URL et le corps de la requête dépendent de la ressource pour laquelle vous souhaitez visualiser l'accès. Pour obtenir ces détails, recherchez la documentation de référence de l'API du service propriétaire de la ressource, puis recherchez la documentation de référence de la méthode getIamPolicy de la ressource. Par exemple, la méthode HTTP, l'URL et le corps de la requête d'une instance Compute Engine sont spécifiés dans la documentation de référence sur les instances getIamPolicy.

La réponse de la méthode getIamPolicy d'une ressource contient la stratégie d'autorisation de cette ressource.

Attribuer ou révoquer un rôle unique

Vous pouvez utiliser la console Google Cloud et gcloud CLI pour accorder ou révoquer rapidement un rôle unique pour un seul compte principal, sans modifier directement la stratégie d'autorisation de la ressource. Les types de membres courants incluent les comptes principaux Google, les comptes de service, les Google Groupes et les domaines. Pour obtenir la liste de tous les types de comptes principaux, consultez la page Concepts liés à l'identité.

Si vous avez besoin d'identifier les rôles prédéfinis les plus appropriés, consultez la section Choisir des rôles prédéfinis.

Attribuer un rôle unique

Pour attribuer un seul rôle à un compte principal, procédez comme suit :

Console

  1. Dans la console Google Cloud, accédez à la page répertoriant la ressource à laquelle vous souhaitez consulter l'accès.

    Par exemple, pour gérer l'accès à une instance Compute Engine, accédez à la page Instances de VM.

    Accéder à la page Instances de VM

  2. Cochez la case située à côté de la ressource dont vous souhaitez gérer l'accès.

  3. Assurez-vous que le panneau d'informations est visible. S'il n'est pas visible, cliquez sur Afficher le panneau d'informations.

  4. Sélectionnez un compte principal auquel attribuer un rôle :

    • Pour accorder un rôle à un compte principal qui dispose déjà d'autres rôles sur la ressource, recherchez une ligne contenant le compte principal, cliquez sur Modifier le compte principal sur cette ligne, et cliquez sur Ajouter un autre rôle.

    • Pour attribuer un rôle à un compte principal qui ne dispose pas déjà d'autres rôles sur la ressource, cliquez sur Ajouter un compte principal, puis saisissez l'adresse e-mail ou un autre identifiant du compte principal.

  5. Sélectionnez un rôle à attribuer dans la liste déroulante. Pour respecter les bonnes pratiques de sécurité, choisissez un rôle qui n'inclut que les autorisations dont votre compte principal a besoin.

  6. Facultatif : ajoutez une condition au rôle.

  7. Cliquez sur Enregistrer. Le rôle est attribué au compte principal sur la ressource.

gcloud

Pour attribuer rapidement un rôle à un compte principal, exécutez la commande add-iam-policy-binding.

Le format de cette commande varie en fonction du type de ressource dont vous gérez l'accès. Pour connaître le format de votre ressource, recherchez la documentation de référence de la commande add-iam-policy-binding de la ressource dans la documentation de référence de la CLI Google Cloud. Cette documentation est organisée par service, puis par ressource. Par exemple, pour attribuer à un compte principal un rôle sur une instance Compute Engine, suivez le format décrit dans la documentation de référence de gcloud compute instances add-iam-policy- binding.

Révoquer un rôle unique

Pour révoquer un seul rôle d'un compte principal, procédez comme suit :

Console

  1. Dans la console Google Cloud, accédez à la page répertoriant la ressource dont vous souhaitez révoquer l'accès.

    Par exemple, pour gérer l'accès à une instance Compute Engine, accédez à la page instances de VM :

    Accéder à la page Instances de VM

  2. Cochez la case située à côté de la ressource dont vous souhaitez gérer l'accès.

  3. Assurez-vous que le panneau d'informations est visible. S'il n'est pas visible, cliquez sur Afficher le panneau d'informations.

  4. Identifiez la ligne contenant le compte principal, puis cliquez sur Modifier le compte principal sur cette ligne.

  5. Cliquez sur le bouton Supprimer () pour chaque rôle que vous souhaitez révoquer, puis cliquez sur Enregistrer.

gcloud

Pour révoquer rapidement un rôle d'un compte principal, exécutez la commande remove-iam-policy-binding.

Le format de cette commande varie en fonction du type de ressource dont vous gérez l'accès. Pour connaître le format de votre ressource, recherchez la documentation de référence de la commande remove-iam-policy-binding de la ressource dans la documentation de référence de la CLI Google Cloud. Cette documentation est organisée par service, puis par ressource. Par exemple, pour attribuer à un compte principal un rôle sur une instance Compute Engine, suivez le format décrit dans la documentation de référence de gcloud compute instances remove-iam-policy-binding.

Attribuer ou révoquer plusieurs rôles

Pour effectuer des modifications d'accès à grande échelle impliquant l'attribution et la révocation de plusieurs rôles, utilisez le modèle lecture-modification-écriture pour mettre à jour la stratégie d'autorisation de la ressource :

  1. Lisez la stratégie d'autorisation actuelle en appelant getIamPolicy().
  2. Modifiez la stratégie d'autorisation, à l’aide d’un éditeur de texte ou de façon automatisée, afin d'ajouter ou de supprimer des comptes principaux ou des liaisons de rôles.
  3. Écrivez la stratégie d'autorisation mise à jour en appelant setIamPolicy().

Cette section explique comment utiliser gcloud CLI et l'API REST pour mettre à jour la stratégie d'autorisation. Vous pouvez également mettre à jour la stratégie d'autorisation à l'aide des bibliothèques clientes Google Cloud.

Obtenir la stratégie d'autorisation actuelle

gcloud

Pour obtenir la stratégie d'autorisation associée à la ressource, exécutez la commande get-iam-policy correspondante.

Le format de cette commande varie en fonction du type de ressource dont vous gérez l'accès. Pour connaître le format de votre ressource, recherchez la documentation de référence de la commande get-iam-policy de la ressource dans la documentation de référence de la CLI Google Cloud. Cette documentation est organisée par service, puis par ressource. Par exemple, pour obtenir la stratégie d'autorisation d'une instance de VM Compute Engine, suivez le format décrit dans la documentation de référence sur gcloud compute instances get-iam-policy.

Vous pouvez également ajouter les arguments suivants à la commande pour spécifier le format et exporter les résultats :

--format=FORMAT > PATH

Indiquez les valeurs suivantes :

  • FORMAT : format souhaité pour la stratégie d'autorisation. Utilisez json ou yaml.
  • PATH : le chemin d'accès à un nouveau fichier de sortie pour la stratégie d'autorisation.

Lorsque vous exécutez la commande, la stratégie d'autorisation de la ressource est soit affichée sur la console, soit exportée vers le fichier spécifié.

REST

Pour obtenir la stratégie d'autorisation de la ressource, utilisez la méthode getIamPolicy de la ressource.

La méthode HTTP, l'URL et le corps de la requête dépendent de la ressource pour laquelle vous souhaitez visualiser l'accès. Pour obtenir ces détails, recherchez la documentation de référence de l'API du service propriétaire de la ressource, puis recherchez la documentation de référence de la méthode getIamPolicy de la ressource. Par exemple, la méthode HTTP, l'URL et le corps de la requête d'une instance de VM Compute Engine sont spécifiés dans la documentation de référence sur les instances getIamPolicy.

La réponse de la méthode getIamPolicy d'une ressource contient la stratégie d'autorisation de cette ressource. Enregistrez la réponse dans un fichier du type approprié (json ou yaml).

Modifier la stratégie d'autorisation

De façon automatisée ou à l'aide d'un éditeur de texte, modifiez la copie locale de la stratégie d'autorisation de votre ressource afin de refléter les rôles que vous souhaitez accorder ou révoquer.

Pour vous assurer de ne pas écraser les autres modifications, ne modifiez pas et ne supprimez pas le champ etag de la stratégie d'autorisation. Le champ etag identifie l'état actuel de la stratégie d'autorisation. Lorsque vous définissez la stratégie d'autorisation modifiée, Cloud IAM compare la valeur etag de la requête avec la valeur etag existante et n'écrit la stratégie d'autorisation que si les valeurs correspondent.

Attribuer un rôle

Pour attribuer des rôles à vos comptes principaux, modifiez les liaisons de rôles dans la stratégie d'autorisation. Pour savoir quels rôles vous pouvez attribuer, consultez la section Comprendre les rôles ou Afficher les rôles pouvant être attribués sur la ressource. Si vous avez besoin d'identifier les rôles prédéfinis les plus appropriés, consultez la section Choisir des rôles prédéfinis.

Vous pouvez éventuellement utiliser des conditions pour n'accorder des rôles que lorsque certaines conditions sont remplies.

Pour accorder un rôle déjà inclus dans la stratégie d'autorisation, ajoutez le compte principal à une liaison de rôle existante :

gcloud

Modifiez la stratégie d'autorisation en ajoutant le compte principal à une liaison de rôle existante. Notez que cette modification de stratégie ne prendra effet que lorsque vous aurez défini la stratégie d'autorisation mise à jour.

Par exemple, imaginons que la stratégie d'autorisation renvoyée contienne la liaison de rôle suivante, qui attribue le rôle Administrateur d'instances Compute (roles/compute.instanceAdmin) à kai@example.com :

{
  "role": "roles/compute.instanceAdmin",
  "members": [
    "user:kai@example.com"
  ]
}

Pour accorder ce même rôle à raha@example.com, ajoutez raha@example.com à la liaison de rôle existante :

{
  "role": "roles/compute.instanceAdmin",
  "members": [
    "user:kai@example.com",
    "user:raha@example.com"
  ]
}

REST

Modifiez la stratégie d'autorisation en ajoutant le compte principal à une liaison de rôle existante. Notez que cette modification de stratégie ne prendra effet que lorsque vous aurez défini la stratégie d'autorisation mise à jour.

Par exemple, imaginons que la stratégie d'autorisation renvoyée contienne la liaison de rôle suivante, qui attribue le rôle Administrateur d'instances Compute (roles/compute.instanceAdmin) à kai@example.com :

{
  "role": "roles/compute.instanceAdmin",
  "members": [
    "user:kai@example.com"
  ]
}

Pour accorder ce même rôle à raha@example.com, ajoutez raha@example.com à la liaison de rôle existante :

{
  "role": "roles/compute.instanceAdmin",
  "members": [
    "user:kai@example.com",
    "user:raha@example.com"
  ]
}

Pour accorder un rôle qui n'est pas encore inclus dans la stratégie, d'autorisation ajoutez une liaison de rôle :

gcloud

Modifiez la stratégie d'autorisation en ajoutant une nouvelle liaison de rôle qui accorde le rôle au compte principal. Cette modification ne prendra effet que lorsque vous aurez défini la stratégie d'autorisation mise à jour.

Par exemple, pour accorder le rôle d'administrateur de l'équilibreur de charge Compute (roles/compute.loadBalancerAdmin) à raha@example.com, ajoutez la liaison de rôle suivante au tableau bindings de la stratégie d'autorisation :

{
  "role": "roles/compute.loadBalancerAdmin",
  "members": [
    "user:raha@example.com"
  ]
}

REST

Modifiez la stratégie d'autorisation en ajoutant une nouvelle liaison de rôle qui accorde le rôle au compte principal. Cette modification ne prendra effet que lorsque vous aurez défini la stratégie d'autorisation mise à jour.

Par exemple, pour accorder le rôle d'administrateur de l'équilibreur de charge Compute (roles/compute.loadBalancerAdmin) à raha@example.com, ajoutez la liaison de rôle suivante au tableau bindings de la stratégie d'autorisation :

{
  "role": "roles/compute.loadBalancerAdmin",
  "members": [
    "user:raha@example.com"
  ]
}

Révoquer un rôle

Pour révoquer un rôle, supprimez le compte principal de la liaison de rôle. Si la liaison de rôle ne comporte aucun autre compte principal, supprimez toute la liaison de rôle.

gcloud

Révoquez un rôle en modifiant la stratégie d'autorisation JSON ou YAML renvoyée par la commande get-iam-policy. Cette modification ne prendra effet que lorsque vous aurez défini la stratégie d'autorisation mise à jour.

Pour révoquer un rôle d'un compte principal, supprimez les comptes principaux ou les liaisons concernés du tableau bindings de la stratégie d'autorisation.

REST

Révoquez un rôle en modifiant la stratégie d'autorisation JSON ou YAML renvoyée par la commande get-iam-policy. Cette modification ne prendra effet que lorsque vous aurez défini la stratégie d'autorisation mise à jour.

Pour révoquer un rôle d'un compte principal, supprimez les comptes principaux ou les liaisons concernés du tableau bindings de la stratégie d'autorisation.

Définir la stratégie d'autorisation

Après avoir modifié la stratégie d'autorisation pour accorder et révoquer les rôles souhaités, appelez setIamPolicy() pour effectuer les mises à jour.

gcloud

Pour définir la stratégie d'autorisation de la ressource, exécutez la commande set-iam-policy.

Le format de cette commande varie en fonction du type de ressource dont vous gérez l'accès. Pour connaître le format de votre ressource, recherchez la documentation de référence de la commande set-iam-policy de la ressource dans la documentation de référence de la CLI Google Cloud. Cette documentation est organisée par service, puis par ressource. Par exemple, pour obtenir la stratégie d'autorisation d'une instance de VM Compute Engine, suivez le format décrit dans la documentation de référence sur gcloud compute instances set-iam-policy.

La réponse de la commande set-iam-policy d'une ressource contient la stratégie d'autorisation mise à jour de la ressource.

REST

Pour définir la stratégie d'autorisation de la ressource, utilisez la méthode setIamPolicy de la ressource.

La méthode HTTP, l'URL et le corps de la requête dépendent de la ressource pour laquelle vous souhaitez visualiser l'accès. Pour obtenir ces détails, recherchez la documentation de référence de l'API du service propriétaire de la ressource, puis recherchez la documentation de référence de la méthode setIamPolicy de la ressource. Par exemple, la méthode HTTP, l'URL et le corps de la requête d'une instance de VM Compute Engine sont spécifiés dans la documentation de référence sur les instances setIamPolicy.

La réponse de la méthode setIamPolicy d'une ressource contient la stratégie d'autorisation mise à jour de cette ressource.

Étape suivante

Faites l'essai

Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

Essai gratuit