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 :
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 :
- Pour savoir comment configurer les identités des utilisateurs, consultez Identités des utilisateurs.
- Pour savoir comment configurer des identités pour les charges de travail, consultez Identités pour les charges de travail.
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.
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 :
|
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 :
|
Géré par Google |
Les types de stratégies suivants sont compatibles avec
Les types de règles suivants ne sont pas compatibles avec
|
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 :
|
Les deux |
Les types de règles suivants sont compatibles avec
|
| 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 :
|
| 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 :
|
| 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 :
|
| 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 :
|
| 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 :
Les types de règles suivants ne sont pas compatibles avec les pods GKE :
|
| 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 :
|
| 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 :
|
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 :
- Pour inclure les utilisateurs de tous les IdP, utilisez
allUsers. - Pour inclure les utilisateurs d'IdP externes spécifiques, utilisez l'identifiant pour toutes les identités d'un pool d'identités de personnel ou toutes les identités d'un pool d'identités de charge de travail.
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
- Découvrez les types de stratégies compatibles avec IAM.
- Attribuez un rôle à un compte principal sur un projet, un dossier ou une organisation Resource Manager.