Comptes principaux IAM

Dans Identity and Access Management (IAM), vous contrôlez l'accès des comptes principaux. Un compte principal représente une ou plusieurs identités qui se sont authentifiées auprès de Google Cloud.

Utiliser des comptes principaux dans vos stratégies

Pour utiliser des comptes principaux dans vos stratégies, procédez comme suit :

  1. Configurez les identités que Google Cloud peut reconnaître. La configuration des identités consiste à créer des identités que Google Cloud peut reconnaître. Vous pouvez configurer des identités pour les utilisateurs et les charges de travail.

    Pour savoir comment configurer des identités, consultez les ressources suivantes :

  2. Déterminez l'identifiant principal que vous allez utiliser. L'identifiant du compte principal correspond à la manière dont vous faites référence à un compte principal dans vos stratégies. Cet identifiant peut faire référence à une seule identité ou à un groupe d'identités.

    Le format que vous utilisez pour l'identifiant principal dépend des éléments suivants :

    • Type de compte principal
    • Type de la stratégie dans laquelle vous souhaitez inclure le compte principal

    Pour connaître le format d'identifiant principal de chaque type de compte principal dans chaque type de stratégie, consultez Identifiants principaux.

    Une fois que vous connaissez le format de l'identifiant, vous pouvez déterminer l'identifiant unique du compte principal en fonction de ses attributs, tels que son adresse e-mail.

  3. Incluez l'identifiant du compte principal dans votre stratégie. Ajoutez votre compte principal à votre stratégie, en respectant le format de la stratégie.

    Pour en savoir plus sur les différents types de stratégies dans IAM, consultez Types de stratégies.

Compatibilité avec les types de comptes principaux

Chaque type de stratégie IAM est compatible avec un sous-ensemble des types de comptes principaux compatibles avec IAM. Pour connaître les types de comptes principaux compatibles avec chaque type de stratégie, consultez Identifiants principaux.

Types de comptes principaux

Le tableau suivant décrit brièvement les différents types de comptes principaux compatibles avec IAM. Pour obtenir une description détaillée et des exemples de l'apparence d'un type de compte principal lorsqu'il est utilisé dans une stratégie, cliquez sur le nom du type de compte principal dans le tableau.

Type de compte principal Description Un seul compte principal ou un ensemble de comptes principaux Gérés par Google ou fédérés Compatibilité des types de règles
Comptes de service Compte utilisé par une charge de travail de machine plutôt que par une personne. Un seul compte principal Géré par Google

Les types de règles suivants sont compatibles avec les comptes de service :

  • Autoriser
  • Refuser
allAuthenticatedUsers Identifiant spécial qui représente tous les comptes de service et tous les utilisateurs humains sur Internet qui se sont authentifiés avec un compte Google.

Ensemble de comptes principaux pouvant contenir les types de comptes principaux suivants :

  • Comptes Google
  • Comptes de service
  • Identités des employés
  • Identités des charges de travail
Géré par Google

Les types de stratégies suivants sont compatibles avec allAuthenticatedUsers pour certaines ressources :

  • Autoriser

Les types de règles suivants ne sont pas compatibles avec allAuthenticatedUsers :

  • Refuser
allUsers ou principalSet://goog/public:all Identifiant spécial qui représente toute personne ayant accès à Internet, qu'elle soit authentifiée ou non.

Ensemble de comptes principaux pouvant contenir les types de comptes principaux suivants :

  • Comptes Google
  • Comptes de service
  • Identités des employés
  • Identités des charges de travail
Les deux

Les types de règles suivants sont compatibles avec allUsers ou principalSet://goog/public:all :

  • Autoriser (pour certaines ressources)
  • Refuser
Un seul compte principal dans un pool d'identités de personnel Utilisateur humain dont l'identité est gérée par un IdP externe et fédérée à l'aide de la fédération des identités des employés. Un seul compte principal Fédéré

Les types de stratégies suivants sont compatibles avec un seul principal dans un pool d'identités de personnel :

  • Autoriser
  • Refuser
Ensemble de comptes principaux dans un pool d'identités de personnel Ensemble d'utilisateurs humains dont les identités sont gérées par un IdP externe et fédérées à l'aide de la fédération des identités des employés. Ensemble de comptes principaux contenant des identités d'employés. Fédéré

