A federação de identidade da carga de trabalho permite conceder acesso a recursos doGoogle Cloud a cargas de trabalho externas usando pools de identidade da carga de trabalho e provedores de identidade (IdPs) conectados. Conforme seus requisitos mudam, é possível criar, visualizar, atualizar, excluir ou cancelar a exclusão de pools e provedores usando o console doGoogle Cloud , a Google Cloud CLI ou a API REST.
Antes de começar
Crie um pool de identidade da carga de trabalho. Para instruções, consulte os guias de configuração da federação de identidade da carga de trabalho.
Funções exigidas
Para as permissões necessárias para gerenciar pools e provedores de identidade de carga de trabalho, peça ao administrador que conceda a você os seguintes papéis do IAM no projeto:
-
Para ver pools e provedores:
Leitor do pool de Identidade da carga de trabalho do IAM (
roles/iam.workloadIdentityPoolViewer) -
Para visualizar, criar, atualizar e excluir pools e provedores:
Administrador de pool de Identidade da carga de trabalho do IAM (
roles/iam.workloadIdentityPoolAdmin)
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Esses papéis predefinidos contêm as permissões necessárias para gerenciar pools e provedores de identidade da carga de trabalho. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As permissões a seguir são necessárias para gerenciar os provedores e os pools de identidades da carga de trabalho:
-
Para visualizar pools e provedores de identidade de carga de trabalho:
-
iam.googleapis.com/workloadIdentityPoolProviders.get -
iam.googleapis.com/workloadIdentityPoolProviders.list -
iam.googleapis.com/workloadIdentityPools.get -
iam.googleapis.com/workloadIdentityPools.list
-
-
Para criar, atualizar e excluir pools e provedores:
-
iam.googleapis.com/workloadIdentityPoolProviders.create -
iam.googleapis.com/workloadIdentityPoolProviders.delete -
iam.googleapis.com/workloadIdentityPoolProviders.undelete -
iam.googleapis.com/workloadIdentityPoolProviders.update -
iam.googleapis.com/workloadIdentityPools.create -
iam.googleapis.com/workloadIdentityPools.delete -
iam.googleapis.com/workloadIdentityPools.undelete -
iam.googleapis.com/workloadIdentityPools.update
-
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Gerenciar pools de Identidade da carga de trabalho
Nesta seção, mostramos como gerenciar pools de identidade da carga de trabalho.
Criar pools
Para criar pools de identidade da carga de trabalho em um projeto, faça o seguinte:
Console
-
No console do Google Cloud , acesse a página Novo provedor de carga de trabalho e pool.
-
Na seção Criar um pool de identidades, insira um nome para o pool.
O console do Google Cloud usa o nome para criar um ID de pool. Para alterar o ID do pool, clique em Editar. Não será possível alterar o ID do pool posteriormente.
- Opcional: no campo Descrição, insira uma descrição para o pool.
- Opcional: para criar o pool em um estado desativado, clique no botão Pool ativado.
- Clique em Continuar.
- Nas seções Adicionar um provedor ao pool e Configurar atributos do provedor, configure um provedor de identidade para o pool. Para instruções, consulte Criar um provedor.
- Clique em Salvar.
gcloud
O comando gcloud iam workload-identity-pools create cria um pool de Identidade da carga de trabalho em um projeto.
Antes de usar os dados do comando abaixo, faça estas substituições:
POOL_ID: um ID exclusivo para o pool de Identidade da carga de trabalho, por exemplo,my-pool. Precisa ter de 4 a 32 caracteres alfanuméricos minúsculos ou hifens e não pode começar comgcp-.PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.DISPLAY_NAME: opcional. Um nome de exibição para o pool de identidade da carga de trabalho, com até 32 caracteres, por exemplo,My workload pool.DESCRIPTION: opcional. Uma descrição do pool de Identidade da carga de trabalho, com até 256 caracteres.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam workload-identity-pools create POOL_ID \ --project=PROJECT_ID \ --location="global" \ --display-name="DISPLAY_NAME" \ --description="DESCRIPTION"
Windows (PowerShell)
gcloud iam workload-identity-pools create POOL_ID ` --project=PROJECT_ID ` --location="global" ` --display-name="DISPLAY_NAME" ` --description="DESCRIPTION"
Windows (cmd.exe)
gcloud iam workload-identity-pools create POOL_ID ^ --project=PROJECT_ID ^ --location="global" ^ --display-name="DISPLAY_NAME" ^ --description="DESCRIPTION"
Você receberá uma resposta semelhante a esta:
Create request issued for: [my-pool] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef] to complete...done. Created workloadIdentityPool [my-pool].
REST
O método projects.locations.workloadIdentityPools.create cria um pool de Identidade da carga de trabalho em um projeto.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: um ID exclusivo para o pool de Identidade da carga de trabalho, por exemplo,my-pool. Precisa ter de 4 a 32 caracteres alfanuméricos minúsculos ou hifens e não pode começar comgcp-.DISPLAY_NAME: opcional. Um nome de exibição para o pool de identidade da carga de trabalho, com até 32 caracteres, por exemplo,My workload pool.DESCRIPTION: opcional. Uma descrição do pool de Identidade da carga de trabalho, com até 256 caracteres.
Método HTTP e URL:
POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools?workloadIdentityPoolId=POOL_ID
Corpo JSON da solicitação:
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION"
}
Para enviar a solicitação, expanda uma destas opções:
A resposta contém uma operação de longa duração que representa a solicitação. Para verificar se a criação do pool foi concluída, consulte Verificar o status de uma operação de longa duração nesta página.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
},
"done": false
}
Listar pools
Para listar todos os pools de identidade da carga de trabalho em um projeto, faça o seguinte:
Console
-
No console do Google Cloud , acesse a página Pools de Identidade da carga de trabalho.
- Na tabela, acesse a lista de pools de Identidade da carga de trabalho.
- Opcional: para incluir pools e provedores excluídos na lista, clique no botão Mostrar pools e provedores excluídos.
gcloud
O comando gcloud iam workload-identity-pools list lista os pools de Identidade da carga de trabalho em um projeto.
Antes de usar os dados do comando abaixo, faça estas substituições:
-
PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project. Para incluir pools com exclusão reversível na saída, adicione a flag--show-deleted.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam workload-identity-pools list \ --project=PROJECT_ID \ --location="global" \ --format="json"
Windows (PowerShell)
gcloud iam workload-identity-pools list ` --project=PROJECT_ID ` --location="global" ` --format="json"
Windows (cmd.exe)
gcloud iam workload-identity-pools list ^ --project=PROJECT_ID ^ --location="global" ^ --format="json"
Você receberá uma resposta semelhante a esta:
[
{
"description": "Workload identity pool for external workloads.",
"displayName": "My workload pool",
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
"state": "ACTIVE"
}
]
REST
O método projects.locations.workloadIdentityPools.list lista os pools de Identidade da carga de trabalho em um projeto.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
-
PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project. Para incluir pools excluídos de maneira reversível na resposta, anexe?showDeleted=trueao URL da solicitação.
Método HTTP e URL:
GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{
"workloadIdentityPools": [
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
"displayName": "My workload pool",
"description": "Workload identity pool for external workloads.",
"state": "ACTIVE"
}
]
}
Acessar piscina
Para ver detalhes de um pool de Identidade da carga de trabalho específico, faça o seguinte:
Console
-
No console do Google Cloud , acesse a página Pools de Identidade da carga de trabalho.
- Encontre o pool de identidade da carga de trabalho que você quer visualizar e clique no nome de exibição dele. O console do Google Cloud mostra detalhes sobre o pool de Identidade da carga de trabalho.
gcloud
O comando gcloud iam workload-identity-pools describe recebe detalhes sobre um pool de Identidade da carga de trabalho.
Antes de usar os dados do comando abaixo, faça estas substituições:
POOL_ID: o ID do pool de identidade da carga de trabalho, por exemplo,my-pool.PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam workload-identity-pools describe POOL_ID \ --project=PROJECT_ID \ --location="global" \ --format="json"
Windows (PowerShell)
gcloud iam workload-identity-pools describe POOL_ID ` --project=PROJECT_ID ` --location="global" ` --format="json"
Windows (cmd.exe)
gcloud iam workload-identity-pools describe POOL_ID ^ --project=PROJECT_ID ^ --location="global" ^ --format="json"
Você receberá uma resposta semelhante a esta:
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
"displayName": "My workload pool",
"description": "Workload identity pool for external workloads.",
"state": "ACTIVE"
}
REST
O método projects.locations.workloadIdentityPools.get recebe detalhes sobre um pool de Identidade da carga de trabalho.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de identidade da carga de trabalho, por exemplo,my-pool.
Método HTTP e URL:
GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
"displayName": "My workload pool",
"description": "Workload identity pool for external workloads.",
"state": "ACTIVE"
}
Atualizar um pool
É possível ativar ou desativar um pool de Identidade da carga de trabalho. Também é possível alterar o nome de exibição ou a descrição.
Para atualizar um pool de identidades da carga de trabalho existente, faça o seguinte:
Console
-
No console do Google Cloud , acesse a página Pools de Identidade da carga de trabalho.
- Encontre o pool de identidade da carga de trabalho que você quer editar.
- Clique no nome de exibição do pool de Identidade da carga de trabalho.
-
Para editar o nome de exibição do pool de Identidade da carga de trabalho, faça o seguinte:
- Na página Detalhes do pool, ao lado do nome de exibição, clique no ícone Editar.
- Na caixa de diálogo Editar nome de exibição do pool que aparece, atualize o nome de exibição.
- Clique em Salvar.
- Para desativar ou ativar o pool de Identidade da carga de trabalho, clique no botão de alternância Status e em Desativar ou Ativar.
-
Para editar a descrição, faça o seguinte:
- Em Descrição, ao lado do texto da descrição, clique em Editar.
- Atualize a descrição.
- Clique em Salvar.
gcloud
O comando gcloud iam workload-identity-pools update atualiza um pool de Identidade da carga de trabalho.
Antes de usar os dados do comando abaixo, faça estas substituições:
POOL_ID: o ID do pool de identidade da carga de trabalho, por exemplo,my-pool.PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.DISPLAY_NAME: um nome de exibição para o pool de Identidade da carga de trabalho, com até 32 caracteres, por exemplo,My updated pool.-
DESCRIPTION: uma descrição do pool de identidade da carga de trabalho, com até 256 caracteres. Para desativar ou ativar o pool, transmita também a flag--disabledou--no-disabled.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam workload-identity-pools update POOL_ID \ --project=PROJECT_ID \ --location="global" \ --display-name="DISPLAY_NAME" \ --description="DESCRIPTION"
Windows (PowerShell)
gcloud iam workload-identity-pools update POOL_ID ` --project=PROJECT_ID ` --location="global" ` --display-name="DISPLAY_NAME" ` --description="DESCRIPTION"
Windows (cmd.exe)
gcloud iam workload-identity-pools update POOL_ID ^ --project=PROJECT_ID ^ --location="global" ^ --display-name="DISPLAY_NAME" ^ --description="DESCRIPTION"
Você receberá uma resposta semelhante a esta:
Update request issued for: [my-pool] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000001-0123456789abcdef] to complete...done. Updated workloadIdentityPool [my-pool].
REST
O método projects.locations.workloadIdentityPools.patch atualiza um pool de Identidade da carga de trabalho.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de identidade da carga de trabalho, por exemplo,my-pool.UPDATE_MASK: uma lista separada por vírgulas de campos a serem atualizados, por exemplo,displayName,description,disabled.DISPLAY_NAME: um nome de exibição para o pool de Identidade da carga de trabalho, com até 32 caracteres, por exemplo,My updated pool.DESCRIPTION: uma descrição do pool de identidade da carga de trabalho, com até 256 caracteres.DISABLED: se o pool está desativado. Defina comotruepara desativar o pool oufalsepara ativá-lo.
Método HTTP e URL:
PATCH https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID?updateMask=UPDATE_MASK
Corpo JSON da solicitação:
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION",
"disabled": DISABLED
}
Para enviar a solicitação, expanda uma destas opções:
A resposta contém uma operação de longa duração que representa a solicitação. Para verificar se a atualização do pool foi concluída, consulte Verificar o status de uma operação de longa duração nesta página.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000001-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
},
"done": false
}
Excluir um pool
Ao excluir um pool de identidades de carga de trabalho, você também exclui os provedores de pools de identidades da carga de trabalho. Como resultado, as identidades no pool perdem o acesso aos recursos doGoogle Cloud .
É possível cancelar a exclusão de um pool até 30 dias após a exclusão. Após 30 dias, a exclusão é permanente. Até que um pool seja excluído permanentemente, não será possível reutilizar o nome dele ao criar um novo pool de Identidade da carga de trabalho.
Para excluir um pool de Identidade da carga de trabalho e os IdPs dele, faça o seguinte:
Console
-
No console do Google Cloud , acesse a página Pools de Identidade da carga de trabalho.
- Encontre o pool de Identidade da carga de trabalho que você quer excluir e clique no nome de exibição dele.
- Clique em Excluir pool e, em seguida, clique em Excluir. O pool de Identidade da carga de trabalho e os IdPs dele são excluídos.
gcloud
O comando gcloud iam workload-identity-pools delete exclui um pool de Identidade da carga de trabalho.
Antes de usar os dados do comando abaixo, faça estas substituições:
POOL_ID: o ID do pool de Identidade da carga de trabalho a ser excluído, por exemplo,my-pool.PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam workload-identity-pools delete POOL_ID \ --project=PROJECT_ID \ --location="global"
Windows (PowerShell)
gcloud iam workload-identity-pools delete POOL_ID ` --project=PROJECT_ID ` --location="global"
Windows (cmd.exe)
gcloud iam workload-identity-pools delete POOL_ID ^ --project=PROJECT_ID ^ --location="global"
Você receberá uma resposta semelhante a esta:
Delete request issued for: [my-pool] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000002-0123456789abcdef] to complete...done. Deleted workloadIdentityPool [my-pool].
REST
O método projects.locations.workloadIdentityPools.delete exclui um pool de Identidade da carga de trabalho.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de Identidade da carga de trabalho a ser excluído, por exemplo,my-pool.
Método HTTP e URL:
DELETE https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID
Para enviar a solicitação, expanda uma destas opções:
A resposta contém uma operação de longa duração que representa a solicitação. Para verificar se a exclusão do pool foi concluída, consulte Verificar o status de uma operação de longa duração nesta página.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000002-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
},
"done": false
}
Cancelar exclusão de um pool
É possível recuperar um pool de Identidade da carga de trabalho excluído até 30 dias após a exclusão.
Para cancelar a exclusão de um pool, faça o seguinte:
Console
-
No console do Google Cloud , acesse a página Pools de Identidade da carga de trabalho.
- Clique no botão Mostrar provedores e pools excluídos.
- Encontre o pool de identidade da carga de trabalho que você quer restaurar e clique no ícone Restaurar.
- Clique em Restaurar. O pool e os respectivos provedores são restaurados.
gcloud
O comando gcloud iam workload-identity-pools undelete restaura um pool de Identidade da carga de trabalho com exclusão reversível.
Antes de usar os dados do comando abaixo, faça estas substituições:
POOL_ID: o ID do pool de identidade da carga de trabalho excluído a ser restaurado, por exemplo,my-pool.PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam workload-identity-pools undelete POOL_ID \ --project=PROJECT_ID \ --location="global"
Windows (PowerShell)
gcloud iam workload-identity-pools undelete POOL_ID ` --project=PROJECT_ID ` --location="global"
Windows (cmd.exe)
gcloud iam workload-identity-pools undelete POOL_ID ^ --project=PROJECT_ID ^ --location="global"
Você receberá uma resposta semelhante a esta:
Undelete request issued for: [my-pool] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000003-0123456789abcdef] to complete...done. Undeleted workloadIdentityPool [my-pool].
REST
O método projects.locations.workloadIdentityPools.undelete restaura um pool de identidade da carga de trabalho que foi excluído de forma reversível.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de identidade da carga de trabalho excluído a ser restaurado, por exemplo,my-pool.
Método HTTP e URL:
POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID:undelete
Corpo JSON da solicitação:
{}
Para enviar a solicitação, expanda uma destas opções:
A resposta contém uma operação de longa duração que representa a solicitação. Para verificar se a restauração do pool foi concluída, consulte Verificar o status de uma operação de longa duração nesta página.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000003-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
},
"done": false
}
Gerenciar provedores de pools de identidade da carga de trabalho
Nesta seção, mostramos como gerenciar provedores de pool de identidade da carga de trabalho.
Criar um provedor
Para criar um provedor de pools de identidade da carga de trabalho em um pool de identidades de carga de trabalho atual, faça o seguinte:
Console
-
No console do Google Cloud , acesse a página Pools de Identidade da carga de trabalho.
- Encontre o pool de Identidade da carga de trabalho ao qual você quer adicionar um provedor e clique no Nome de exibição dele.
- Clique em Adicionar provedor.
-
Selecione o tipo de provedor a ser criado:
- AWS: um IdP da Amazon Web Services (AWS).
- OpenID Connect (OIDC): um IdP compatível com OIDC. Essa opção inclui o Microsoft Azure.
-
Insira um nome para o provedor.
O console do Google Cloud usa o nome para criar um ID de provedor. Para alterar o ID do provedor, clique em Editar. Não será possível alterar o ID do provedor depois.
-
Preencha os campos restantes para seu provedor:
- AWS: insira o ID da conta do AWS.
-
OIDC: insira o URL do emissor. Para o Azure, o URL do emissor usa o
formato
https://sts.windows.net/AZURE_TENANT_ID. Para outros provedores, consulte a documentação deles.
Quando terminar, clique em Continuar.
-
Para configurar o mapeamento de atributos, clique em Editar mapeamento. O mapeamento de atributos permite usar informações sobre identidades externas para conceder acesso a um subconjunto dessas identidades.
-
AWS: esta etapa é opcional. Você pode usar o mapeamento padrão.
Para mais detalhes, consulte Configurações do provedor de identidade para AWS e Azure.
-
OIDC: recomendamos mapear
google.subjectparaassertion.sub. Outros mapeamentos são opcionais.Para mais detalhes, consulte as configurações do IdP para o Azure ou outros provedores de OIDC.
-
- Opcional: para fornecer uma condição de atributo, que especifica as identidades que podem ser autenticadas, clique em Adicionar condição e insira uma expressão válida da Common Expression Language (CEL). Para mais detalhes, consulte Condições de atributos.
- Clique em Salvar. O provedor do pool de Identidade da carga de trabalho é criado.
gcloud
Criar um provedor da AWS
O comando gcloud iam workload-identity-pools providers create-aws cria um provedor de pool de Identidade da carga de trabalho da AWS.
Antes de usar os dados do comando abaixo, faça estas substituições:
PROVIDER_ID: um ID exclusivo para o provedor, por exemplo,my-aws-provider. Precisa ter de 4 a 32 caracteres alfanuméricos minúsculos ou hifens e não pode começar comgcp-.PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de Identidade da carga de trabalho ao qual o provedor será adicionado, por exemplo,my-pool.DISPLAY_NAME: opcional. Um nome de exibição para o provedor, com até 32 caracteres, por exemplo,My AWS provider.AWS_ACCOUNT_ID: o ID de 12 dígitos da sua conta da AWS, por exemplo,123456789012.ATTRIBUTE_CONDITION: opcional. Uma expressão da Common Expression Language (CEL) que restringe quais identidades podem ser autenticadas, por exemplo,attribute.aws_role == 'arn:aws:sts::123456789012:assumed-role/my-role'.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam workload-identity-pools providers create-aws PROVIDER_ID \ --project=PROJECT_ID \ --location="global" \ --workload-identity-pool="POOL_ID" \ --display-name="DISPLAY_NAME" \ --account-id="AWS_ACCOUNT_ID" \ --attribute-condition="ATTRIBUTE_CONDITION"
Windows (PowerShell)
gcloud iam workload-identity-pools providers create-aws PROVIDER_ID ` --project=PROJECT_ID ` --location="global" ` --workload-identity-pool="POOL_ID" ` --display-name="DISPLAY_NAME" ` --account-id="AWS_ACCOUNT_ID" ` --attribute-condition="ATTRIBUTE_CONDITION"
Windows (cmd.exe)
gcloud iam workload-identity-pools providers create-aws PROVIDER_ID ^ --project=PROJECT_ID ^ --location="global" ^ --workload-identity-pool="POOL_ID" ^ --display-name="DISPLAY_NAME" ^ --account-id="AWS_ACCOUNT_ID" ^ --attribute-condition="ATTRIBUTE_CONDITION"
Você receberá uma resposta semelhante a esta:
Create request issued for: [my-aws-provider] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000010-0123456789abcdef] to complete...done. Created workloadIdentityPoolProvider [my-aws-provider].
Criar um provedor do OIDC
O comando gcloud iam workload-identity-pools providers create-oidc cria um provedor de pool de Identidade da carga de trabalho do OIDC.
Antes de usar os dados do comando abaixo, faça estas substituições:
PROVIDER_ID: um ID exclusivo para o provedor, por exemplo,my-oidc-provider. Precisa ter de 4 a 32 caracteres alfanuméricos minúsculos ou hifens e não pode começar comgcp-.PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de Identidade da carga de trabalho ao qual o provedor será adicionado, por exemplo,my-pool.DISPLAY_NAME: opcional. Um nome de exibição para o provedor, com até 32 caracteres, por exemplo,My OIDC provider.ISSUER_URI: o URL HTTPS do emissor do OIDC, por exemplo,https://idp.example.comouhttps://sts.windows.net/AZURE_TENANT_ID.DISCOVERY_URI: Opcional. O URL para buscar o documento de descoberta do OIDC, substituindo o URL padrãoISSUER_URI/.well-known/openid-configuration, por exemplo,https://idp.example.com/.well-known/custom-openid-configuration. O esquema, o host e a porta precisam corresponder aISSUER_URI, e o caminho precisa conter um segmento/.well-known/seguido por um sufixo não vazio.ATTRIBUTE_CONDITION: opcional. Uma expressão da Common Expression Language (CEL) que restringe quais identidades podem ser autenticadas, por exemplo,assertion.sub.startsWith('repo:my-org/').ACTOR_PROVIDERS: Opcional. Os nomes de recursos completos de até três provedores de pool de Identidade da carga de trabalho no mesmo pool que estão autorizados a emitir tokens de ator para esse provedor, por exemplo,projects/my-project/locations/global/workloadIdentityPools/my-pool/providers/my-actor-provider. O identificador do projeto em cada nome de recurso precisa corresponder ao ID do projeto ou ao formato do número do projeto que você usa para esse provedor. Para mais informações, consulte Configurar delegação de identidade e tokens de ator.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID \ --project=PROJECT_ID \ --location="global" \ --workload-identity-pool="POOL_ID" \ --display-name="DISPLAY_NAME" \ --issuer-uri="ISSUER_URI" \ --discovery-uri="DISCOVERY_URI" \ --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="ATTRIBUTE_CONDITION" \ --actor-providers="ACTOR_PROVIDERS"
Windows (PowerShell)
gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID ` --project=PROJECT_ID ` --location="global" ` --workload-identity-pool="POOL_ID" ` --display-name="DISPLAY_NAME" ` --issuer-uri="ISSUER_URI" ` --discovery-uri="DISCOVERY_URI" ` --attribute-mapping="google.subject=assertion.sub" ` --attribute-condition="ATTRIBUTE_CONDITION" ` --actor-providers="ACTOR_PROVIDERS"
Windows (cmd.exe)
gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID ^ --project=PROJECT_ID ^ --location="global" ^ --workload-identity-pool="POOL_ID" ^ --display-name="DISPLAY_NAME" ^ --issuer-uri="ISSUER_URI" ^ --discovery-uri="DISCOVERY_URI" ^ --attribute-mapping="google.subject=assertion.sub" ^ --attribute-condition="ATTRIBUTE_CONDITION" ^ --actor-providers="ACTOR_PROVIDERS"
Você receberá uma resposta semelhante a esta:
Create request issued for: [my-oidc-provider] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000011-0123456789abcdef] to complete...done. Created workloadIdentityPoolProvider [my-oidc-provider].
REST
Criar um provedor da AWS
O método projects.locations.workloadIdentityPools.providers.create cria um provedor de pool de Identidade da carga de trabalho da AWS.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de Identidade da carga de trabalho ao qual o provedor será adicionado, por exemplo,my-pool.PROVIDER_ID: um ID exclusivo para o provedor, por exemplo,my-aws-provider. Precisa ter de 4 a 32 caracteres alfanuméricos minúsculos ou hifens e não pode começar comgcp-.DISPLAY_NAME: opcional. Um nome de exibição para o provedor, com até 32 caracteres, por exemplo,My AWS provider.AWS_ACCOUNT_ID: o ID de 12 dígitos da sua conta da AWS, por exemplo,123456789012.ATTRIBUTE_CONDITION: opcional. Uma expressão da Common Expression Language (CEL) que restringe quais identidades podem ser autenticadas, por exemplo,attribute.aws_role == 'arn:aws:sts::123456789012:assumed-role/my-role'.
Método HTTP e URL:
POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers?workloadIdentityPoolProviderId=PROVIDER_ID
Corpo JSON da solicitação:
{
"displayName": "DISPLAY_NAME",
"aws": {
"accountId": "AWS_ACCOUNT_ID"
},
"attributeCondition": "ATTRIBUTE_CONDITION"
}
Para enviar a solicitação, expanda uma destas opções:
A resposta contém uma operação de longa duração que representa a solicitação. Para verificar se a criação do provedor foi concluída, consulte Verificar o status de uma operação de longa duração nesta página.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000010-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
},
"done": false
}
Criar um provedor do OIDC
O método
projects.locations.workloadIdentityPools.providers.create
cria um provedor de pool de Identidade da carga de trabalho do OIDC.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de Identidade da carga de trabalho ao qual o provedor será adicionado, por exemplo,my-pool.PROVIDER_ID: um ID exclusivo para o provedor, por exemplo,my-oidc-provider. Precisa ter de 4 a 32 caracteres alfanuméricos minúsculos ou hifens e não pode começar comgcp-.DISPLAY_NAME: opcional. Um nome de exibição para o provedor, com até 32 caracteres, por exemplo,My OIDC provider.ISSUER_URI: o URL HTTPS do emissor do OIDC, por exemplo,https://idp.example.comouhttps://sts.windows.net/AZURE_TENANT_ID.DISCOVERY_URI: Opcional. O URL para buscar o documento de descoberta do OIDC, substituindo o URL padrãoISSUER_URI/.well-known/openid-configuration, por exemplo,https://idp.example.com/.well-known/custom-openid-configuration. O esquema, o host e a porta precisam corresponder aISSUER_URI, e o caminho precisa conter um segmento/.well-known/seguido por um sufixo não vazio.ATTRIBUTE_CONDITION: opcional. Uma expressão da Common Expression Language (CEL) que restringe quais identidades podem ser autenticadas, por exemplo,assertion.sub.startsWith('repo:my-org/').ACTOR_PROVIDERS: Opcional. Os nomes de recursos completos de até três provedores de pool de Identidade da carga de trabalho no mesmo pool que estão autorizados a emitir tokens de ator para esse provedor, por exemplo,projects/my-project/locations/global/workloadIdentityPools/my-pool/providers/my-actor-provider. O identificador do projeto em cada nome de recurso precisa corresponder ao ID do projeto ou ao formato do número do projeto que você usa para esse provedor. Para mais informações, consulte Configurar delegação de identidade e tokens de ator.
Método HTTP e URL:
POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers?workloadIdentityPoolProviderId=PROVIDER_ID
Corpo JSON da solicitação:
{
"displayName": "DISPLAY_NAME",
"oidc": {
"issuerUri": "ISSUER_URI",
"discoveryUri": "DISCOVERY_URI"
},
"attributeMapping": {
"google.subject": "assertion.sub"
},
"attributeCondition": "ATTRIBUTE_CONDITION",
"actorProviders": [
"ACTOR_PROVIDERS"
]
}
Para enviar a solicitação, expanda uma destas opções:
A resposta contém uma operação de longa duração que representa a solicitação. Para verificar se a criação do provedor foi concluída, consulte Verificar o status de uma operação de longa duração nesta página.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000011-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
},
"done": false
}
Listar provedores
Para listar os provedores de pool de identidade da carga de trabalho em um projeto, faça o seguinte:
Console
-
No console do Google Cloud , acesse a página Pools de Identidade da carga de trabalho.
- Para visualizar os provedores de um pool de Identidade da carga de trabalho, clique no ícone Expandir nó do pool.
gcloud
O comando gcloud iam workload-identity-pools providers list lista os provedores em um pool de Identidade da carga de trabalho.
Antes de usar os dados do comando abaixo, faça estas substituições:
PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.-
POOL_ID: o ID do pool de Identidade da carga de trabalho com os provedores que você quer listar, por exemplo,my-pool. Para incluir provedores com exclusão reversível na saída, adicione a flag--show-deleted.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam workload-identity-pools providers list \ --project=PROJECT_ID \ --location="global" \ --workload-identity-pool="POOL_ID" \ --format="json"
Windows (PowerShell)
gcloud iam workload-identity-pools providers list ` --project=PROJECT_ID ` --location="global" ` --workload-identity-pool="POOL_ID" ` --format="json"
Windows (cmd.exe)
gcloud iam workload-identity-pools providers list ^ --project=PROJECT_ID ^ --location="global" ^ --workload-identity-pool="POOL_ID" ^ --format="json"
Você receberá uma resposta semelhante a esta:
[
{
"attributeMapping": {
"google.subject": "assertion.sub"
},
"displayName": "My OIDC provider",
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
"oidc": {
"issuerUri": "https://idp.example.com"
},
"state": "ACTIVE"
}
]
REST
O método projects.locations.workloadIdentityPools.providers.list lista os provedores em um pool de Identidade da carga de trabalho.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.-
POOL_ID: o ID do pool de Identidade da carga de trabalho com os provedores que você quer listar, por exemplo,my-pool. Para incluir provedores excluídos de maneira reversível na resposta, anexe?showDeleted=trueao URL da solicitação.
Método HTTP e URL:
GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{
"workloadIdentityPoolProviders": [
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
"displayName": "My OIDC provider",
"state": "ACTIVE",
"attributeMapping": {
"google.subject": "assertion.sub"
},
"oidc": {
"issuerUri": "https://idp.example.com"
}
}
]
}
Acessar um provedor
Para ver detalhes de um provedor de pool de Identidade da carga de trabalho específico, faça o seguinte:
Console
-
No console do Google Cloud , acesse a página Pools de Identidade da carga de trabalho.
- Encontre o pool de Identidade da carga de trabalho que contém o provedor e clique no ícone Expandir nó do pool.
- Encontre o provedor de pool de Identidade da carga de trabalho que você quer visualizar e clique no ícone Editar. O console do Google Cloud mostra informações detalhadas sobre o provedor.
gcloud
O comando gcloud iam workload-identity-pools providers describe recebe detalhes sobre um provedor de pool de Identidade da carga de trabalho.
Antes de usar os dados do comando abaixo, faça estas substituições:
PROVIDER_ID: o ID do provedor do pool de Identidade da carga de trabalho, por exemplo,my-oidc-provider.PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de Identidade da carga de trabalho que contém o provedor, por exemplo,my-pool.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam workload-identity-pools providers describe PROVIDER_ID \ --project=PROJECT_ID \ --location="global" \ --workload-identity-pool="POOL_ID" \ --format="json"
Windows (PowerShell)
gcloud iam workload-identity-pools providers describe PROVIDER_ID ` --project=PROJECT_ID ` --location="global" ` --workload-identity-pool="POOL_ID" ` --format="json"
Windows (cmd.exe)
gcloud iam workload-identity-pools providers describe PROVIDER_ID ^ --project=PROJECT_ID ^ --location="global" ^ --workload-identity-pool="POOL_ID" ^ --format="json"
Você receberá uma resposta semelhante a esta:
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
"displayName": "My OIDC provider",
"state": "ACTIVE",
"attributeMapping": {
"google.subject": "assertion.sub"
},
"oidc": {
"issuerUri": "https://idp.example.com"
}
}
REST
O método
projects.locations.workloadIdentityPools.providers.get
recebe detalhes sobre um provedor de pool de identidade da carga de trabalho.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de Identidade da carga de trabalho que contém o provedor, por exemplo,my-pool.PROVIDER_ID: o ID do provedor do pool de Identidade da carga de trabalho, por exemplo,my-oidc-provider.
Método HTTP e URL:
GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
"displayName": "My OIDC provider",
"state": "ACTIVE",
"attributeMapping": {
"google.subject": "assertion.sub"
},
"oidc": {
"issuerUri": "https://idp.example.com"
}
}
Atualizar um provedor
É possível ativar ou desativar um provedor de pool de Identidade da carga de trabalho. Também é possível atualizar as informações da conta e o mapeamento de atributos, além do nome de exibição e descrição.
Para atualizar um provedor de pools de identidade da carga de trabalho atual, faça o seguinte:
Console
No console do Google Cloud , acesse a página Pools de Identidade da carga de trabalho.
Encontre o pool de identidades da carga de trabalho que contém o provedor e clique no ícone Expandir nó do pool.
Encontre o provedor de pool de Identidade da carga de trabalho que você quer editar e clique no ícone Editar.
Edite as informações do provedor e clique em Salvar.
gcloud
Atualizar um provedor da AWS
O comando gcloud iam workload-identity-pools providers update-aws atualiza um provedor de pool de Identidade da carga de trabalho da AWS.
Antes de usar os dados do comando abaixo, faça estas substituições:
PROVIDER_ID: o ID do provedor a ser atualizado, por exemplo,my-aws-provider.PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de Identidade da carga de trabalho que contém o provedor, por exemplo,my-pool.DISPLAY_NAME: um nome de exibição para o provedor, com até 32 caracteres, por exemplo,Updated AWS provider.-
DESCRIPTION: uma descrição do provedor, com até 256 caracteres. Para desativar ou ativar o provedor, transmita também a flag--disabledou--no-disabled.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam workload-identity-pools providers update-aws PROVIDER_ID \ --project=PROJECT_ID \ --location="global" \ --workload-identity-pool="POOL_ID" \ --display-name="DISPLAY_NAME" \ --description="DESCRIPTION"
Windows (PowerShell)
gcloud iam workload-identity-pools providers update-aws PROVIDER_ID ` --project=PROJECT_ID ` --location="global" ` --workload-identity-pool="POOL_ID" ` --display-name="DISPLAY_NAME" ` --description="DESCRIPTION"
Windows (cmd.exe)
gcloud iam workload-identity-pools providers update-aws PROVIDER_ID ^ --project=PROJECT_ID ^ --location="global" ^ --workload-identity-pool="POOL_ID" ^ --display-name="DISPLAY_NAME" ^ --description="DESCRIPTION"
Você receberá uma resposta semelhante a esta:
Update request issued for: [my-aws-provider] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000012-0123456789abcdef] to complete...done. Updated workloadIdentityPoolProvider [my-aws-provider].
Atualizar um provedor OIDC
O comando gcloud iam workload-identity-pools providers update-oidc atualiza um provedor de pool de Identidade da carga de trabalho da AWS.
Antes de usar os dados do comando abaixo, faça estas substituições:
PROVIDER_ID: o ID do provedor do OIDC a ser atualizado, por exemplo,my-oidc-provider.PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de Identidade da carga de trabalho que contém o provedor, por exemplo,my-pool.DISPLAY_NAME: um nome de exibição para o provedor, com até 32 caracteres, por exemplo,Updated OIDC provider.DESCRIPTION: uma descrição do provedor, com até 256 caracteres.-
ISSUER_URI: o URL HTTPS do emissor do OIDC, por exemplo,https://idp.example.com. Para desativar ou ativar o provedor, transmita também a flag--disabledou--no-disabled.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID \ --project=PROJECT_ID \ --location="global" \ --workload-identity-pool="POOL_ID" \ --display-name="DISPLAY_NAME" \ --description="DESCRIPTION" \ --issuer-uri="ISSUER_URI"
Windows (PowerShell)
gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID ` --project=PROJECT_ID ` --location="global" ` --workload-identity-pool="POOL_ID" ` --display-name="DISPLAY_NAME" ` --description="DESCRIPTION" ` --issuer-uri="ISSUER_URI"
Windows (cmd.exe)
gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID ^ --project=PROJECT_ID ^ --location="global" ^ --workload-identity-pool="POOL_ID" ^ --display-name="DISPLAY_NAME" ^ --description="DESCRIPTION" ^ --issuer-uri="ISSUER_URI"
Você receberá uma resposta semelhante a esta:
Update request issued for: [my-oidc-provider] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000013-0123456789abcdef] to complete...done. Updated workloadIdentityPoolProvider [my-oidc-provider].
REST
O método projects.locations.workloadIdentityPools.providers.patch atualiza um provedor de pool de Identidade da carga de trabalho.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de Identidade da carga de trabalho que contém o provedor, por exemplo,my-pool.PROVIDER_ID: o ID do provedor a ser atualizado, por exemplo,my-aws-provider.UPDATE_MASK: uma lista separada por vírgulas de campos a serem atualizados, por exemplo,displayName,description,disabled.DISPLAY_NAME: um nome de exibição para o provedor, com até 32 caracteres, por exemplo,Updated AWS provider.DESCRIPTION: uma descrição do provedor, com até 256 caracteres.DISABLED: se o provedor está desativado. Defina comotruepara desativar o provedor oufalsepara ativá-lo.
Método HTTP e URL:
PATCH https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID?updateMask=UPDATE_MASK
Corpo JSON da solicitação:
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION",
"disabled": DISABLED
}
Para enviar a solicitação, expanda uma destas opções:
A resposta contém uma operação de longa duração que representa a solicitação. Para verificar se a atualização do provedor foi concluída, consulte Verificar o status de uma operação de longa duração nesta página.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000012-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
},
"done": false
}
Excluir um provedor
Quando você exclui um provedor de pool de Identidade da carga de trabalho, as identidades dele perdem o acesso aos recursos do Google Cloud .
É possível cancelar a exclusão de um provedor até 30 dias após a exclusão. Após 30 dias, a exclusão é permanente. Até que um provedor seja excluído permanentemente, não é possível reutilizar o nome dele ao criar um novo provedor.
Para excluir um provedor de pool de Identidade da carga de trabalho, faça o seguinte:
Console
No console do Google Cloud , acesse a página Pools de Identidade da carga de trabalho.
Encontre o pool de identidade da carga de trabalho que contém o provedor e clique no Nome de exibição dele.
No painel Provedores, encontre o provedor que você quer excluir e clique no ícone Excluir.
Clique em Excluir para excluir o provedor.
gcloud
O comando gcloud iam workload-identity-pools providers delete exclui um provedor de pool de Identidade da carga de trabalho.
Antes de usar os dados do comando abaixo, faça estas substituições:
PROVIDER_ID: o ID do provedor do pool de Identidade da carga de trabalho a ser excluído, por exemplo,my-oidc-provider.PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de Identidade da carga de trabalho que contém o provedor, por exemplo,my-pool.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam workload-identity-pools providers delete PROVIDER_ID \ --project=PROJECT_ID \ --location="global" \ --workload-identity-pool="POOL_ID"
Windows (PowerShell)
gcloud iam workload-identity-pools providers delete PROVIDER_ID ` --project=PROJECT_ID ` --location="global" ` --workload-identity-pool="POOL_ID"
Windows (cmd.exe)
gcloud iam workload-identity-pools providers delete PROVIDER_ID ^ --project=PROJECT_ID ^ --location="global" ^ --workload-identity-pool="POOL_ID"
Você receberá uma resposta semelhante a esta:
Delete request issued for: [my-oidc-provider] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000014-0123456789abcdef] to complete...done. Deleted workloadIdentityPoolProvider [my-oidc-provider].
REST
O método projects.locations.workloadIdentityPools.providers.delete exclui um provedor de pool de Identidade da carga de trabalho.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de Identidade da carga de trabalho que contém o provedor, por exemplo,my-pool.PROVIDER_ID: o ID do provedor do pool de Identidade da carga de trabalho a ser excluído, por exemplo,my-oidc-provider.
Método HTTP e URL:
DELETE https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID
Para enviar a solicitação, expanda uma destas opções:
A resposta contém uma operação de longa duração que representa a solicitação. Para verificar se a exclusão do provedor foi concluída, consulte Verificar o status de uma operação de longa duração nesta página.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000014-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
},
"done": false
}
Cancelar a exclusão de um provedor
É possível recuperar um provedor de pool de Identidade da carga de trabalho excluído até 30 dias após a exclusão. Para cancelar a exclusão de um provedor, siga estas etapas:
Console
No console do Google Cloud , acesse a página Pools de Identidade da carga de trabalho.
Clique no botão Mostrar provedores e pools excluídos.
Encontre o pool de identidades da carga de trabalho que contém o provedor e clique no ícone Expandir nó do pool.
Encontre o provedor que você quer restaurar e clique no ícone Restaurar.
Clique em Restaurar. O provedor é restaurado.
gcloud
O comando gcloud iam workload-identity-pools providers undelete restaura um provedor de pool de Identidade da carga de trabalho que foi excluído de forma reversível.
Antes de usar os dados do comando abaixo, faça estas substituições:
PROVIDER_ID: o ID do provedor do pool de Identidade da carga de trabalho excluído a ser restaurado, por exemplo,my-oidc-provider.PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de Identidade da carga de trabalho que contém o provedor, por exemplo,my-pool.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam workload-identity-pools providers undelete PROVIDER_ID \ --project=PROJECT_ID \ --location="global" \ --workload-identity-pool="POOL_ID"
Windows (PowerShell)
gcloud iam workload-identity-pools providers undelete PROVIDER_ID ` --project=PROJECT_ID ` --location="global" ` --workload-identity-pool="POOL_ID"
Windows (cmd.exe)
gcloud iam workload-identity-pools providers undelete PROVIDER_ID ^ --project=PROJECT_ID ^ --location="global" ^ --workload-identity-pool="POOL_ID"
Você receberá uma resposta semelhante a esta:
Undelete request issued for: [my-oidc-provider] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000015-0123456789abcdef] to complete...done. Undeleted workloadIdentityPoolProvider [my-oidc-provider].
REST
O método projects.locations.workloadIdentityPools.providers.undelete restaura um provedor de pool de Identidade da carga de trabalho que foi excluído de forma reversível.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID: o ID do projeto do Google Cloud . Os IDs do projeto são strings alfanuméricas, comomy-project.POOL_ID: o ID do pool de Identidade da carga de trabalho que contém o provedor, por exemplo,my-pool.PROVIDER_ID: o ID do provedor do pool de Identidade da carga de trabalho excluído a ser restaurado, por exemplo,my-oidc-provider.
Método HTTP e URL:
POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID:undelete
Corpo JSON da solicitação:
{}
Para enviar a solicitação, expanda uma destas opções:
A resposta contém uma operação de longa duração que representa a solicitação. Para verificar se a restauração do provedor foi concluída, consulte Verificar o status de uma operação de longa duração nesta página.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000015-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
},
"done": false
}
Verificar o status de uma operação de longa duração
Quando você usa a API REST, qualquer método que cria, atualiza, exclui ou restaura um pool ou provedor de identidade da carga de trabalho retorna uma operação de longa duração (LRO). A operação de longa duração rastreia o status da solicitação e indica se a alteração foi concluída.
gcloud
O comando gcloud iam workload-identity-pools operations describe retorna o status de uma operação de longa duração.
Antes de usar os dados do comando abaixo, faça estas substituições:
-
OPERATION_NAME: o nome completo do recurso da operação do camponameda resposta original:-
Operações de pool:
projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/operations/OPERATION_ID -
Operações do provedor:
projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID/operations/OPERATION_ID
Para operações de provedor, execute o comando
gcloud iam workload-identity-pools providers operations describe. -
Operações de pool:
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam workload-identity-pools operations describe OPERATION_NAME
Windows (PowerShell)
gcloud iam workload-identity-pools operations describe OPERATION_NAME
Windows (cmd.exe)
gcloud iam workload-identity-pools operations describe OPERATION_NAME
Você receberá uma resposta semelhante a esta:
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPool",
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
"displayName": "My workload pool",
"description": "Workload identity pool for external workloads.",
"state": "ACTIVE"
}
}
REST
O método projects.locations.workloadIdentityPools.operations.get retorna o status de uma operação de longa duração.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
-
OPERATION_NAME: o nome completo do recurso da operação do camponameda resposta original:-
Operações de pool:
projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/operations/OPERATION_ID -
Operações do provedor:
projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID/operations/OPERATION_ID
-
Operações de pool:
Método HTTP e URL:
GET https://iam.googleapis.com/v1/OPERATION_NAME
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPool",
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
"displayName": "My workload pool",
"description": "Workload identity pool for external workloads.",
"state": "ACTIVE"
}
}
Se o campo done da operação for false ou omitido, continue monitorando o status dela recebendo a operação repetidamente. Use a
espera exponencial truncada para introduzir um atraso entre
as solicitações. Quando o campo done estiver definido como true, a operação será concluída.
Gerenciar restrições gerenciadas para a federação de identidade da carga de trabalho
É possível usar restrições de política da organização para restringir como os recursos na sua organização do Google Cloud podem ser usados.
Nesta seção, descrevemos as restrições recomendadas ao usar a federação de identidade da carga de trabalho.
Gerenciar IdPs permitidos
Como administrador da organização, você pode decidir com quais IdPs sua organização pode se federar.
Para gerenciar quais IdPs são permitidos, ative a restrição de lista constraints/iam.workloadIdentityPoolProviders na política da organização. Essa restrição especifica os URIs do emissor dos provedores permitidos. Use o
console doGoogle Cloud ou a
Google Cloud CLI para ativar essa restrição.
Para permitir somente a federação da AWS, crie uma única restrição com o URI
https://sts.amazonaws.com. O exemplo a seguir mostra como criar essa
restrição usando a CLI gcloud:
gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \ https://sts.amazonaws.com --organization=ORGANIZATION_NUMBER
Também é possível especificar quais IDs de conta da AWS têm acesso aos seus recursos doGoogle Cloud . Para especificar os IDs das contas, use a
restrição de lista constraints/iam.workloadIdentityPoolAwsAccounts:
gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolAwsAccounts \ ACCOUNT_ID --organization=ORGANIZATION_NUMBER
Para permitir a federação de apenas um provedor OIDC, crie uma restrição única com
o issuer_uri do provedor permitido. O exemplo a seguir só permite a
federação de um locatário Azure específico:
gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \ https://sts.windows.net/AZURE_TENANT_ID --organization=ORGANIZATION_NUMBER
A federação de um IdP SAML é especial porque as chaves públicas usadas para validar a declaração são fornecidas quando o IdP SAML é configurado. Como resultado, é possível que um usuário mal-intencionado tente fazer upload de um documento de metadados SAML com o ID da entidade do IdP da sua organização usando uma chave pública. A restrição da federação usando um ID de entidade nesse cenário oferece apenas uma ilusão de segurança.
Para mitigar esse risco, recomendamos que você permita apenas que um pool de Identidade da carga de trabalho seja criado com a federação SAML em um projeto do Google Cloud gerenciado de forma centralizada pela sua organização. Em seguida, conforme necessário, conceda às identidades externas nesse pool de Identidade da carga de trabalho acesso aos recursos em toda a organização.
Para permitir a federação de IdPs SAML, crie uma restrição
que permita a palavra-chave especial KEY_UPLOAD.
gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \ KEY_UPLOAD --organization=ORGANIZATION_NUMBER
Repita esses comandos para permitir a federação de outros provedores.
Para bloquear a federação de todos os provedores:
Crie um arquivo YAML contendo o seguinte:
constraint: constraints/iam.workloadIdentityPoolProviders listPolicy: allValues: DENY
Transmita o arquivo para o comando
gcloud resource-manager org-policies set-policy:gcloud resource-manager org-policies set-policy FILE_NAME.yaml \ --organization=ORGANIZATION_NUMBER
Restringir criação da chave da conta de serviço
Com a federação de identidade da carga de trabalho, é possível acessar recursos do Google Cloud de fora do Google Cloud sem usar uma chave de conta de serviço. Se você nunca usa chaves de conta de serviço para se autenticar, é possível reduzir o risco desativando a criação de chaves.
Para desativar a criação de chaves de conta de serviço, aplique a restrição booleana iam.disableServiceAccountKeyCreation na política da organização. Também é possível aplicar a restrição booleana iam.disableServiceAccountKeyUpload, que desativa o upload de chaves públicas para contas de serviço.
Use o console doGoogle Cloud ou a CLI gcloud para ativar essas restrições. Por exemplo, os seguintes comandos da CLI gcloud ativam as duas restrições:
gcloud resource-manager org-policies enable-enforce \ constraints/iam.disableServiceAccountKeyCreation \ --organization=ORGANIZATION_NUMBER gcloud resource-manager org-policies enable-enforce \ constraints/iam.disableServiceAccountKeyUpload \ --organization=ORGANIZATION_NUMBER
Monitorar a federação de identidade da carga de trabalho
É possível usar as métricas do Cloud Monitoring para monitorar eventos de autenticação dos pools e provedores de identidades da carga de trabalho. Para uma lista de métricas disponíveis, consulte Métricas do IAM.
A seguir
Saiba mais sobre a federação de identidade da carga de trabalho.