Princípios do IAM

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:

  1. 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:

  2. 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.

  3. 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:

  • Permitir
  • Negar
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:

  • Contas do Google
  • Contas de serviço
  • Identidades de colaboradores
  • Identidades da carga de trabalho
Gerenciada pelo Google

Os seguintes tipos de política são compatíveis com allAuthenticatedUsers para alguns recursos:

  • Permitir

Os seguintes tipos de política não são compatíveis com allAuthenticatedUsers:

  • Negar
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:

  • Contas do Google
  • Contas de serviço
  • Identidades de colaboradores
  • Identidades da carga de trabalho
Ambos

Os seguintes tipos de política são compatíveis com allUsers ou principalSet://goog/public:all:

  • Permitir (para alguns recursos)
  • Negar
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:

  • Permitir
  • Negar
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:

  • Permitir
  • Negar
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:

  • Permitir
  • Negar
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:

  • Permitir
  • Negar
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:

  • Permitir

Os seguintes tipos de política não são compatíveis com pods do GKE:

  • Negar
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:

  • Permitir
  • Negar
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:

  • Permitir
  • Negar

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:

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