Les types de stratégies suivants sont compatibles avec un ensemble de comptes principaux dans un pool d'identités de personnel :

  • Autoriser
  • Refuser
Un seul compte principal dans un pool d'identités de charge de travail Une charge de travail (ou un utilisateur machine) dont l'identité est gérée par un IdP externe et fédérée à l'aide de la fédération d'identité de charge de travail. Un seul compte principal Fédéré

Les types de stratégies suivants sont compatibles avec un seul compte principal dans un pool d'identités de charge de travail :

  • Autoriser
  • Refuser
Ensemble de comptes principaux dans un pool d'identités de charge de travail Ensemble de charges de travail (ou d'utilisateurs de machines) dont les identités sont gérées par un IdP externe et fédérées à l'aide de la fédération d'identité de charge de travail. Ensemble de comptes principaux contenant des Workload Identities Fédéré

Les types de règles suivants sont compatibles avec un ensemble de comptes principaux dans un pool d'identités de charge de travail :

  • Autoriser
  • Refuser
Un ensemble de pods Google Kubernetes Engine Une charge de travail (ou un utilisateur machine) exécutée sur GKE et fédérée via GKE. Ensemble de comptes principaux pouvant contenir une ou plusieurs identités de charge de travail fédérées Fédéré

Les types de règles suivants sont compatibles avec les pods GKE :

  • Autoriser

Les types de règles suivants ne sont pas compatibles avec les pods GKE :

  • Refuser
Identités d'agent Identité d'une charge de travail agentique fortement attestée et liée au cycle de vie de l'agent. Un seul compte principal Géré par Google

Les types de stratégies suivants sont compatibles avec les identités d'agent :

  • Autoriser
  • Refuser
Un ensemble d'identités d'agent Toutes les identités d'agent d'un domaine de confiance. Ensemble de comptes principaux contenant des identités d'agent. Géré par Google

Les types de stratégies suivants sont compatibles avec un ensemble d'identités d'agent :

  • Autoriser
  • Refuser

Les sections suivantes décrivent ces types de comptes principaux plus en détail.

Comptes de service

Un compte de service est un compte destiné à une application ou à une charge de travail de calcul plutôt qu'à un utilisateur final individuel. Les comptes de service peuvent être divisés en comptes de service gérés par l'utilisateur et en comptes de service gérés par Google, appelés agents de service :

  • Lorsque vous exécutez du code hébergé sur Google Cloud, vous spécifiez un compte de service à utiliser comme identité pour votre application. Vous pouvez créer autant de comptes de service gérés par l'utilisateur que nécessaire pour représenter les différents composants logiques de votre application.

  • Certains services Google Cloud ont besoin d'accéder à vos ressources pour pouvoir agir en votre nom. Google crée et gère des agents de service pour répondre à ce besoin.

Les exemples suivants montrent comment identifier un compte de service dans différents types de stratégies :

  • Règles d'autorisation : serviceAccount:my-service-account@my-project.
  • Stratégies de refus : principal://iam.googleapis.com/projects/-/serviceAccounts/my-service-account@my-project.

Pour en savoir plus sur les formats des identifiants de principal, consultez Identifiants de principal.

Pour en savoir plus sur les comptes de service, consultez les pages suivantes :

allAuthenticatedUsers

La valeur allAuthenticatedUsers est un identifiant spécial qui représente tous les comptes de service.

Ce type de compte principal n'inclut pas les identités fédérées, qui sont gérées par des fournisseurs d'identité (IdP) externes. Pour inclure des identités fédérées, utilisez l'une des options suivantes :

Certains types de ressources ne sont pas compatibles avec ce type de compte principal.

allUsers

La valeur allUsers est un identifiant spécial qui représente toute personne ayant accès à Internet, y compris les utilisateurs authentifiés et non authentifiés.

Certains types de ressources ne sont pas compatibles avec ce type de compte principal.

Les exemples suivants montrent à quoi peut ressembler l'identifiant allUsers dans différents types de règles :

  • Règles d'autorisation sur les types de ressources compatibles : allUsers
  • Stratégies de refus : principalSet://goog/public:all

