No Identity and Access Management (IAM), você controla o acesso de principais. Um principal representa uma ou mais identidades que foram autenticadas no Google Cloud.
Usar principais nas políticas
Para usar principais nas suas políticas, faça o seguinte:
Configurar identidades que o Google Cloud pode reconhecer. Configurar identidades é o processo de criar identidades que o Google Cloud possa reconhecer. É possível configurar identidades para usuários e cargas de trabalho.
Para saber como configurar identidades, consulte:
- Para saber como configurar identidades para usuários, consulte Identidades para usuários.
- Para saber como configurar identidades para cargas de trabalho, consulte Identidades para cargas de trabalho.
Determine o identificador principal que você vai usar. O identificador de principal é como você se refere a um principal nas suas políticas. Esse identificador pode se referir a uma única identidade ou a um grupo de identidades.
O formato usado para o identificador principal depende do seguinte:
- O tipo de principal
- O tipo de política em que você quer incluir o principal
Para conferir o formato do identificador de principal para cada tipo de principal em cada tipo de política, consulte Identificadores de principal.
Depois de saber o formato do identificador, é possível determinar o identificador exclusivo do principal com base nos atributos dele, como o endereço de e-mail.
Inclua o identificador do principal na política. Adicione o principal à política, seguindo o formato dela.
Para saber mais sobre os diferentes tipos de políticas no IAM, consulte Tipos de políticas.
Suporte para tipos de principal
Cada tipo de política do IAM é compatível com um subconjunto dos tipos de principal aceitos pelo IAM. Para conferir os tipos de principais compatíveis com cada tipo de política, consulte Identificadores de principais.
Tipos principais
A tabela a seguir descreve brevemente os diferentes tipos de principal compatíveis com o IAM. Para uma descrição detalhada e exemplos de como um tipo de principal pode ser usado em uma política, clique no nome do tipo de principal na tabela.
| Tipo principal | Descrição | Principal único ou conjunto de principais | Gerenciados pelo Google ou federados | Suporte a tipos de política |
|---|---|---|---|---|
| Contas de serviço | Uma conta usada por uma carga de trabalho de máquina, em vez de uma pessoa. | Principal único | Gerenciada pelo Google |
Os seguintes tipos de política são compatíveis com contas de serviço:
|
allAuthenticatedUsers |
Um identificador especial que representa todas as contas de serviço e usuários humanos na Internet que se autenticaram com uma Conta do Google. |
Conjunto de principais que pode conter os seguintes tipos de principais:
|
Gerenciada pelo Google |
Os seguintes tipos de política são compatíveis com
Os seguintes tipos de política não são compatíveis com
|
allUsers ou principalSet://goog/public:all |
Um identificador especial que representa qualquer pessoa que esteja na Internet, autenticada ou não. |
Conjunto de principais que pode conter os seguintes tipos de principais:
|
Ambos |
Os seguintes tipos de política são compatíveis com
|
| Um único principal em um pool de identidades de colaboradores | Um usuário humano com uma identidade gerenciada por um IdP externo e federada usando a federação de identidade de colaboradores. | Principal único | Federado |
Os seguintes tipos de política são compatíveis com um único principal em um pool de identidade de força de trabalho:
|
| Um conjunto de principais em um pool de identidades de força de trabalho | Um conjunto de usuários humanos com identidades gerenciadas por um IdP externo e federadas usando a federação de identidade de colaboradores. | Conjunto de principais que contém identidades de colaboradores. | Federado |
Os seguintes tipos de política são compatíveis com um conjunto de principais em um pool de identidades de colaboradores:
|
| Um único principal em um pool de Identidade da carga de trabalho | Uma carga de trabalho (ou usuário de máquina) com uma identidade gerenciada por um IdP externo e federada usando a federação de identidade da carga de trabalho. | Principal único | Federado |
Os seguintes tipos de política são compatíveis com um único principal em um pool de Identidade da carga de trabalho:
|
| Um conjunto de principais em um pool de identidade da carga de trabalho | Um conjunto de cargas de trabalho (ou usuários de máquina) com identidades gerenciadas por um IdP externo e federadas usando a federação de identidade da carga de trabalho. | Conjunto principal que contém identidades da carga de trabalho | Federado |
Os seguintes tipos de política são compatíveis com um conjunto de principais em um pool de Identidade da carga de trabalho:
|
| Um conjunto de pods do Google Kubernetes Engine | Uma carga de trabalho (ou usuário de máquina) em execução e federada pelo GKE. | Conjunto de principais que pode conter uma ou mais identidades de carga de trabalho federadas | Federado |
Os seguintes tipos de política são compatíveis com os pods do GKE:
Os seguintes tipos de política não são compatíveis com pods do GKE:
|
| Identidades de agente | Uma identidade para uma carga de trabalho com agentes que é fortemente atestada e está vinculada ao ciclo de vida do agente. | Principal único | Gerenciada pelo Google |
Os seguintes tipos de política são compatíveis com identidades de agente:
|
| Um conjunto de identidades de agentes | Todas as identidades de agente em um domínio de confiança. | Conjunto principal que contém identidades de agente. | Gerenciada pelo Google |
Os seguintes tipos de política são compatíveis com um conjunto de identidades de agente:
|
As seções a seguir descrevem esses tipos de principal em mais detalhes.
Contas de serviço
Uma conta de serviço é uma conta para uma carga de trabalho de aplicativo ou computação em vez de um usuário final individual. As contas de serviço podem ser divididas em contas de serviço gerenciadas pelo usuário e contas de serviço gerenciado pelo Google, que são chamadas de agentes de serviço:
Ao executar um código hospedado no Google Cloud, especifique uma conta de serviço para usar como a identidade do aplicativo. Para representar os diferentes componentes lógicos do aplicativo, crie quantas contas de serviço gerenciado pelo usuário forem necessárias.
Alguns serviços do Google Cloud precisam acessar seus recursos para serem capazes de atuar em seu nome. O Google cria e gerencia agentes de serviço para atender a essa necessidade.
Os exemplos a seguir mostram como identificar uma conta de serviço em diferentes tipos de políticas:
- Políticas de permissão:
serviceAccount:my-service-account@my-project. - Políticas de negação:
principal://iam.googleapis.com/projects/-/serviceAccounts/my-service-account@my-project.
Para saber mais sobre os formatos de identificadores de principais, consulte Identificadores de principais.
Para mais informações sobre contas de serviço, consulte as seguintes páginas:
allAuthenticatedUsers
O valor allAuthenticatedUsers é um identificador especial que representa todas
as contas de serviço.
Esse tipo principal não inclui identidades federadas, que são gerenciadas por provedores de identidade externos (IdPs). Para incluir identidades federadas, use uma das seguintes opções:
- Para incluir usuários de todos os IdPs, use
allUsers. - Para incluir usuários de IdPs externos específicos, use o identificador para todas as identidades em um pool de identidades da força de trabalho ou todas as identidades em um pool de identidades da carga de trabalho.
Alguns tipos de recursos não são compatíveis com esse tipo principal.
allUsers
O valor allUsers é um identificador especial que representa qualquer pessoa que esteja na Internet, incluindo usuários autenticados e não autenticados.
Alguns tipos de recursos não são compatíveis com esse tipo principal.
Os exemplos a seguir mostram como o identificador allUsers pode aparecer em
diferentes tipos de políticas:
- Políticas de permissão em tipos de recursos compatíveis:
allUsers - Políticas de negação:
principalSet://goog/public:all
Para saber mais sobre os formatos de identificadores de principais, consulte Identificadores de principais.
As identidades federadas em um pool de Identidades de colaboradores
Um pool de identidade de colaboradores é um conjunto de identidades de usuário gerenciado por um IdP externo e federado usando a federação de identidade de colaboradores. É possível referenciar principais nesses pools das seguintes maneiras:
- Uma única identidade em um pool de identidades de colaboradores
- Todas as identidades de colaboradores em um grupo especificado
- Todas as identidades da força de trabalho com um valor de atributo específico
- Todas as identidades em um pool de identidade da força de trabalho
Os exemplos a seguir mostram como identificar pools de identidade federados da força de trabalho em diferentes tipos de políticas:
- Uma única identidade em políticas de permissão:
principal://iam.googleapis.com/locations/global/workforcePools/altostrat-contractors/subject/raha@altostrat.com - Um grupo de identidades em políticas de negação:
principalSet://iam.googleapis.com/locations/global/workforcePools/altostrat-contractors/group/administrators-group@altostrat.com
Para saber mais sobre os formatos de identificadores de principais, consulte Identificadores de principais.
Identidades federadas em um pool de Identidade da carga de trabalho.
Um pool de identidade da carga de trabalho é um conjunto de identidades da carga de trabalho gerenciado por um IdP externo e federado usando a federação de identidade da carga de trabalho. É possível referenciar principais nesses pools das seguintes maneiras:
- Identidade única em um pool de Identidade da carga de trabalho
- Todas as identidades de cargas de trabalho em um grupo especificado
- Todas as identidades de carga de trabalho com um valor de atributo específico
- Todas as identidades em um pool de Identidade da carga de trabalho
Os exemplos a seguir mostram como identificar pools de identidade de carga de trabalho federada em diferentes tipos de políticas:
- Uma única identidade em políticas de permissão:
principal://iam.googleapis.com/projects/123456789012/locations/global/workloadIdentityPools/altostrat-contractors/subject/raha@altostrat.com - Um grupo de identidades em políticas de negação:
principalSet://iam.googleapis.com/projects/123456789012/locations/global/workloadIdentityPools/altostrat-contractors/group/administrators-group@altostrat.com
Para saber mais sobre os formatos de identificadores de principais, consulte Identificadores de principais.
Identidades de agente
Uma identidade de agente é uma identidade gerenciada pelo Google para cargas de trabalho com agentes. Uma identidade de agente é atestada e vinculada ao ciclo de vida do agente, o que oferece uma maneira mais segura de gerenciar o acesso do agente aos recursos do Google Cloud do que usando contas de serviço.
Cada agente é provisionado automaticamente com uma identidade de agente. É possível conceder ou negar acesso aos recursos do Google Cloud usando as políticas de permissão e negação do IAM. Também é possível gerenciar o acesso de todas as identidades de agente em um projeto, pasta ou organização usando políticas de permissão, negação e Política de limite de acesso de principal.
As identidades de agente também podem ser agrupadas em pools de identidades de agente.
Os exemplos a seguir mostram como identificar identidades de agentes em vários tipos de políticas:
- Uma única identidade de agente em uma política de permissão (em uma organização):
principal://agents.global.org-123456789012.system.id.goog/resources/aiplatform/projects/9876543210/locations/us-central1/reasoningEngines/my-test-agent - Uma única identidade de agente em uma política de permissão (em um projeto sem uma organização):
principal://agents.global.proj-9876543210.system.id.goog/resources/aiplatform/projects/9876543210/locations/us-central1/reasoningEngines/my-test-agent - Todas as identidades de agente em um projeto em uma política de negação:
principal://agents.global.org-123456789012.system.id.goog/resources/aiplatform/projects/9876543210 - Todas as identidades de agente em um projeto em uma política de limite de acesso de principal:
//agents.global.org-123456789012.system.id.goog/attribute.container/projects/9876543210
Para saber mais sobre os formatos de identificadores de principais, consulte Identificadores de principais.
A seguir
- Saiba mais sobre os tipos de política compatíveis com o IAM.
- Conceder um papel a um principal em um projeto, uma pasta ou uma organização do Resource Manager.