Pour en savoir plus sur les formats des identifiants de principal, consultez Identifiants de principal.

Identités fédérées dans un pool d'identités de personnel

Un pool d'identités des employés est un ensemble d'identités utilisateur géré par un IdP externe et fédéré à l'aide de la fédération des identités des employés. Vous pouvez référencer les comptes principaux de ces pools de la manière suivante :

  • Une identité unique dans un pool d'identités de personnel
  • Toutes les identités d'employés d'un groupe spécifié
  • Toutes les identités d'employés porteuses d'une valeur d'attribut spécifique
  • Toutes les identités d'un pool d'identités d'employés

Les exemples suivants montrent comment identifier les pools d'identités de personnel fédérés dans différents types de stratégies :

  • Identité unique dans les stratégies d'autorisation : principal://iam.googleapis.com/locations/global/workforcePools/altostrat-contractors/subject/raha@altostrat.com
  • Un groupe d'identités dans les stratégies de refus : principalSet://iam.googleapis.com/locations/global/workforcePools/altostrat-contractors/group/administrators-group@altostrat.com

Pour en savoir plus sur les formats des identifiants de principal, consultez Identifiants de principal.

Identités fédérées dans un pool d'identités de charge de travail

Un pool d'identités de charge de travail est un ensemble d'identités de charge de travail géré par un IdP externe et fédéré à l'aide de la fédération d'identité de charge de travail. Vous pouvez référencer les comptes principaux de ces pools de la manière suivante :

  • Identité unique d'un pool d'identités de charge de travail
  • Toutes les identités de charge de travail d'un groupe spécifié
  • Toutes les identités de charge de travail porteuses d'une valeur d'attribut spécifique
  • Toutes les identités d'un pool d'identités de charge de travail

Les exemples suivants montrent comment identifier les pools d'identités de charge de travail fédérés dans différents types de règles :

  • Identité unique dans les stratégies d'autorisation : principal://iam.googleapis.com/projects/123456789012/locations/global/workloadIdentityPools/altostrat-contractors/subject/raha@altostrat.com
  • Un groupe d'identités dans les stratégies de refus : principalSet://iam.googleapis.com/projects/123456789012/locations/global/workloadIdentityPools/altostrat-contractors/group/administrators-group@altostrat.com

Pour en savoir plus sur les formats des identifiants de comptes principaux, consultez Identifiants de comptes principaux.

Identités d'agent

Une identité d'agent est une identité gérée par Google pour les charges de travail agentiques. L'identité d'un agent est attestée et liée au cycle de vie de l'agent, ce qui permet de gérer l'accès des agents aux ressources Google Cloud de manière plus sécurisée qu'avec des comptes de service.

Chaque agent est automatiquement provisionné avec une identité d'agent. Vous pouvez accorder ou refuser l'accès aux ressources Google Cloud à l'aide de stratégies d'autorisation et de refus IAM. Vous pouvez également gérer l'accès pour toutes les identités d'agent d'un projet, d'un dossier ou d'une organisation à l'aide de stratégies d'autorisation, de refus et de stratégie Limite d'accès des principaux.

Les identités d'agent peuvent également être regroupées dans des pools d'identités d'agent.

Les exemples suivants montrent comment identifier les identités d'agent dans différents types de règles :

  • Identité d'agent unique dans une stratégie d'autorisation (dans une organisation) : principal://agents.global.org-123456789012.system.id.goog/resources/aiplatform/projects/9876543210/locations/us-central1/reasoningEngines/my-test-agent
  • Identité d'agent unique dans une stratégie d'autorisation (dans un projet sans organisation) : principal://agents.global.proj-9876543210.system.id.goog/resources/aiplatform/projects/9876543210/locations/us-central1/reasoningEngines/my-test-agent
  • Toutes les identités d'agent d'un projet dans une stratégie de refus : principal://agents.global.org-123456789012.system.id.goog/resources/aiplatform/projects/9876543210
  • Toutes les identités d'agent d'un projet dans une stratégie de limite d'accès des comptes principaux : //agents.global.org-123456789012.system.id.goog/attribute.container/projects/9876543210

Pour en savoir plus sur les formats des identifiants de principal, consultez Identifiants de principal.

Étapes suivantes