Configurar a autenticação de identidade da carga de trabalho gerenciada para o Compute Engine

Para estabelecer conexões TLS mútuas (mTLS) entre cargas de trabalho do Compute Engine, use a CLI gcloud para configurar identidades da carga de trabalho gerenciadas e definir o provisionamento automático e o gerenciamento do ciclo de vida de certificados. Para emitir certificados, use uma autoridade certificadora (AC) padrão gerenciada pelo Google ou uma AC autogerenciada com o Certificate Authority Service.

Antes de começar

  1. Crie ou selecione um projeto do Google Cloud .

    Papéis necessários para selecionar ou criar um projeto

    • Selecionar um projeto: para selecionar um projeto, não é necessário ter um papel específico do IAM. É possível selecionar qualquer projeto em que você tenha um papel.
    • Criar um projeto: para criar um projeto, é preciso ter o papel de Criador de projetos (roles/resourcemanager.projectCreator), que contém a permissão resourcemanager.projects.create. Saiba como conceder papéis.
    • Crie um projeto do Google Cloud :

      gcloud projects create PROJECT_ID

      Substitua PROJECT_ID por um nome para o projeto do Google Cloud que você está criando.

    • Selecione o projeto do Google Cloud que você criou:

      gcloud config set project PROJECT_ID

      Substitua PROJECT_ID pelo nome do projeto do Google Cloud .

  2. Entenda as identidades das cargas de trabalho gerenciadas.

  3. Saiba mais sobre a emissão de certificados usando o Certificate Authority Service.

  4. Saiba como autenticar cargas de trabalho do Compute Engine usando identidades de carga de trabalho gerenciadas.

  5. Ative as APIs do IAM e do Certificate Authority Service, se ainda não estiverem ativadas:

    Funções necessárias para ativar APIs

    Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de proprietário (roles/owner). Caso contrário, é possível conseguir essa permissão pelo papel de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

    gcloud services enable iam.googleapis.com privateca.googleapis.com

  6. Configure a CLI do Google Cloud para usar um projeto para faturamento e cota.

    gcloud config set billing/quota_project PROJECT_ID
    

    Substitua PROJECT_ID pelo ID do projeto.

Funções exigidas

Para receber as permissões necessárias para criar identidades de cargas de trabalho gerenciadas e provisionar certificados de identidade de carga de trabalho gerenciada, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Como alternativa, o papel básico de Proprietário do IAM (roles/owner) também inclui permissões para configurar identidades de carga de trabalho gerenciada. Não conceda papéis básicos em um ambiente de produção, recomendamos que você faça isso em um ambiente de desenvolvimento ou teste.

Visão geral

Para usar identidades de carga de trabalho gerenciada nos aplicativos, execute as tarefas a seguir:

  1. Administrador de segurança:

  2. Administrador de computação:

    Ative as identidades das cargas de trabalho gerenciadas para cargas de trabalho em execução no Compute Engine:

Criar um pool de identidade da carga de trabalho

  1. Para configurar identidades de carga de trabalho gerenciadas, é preciso criar um pool no modo TRUST_DOMAIN.

    gcloud iam workload-identity-pools create POOL_ID \
      --location="global" \
      --mode="TRUST_DOMAIN"
    

    Substitua POOL_ID pelo ID exclusivo do pool. O ID precisa ter entre 4 e 32 caracteres, incluir apenas caracteres alfanuméricos minúsculos e traços, além de começar e terminar com um caractere alfanumérico. Depois de criar um pool de Identidade da carga de trabalho, não é possível alterar o ID dele.

  2. Para verificar se o pool de identidade da carga de trabalho foi criado no modo TRUST_DOMAIN, execute o comando workload-identity-pools describe.

    gcloud iam workload-identity-pools describe POOL_ID \
      --location="global"
    

    O resultado será o seguinte:

    mode: TRUST_DOMAIN
    name: projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID
    state: ACTIVE
    

    Se mode: TRUST_DOMAIN não estiver presente na resposta ao comando, verifique se você configurou corretamente a CLI gcloud para usar o projeto correto para faturamento e cota. Verifique se você atualizou para a versão mais recente da CLI gcloud.

Escolha uma opção de CA

Para assinar os certificados de carga de trabalho, escolha a opção de autoridade certificadora (CA) que melhor se adapta ao seu caso de uso:

  • AC padrão gerenciada pelo Google: use esta opção para uma solução totalmente gerenciada e sem custo financeiro. A AC padrão fornece uma raiz de confiança compartilhada para todos os usuários doGoogle Cloud .

  • CA personalizada: use esta opção para configurar sua própria infraestrutura de chave pública (ICP) pelo Certificate Authority Service. Essa opção é adequada se você precisar de uma raiz de confiança personalizada ou se precisar armazenar chaves de assinatura em um módulo de segurança de hardware (HSM) para atender aos requisitos de conformidade. O Certificate Authority Service é cobrado separadamente da identidade da carga de trabalho gerenciada. Para mais informações, consulte Preços do CA Service.

Configurar uma CA

CA padrão

Para vincular a CA padrão ao pool de Identidade da carga de trabalho, atualize o pool com a flag use-default-shared-ca.

gcloud iam workload-identity-pools update TRUST_DOMAIN_NAME \
    --location="global" \
    --use-default-shared-ca \
    --project=PROJECT_ID

Substitua:

  • TRUST_DOMAIN_NAME: o nome do domínio de confiança.
  • PROJECT_ID: o ID do projeto.

AC personalizada

Para configurar identidades de cargas de trabalho gerenciadas usando uma CA personalizada, siga estas etapas:

  1. Configure o CA Service para emitir certificados para identidades de cargas de trabalho gerenciadas.
  2. Vincule as CAs ao pool de Identidade da carga de trabalho.
  3. Autorize que identidades das cargas de trabalho gerenciadas solicitem certificados do pool de ACs.

Configurar o CA Service para emitir certificados para identidades de cargas de trabalho gerenciadas

Crie a configuração recomendada para autoridades de certificação (CAs) raiz e subordinadas usando pools do Certificate Authority Service. O pool de CA subordinada emite os certificados de identidade da carga de trabalho X.509 para as VMs.

Os pools de CA configurados para emitir certificados para VMs do Compute Engine usando identidades de carga de trabalho gerenciadas precisam residir na mesma região que a VM. Se você quiser projetar uma arquitetura multirregional para resiliência a interrupções regionais, recomendamos configurar um pool de CAs subordinado do Certificate Authority Service para cada uma das regiões da carga de trabalho. Dessa forma, cada uma das VMs do Compute Engine pode referenciar um pool de CAs subordinado do Certificate Authority Service na região.

Depois de configurar os pools de CAs, você autoriza as identidades de carga de trabalho gerenciadas a solicitar e receber os certificados assinados dos pools de CAs.

Configurar o pool de CAs raiz

Use a interface da CLI do Google Cloud para o Certificate Authority Service e configure um pool de CAs raiz.

Não é possível mover ou exportar um pool de CAs depois que ele é criado.

  1. Crie o pool de CAs raiz no nível Enterprise executando o comando gcloud privateca pools create. O nível Enterprise é destinado à emissão de certificados de longa duração e baixo volume.

    gcloud privateca pools create ROOT_CA_POOL_ID \
       --location=REGION \
       --tier=enterprise
    

    Substitua:

    • ROOT_CA_POOL_ID: um ID exclusivo para o pool de ACs raiz. O ID pode ter até 64 caracteres e precisa conter apenas caracteres alfanuméricos minúsculos e maiúsculos, sublinhados ou hifens. O ID do pool precisa ser exclusivo na região.
    • REGION: a região em que o pool de ACs raiz está localizado.

    Para mais informações, consulte Como criar pools de CAs.

  2. Crie uma CA raiz no pool de CAs raiz executando o comando gcloud privateca roots create. Talvez você precise ativar a AC raiz se essa for a única AC no pool de CAs raiz.

    Por exemplo, é possível usar um comando semelhante ao seguinte para criar uma AC raiz.

    gcloud privateca roots create ROOT_CA_ID \
       --pool=ROOT_CA_POOL_ID \
       --subject "CN=ROOT_CA_CN, O=ROOT_CA_ORGANIZATION" \
       --key-algorithm="ec-p256-sha256" \
       --max-chain-length=1 \
       --location=REGION
    

    Substitua:

    • ROOT_CA_ID: um nome exclusivo para a CA raiz. O nome da CA pode ter até 64 caracteres e precisa conter apenas caracteres alfanuméricos minúsculos e maiúsculos, sublinhados ou hifens. O nome da AC precisa ser exclusivo na região.
    • ROOT_CA_POOL_ID: o ID do pool de ACs raiz.
    • ROOT_CA_CN: o nome comum da CA raiz
    • ROOT_CA_ORGANIZATION: a organização da CA raiz.
    • REGION: a região em que o pool de ACs raiz está localizado.

    Para mais informações, consulte Criar uma autoridade certificadora raiz. Para mais informações sobre os campos subject da AC, consulte Assunto.

  3. Opcional: repita as etapas anteriores para criar outra CA raiz no pool de CAs raiz. Isso pode ser útil para rotação de CA raiz.

Configurar as CAs subordinadas

Use a interface da CLI do Google Cloud para o Certificate Authority Service e criar um pool de CAs subordinados e uma CA subordinada.

Se você tiver vários cenários de emissão de certificados, poderá criar uma CA subordinada para cada um deles. Além disso, adicionar várias ACs subordinadas a um pool de ACs ajuda você a conseguir um melhor balanceamento de carga das solicitações de certificado.

Use o comando gcloud privateca pools create para criar um pool de CAs subordinadas.

  1. Crie o pool de CA subordinada no nível DevOps. Esse nível é destinado à emissão de certificados de alto volume e curta duração.

    gcloud privateca pools create SUBORDINATE_CA_POOL_ID \
      --location=REGION \
      --tier=devops
    

    Substitua:

    • SUBORDINATE_CA_POOL_ID: um ID exclusivo para o pool de ACs subordinadas. O ID pode ter até 64 caracteres e precisa conter apenas caracteres alfanuméricos minúsculos e maiúsculos, sublinhados ou hifens. O ID do pool precisa ser exclusivo na região.
    • REGION: a região na qual criar o pool de CAs subordinadas.

    Para mais informações, consulte Como criar pools de CAs.

  2. Crie uma CA subordinada no pool de CAs subordinadas executando o comando gcloud privateca subordinates create. Não altere o modo de emissão baseado em configuração padrão.

    Por exemplo, é possível usar um comando semelhante ao seguinte para criar uma CA subordinada.

    gcloud privateca subordinates create SUBORDINATE_CA_ID \
      --pool=SUBORDINATE_CA_POOL_ID \
      --location=REGION \
      --issuer-pool=ROOT_CA_POOL_ID \
      --issuer-location=REGION \
      --subject="CN=SUBORDINATE_CA_CN, O=SUBORDINATE_CA_ORGANIZATION" \
      --key-algorithm="ec-p256-sha256" \
      --use-preset-profile=subordinate_mtls_pathlen_0
    

    Substitua:

    • SUBORDINATE_CA_ID: um nome exclusivo para a CA subordinada. O nome pode ter até 64 caracteres e precisa conter apenas caracteres alfanuméricos minúsculos e maiúsculos, sublinhados ou hifens. O nome da AC precisa ser exclusivo na região.
    • SUBORDINATE_CA_POOL_ID: o nome do pool de CAs subordinadas.
    • REGION: a região em que o pool de ACs subordinadas está localizado.
    • ROOT_CA_POOL_ID: o ID do pool de ACs raiz.
    • REGION: a região do pool de ACs raiz.
    • SUBORDINATE_CA_CN: o nome comum da CA subordinada.
    • SUBORDINATE_CA_ORGANIZATION: o nome da organização emissora de CA subordinada.

    Para mais informações, consulte Como criar pools de CAs. Para mais informações sobre os campos subject da AC, consulte Assunto.

Vincular as CAs ao pool de Identidade da carga de trabalho

Depois de criar a hierarquia de ACs, vincule-as ao pool de Identidade da carga de trabalho atualizando o pool com cada uma das configurações de emissão de certificado da AC.

  1. Crie um arquivo issuance-config.yaml com o seguinte conteúdo:

    inlineCertificateIssuanceConfig:
    caPools:
    REGION: projects/PROJECT_ID/locations/REGION/caPools/SUBORDINATE_CA_POOL_ID
    keyAlgorithm: RSA_2048
    lifetime: 86400s
    rotationWindowPercentage: 50

    Substitua o seguinte no arquivo:

    • REGION: a região onde o pool de CAs subordinadas está localizado.
    • PROJECT_ID: o ID do projeto que contém o pool de CAs subordinadas.
    • SUBORDINATE_CA_POOL_ID: o ID do pool de CAs subordinadas.
  2. Execute o seguinte comando para atualizar o pool de Identidade da carga de trabalho:

    gcloud iam workload-identity-pools update POOL_ID \
       --location="global" \
       --inline-certificate-issuance-config-file=ISSUANCE_CONFIG_FILE
    

    Substitua:

    • POOL_ID: o ID exclusivo do pool.
    • ISSUANCE_CONFIG_FILE: o caminho para o arquivo issuance-config.yaml.

Autorizar que identidades das cargas de trabalho gerenciadas solicitem certificados do pool de ACs

As identidades de cargas de trabalho gerenciadas exigem permissões para solicitar certificados do serviço de AC e receber os certificados públicos.

  1. Conceda o papel do IAM de Solicitante de certificado da carga de trabalho de serviço de CA (roles/privateca.workloadCertificateRequester) em cada pool de CA subordinada à identidade da carga de trabalho gerenciada. O comando gcloud privateca pools add-iam-policy-binding a seguir autoriza a identidade da carga de trabalho gerenciada a solicitar certificados das cadeias de certificados de serviço de CA.

    gcloud privateca pools add-iam-policy-binding SUBORDINATE_CA_POOL_ID \
      --location=REGION \
      --role=roles/privateca.workloadCertificateRequester \
      --member="principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/name/locations/global/workloadIdentityPools/POOL_ID/*"
    

    Substitua:

    • SUBORDINATE_CA_POOL_ID: o ID do pool de CA subordinada.
    • REGION: a região do pool de CAs subordinadas
    • PROJECT_NUMBER: o número do projeto que contém o pool de identidade da carga de trabalho
    • POOL_ID: o ID do pool de identidade da carga de trabalho
  2. Conceda o papel do IAM Leitor do pool de serviços da CA (roles/privateca.poolReader) nos pools de CAs subordinadas à identidade da carga de trabalho gerenciada. Isso autoriza a identidade da carga de trabalho gerenciada a receber os certificados X.509 assinados das cadeias de certificados da AC.

    gcloud privateca pools add-iam-policy-binding SUBORDINATE_CA_POOL_ID \
      --location=REGION \
      --role=roles/privateca.poolReader \
      --member="principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/name/locations/global/workloadIdentityPools/POOL_ID/*"
    

    Substitua:

    • SUBORDINATE_CA_POOL_ID: o ID do pool de CA subordinada.
    • REGION: a região do pool de CAs subordinadas
    • PROJECT_NUMBER: o número do projeto que contém o pool de identidade da carga de trabalho
    • POOL_ID: o ID do pool de identidade da carga de trabalho

Criar identidades da carga de trabalho gerenciada

As identidades da carga de trabalho gerenciadas permitem que o Google Cloud provisione automaticamente as credenciais para identidades do pool de Identidade da carga de trabalho nas cargas de trabalho. As identidades da carga de trabalho são definidas em um pool de Identidade da carga de trabalho e organizadas em limites administrativos chamados namespaces.

Criar um namespace

O comando workload-identity-pools namespaces create permite criar um namespace em um pool de Identidade da carga de trabalho.

gcloud iam workload-identity-pools namespaces create NAMESPACE_ID \
    --workload-identity-pool="POOL_ID" \
    --location="global"

Substitua:

  • NAMESPACE_ID: o ID exclusivo do namespace. O ID precisa ter entre 2 e 63 caracteres, conter apenas caracteres alfanuméricos minúsculos e traços, além de começar e terminar com um caractere alfanumérico. Depois de criar um namespace, não será possível alterar o ID dele.
  • POOL_ID: o ID do pool de Identidade da carga de trabalho que você criou anteriormente.

Criar uma identidade da carga de trabalho gerenciada

O comando workload-identity-pools managed-identities create permite criar uma identidade da carga de trabalho gerenciada em um namespace de pool de Identidade da carga de trabalho.

gcloud iam workload-identity-pools managed-identities create MANAGED_IDENTITY_ID \
    --namespace="NAMESPACE_ID" \
    --workload-identity-pool="POOL_ID" \
    --location="global"

Substitua:

  • MANAGED_IDENTITY_ID: o ID exclusivo da identidade gerenciada. O ID precisa ter entre 2 e 63 caracteres, conter apenas caracteres alfanuméricos minúsculos e traços, além de começar e terminar com um caractere alfanumérico. Depois de criar uma identidade da carga de trabalho gerenciada, não é possível alterar o ID dela.
  • NAMESPACE_ID: o ID do namespace que você criou anteriormente.
  • POOL_ID: o ID do pool de Identidade da carga de trabalho que você criou anteriormente.

O ID da identidade da carga de trabalho gerenciada é o identificador SPIFFE, que é formatado da seguinte maneira:

spiffe://POOL_ID.global.PROJECT_NUMBER.workload.id.goog/ns/NAMESPACE_ID/sa/MANAGED_IDENTITY_ID

Definir uma política de atestação de carga de trabalho

Nesta seção, descrevemos como configurar uma política de atestado. Essa política determina quais atributos são usados pelo Google Cloud IAM para verificar a identidade da carga de trabalho. Após a verificação, a carga de trabalho de chamada pode receber uma credencial.

A verificação é baseada em um dos seguintes atributos da carga de trabalho:

  • Endereço de e-mail da conta de serviço anexada
  • UID da conta de serviço anexada
  • Nome da instância da VM
  • ID da instância de VM

Defina uma política de atestado de carga de trabalho com regras de atestado

Para criar uma política de atestado que permita que sua carga de trabalho use a identidade gerenciada, faça o seguinte:

  1. Decida se você quer criar uma política de atestado que permita que sua carga de trabalho ateste a identidade gerenciada usando a conta de serviço anexada, o nome da instância ou o ID da instância.

  2. Crie um arquivo de política de atestado no formato JSON.

    1. Opcional: para receber credenciais X.509 na instância do Compute Engine, ative uma conta de serviço anexada. Recomendamos que você anexe uma nova conta de serviço à carga de trabalho criando-a primeiro com o seguinte comando:

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME
      

      Substitua SERVICE_ACCOUNT_NAME pelo nome da conta de serviço.

    2. Crie um arquivo de política de atestado no formato JSON que ateste com base no endereço de e-mail da conta de serviço, no UID da conta de serviço, no nome da instância ou no ID da instância.

      Endereço de e-mail da conta de serviço

      Para criar um arquivo de política de atestado que atesta com base no endereço de e-mail da conta de serviço, crie um arquivo com o seguinte conteúdo:

      {
         "attestationRules": [
            {
               "googleCloudResource": "//compute.googleapis.com/projects/WORKLOAD_PROJECT_NUMBER/type/Instance/attached_service_account.email/SERVICE_ACCOUNT_EMAIL"
            }
         ],
      }
      

      Substitua:

      • WORKLOAD_PROJECT_NUMBER: o número do projeto que contém a instância de VM ou a conta de serviço.

        Para ver o número do projeto que contém a identidade gerenciada ou a conta de serviço que você acabou de criar, execute o seguinte comando:

        gcloud projects describe $(gcloud config get-value project) \
          --format="value(projectNumber)"
        
      • SERVICE_ACCOUNT_EMAIL: o endereço de e-mail da conta de serviço anexada à VM.

      UID da conta de serviço

      Para criar um arquivo de política de atestado que atesta com base no UID da conta de serviço, crie um arquivo com o seguinte conteúdo:

      {
         "attestationRules": [
            {
               "googleCloudResource": "//compute.googleapis.com/projects/WORKLOAD_PROJECT_NUMBER/type/Instance/attached_service_account.uid/SERVICE_ACCOUNT_UID"
            }
         ],
      }
      

      Substitua:

      • WORKLOAD_PROJECT_NUMBER: o número do projeto que contém a instância de VM ou a conta de serviço.

        Para ver o número do projeto que contém a identidade gerenciada ou a conta de serviço que você acabou de criar, execute o seguinte comando:

        gcloud projects describe $(gcloud config get-value project) \
          --format="value(projectNumber)"
        
      • SERVICE_ACCOUNT_UID: o UID da conta de serviço anexada à VM.

      Para receber o ID exclusivo da conta de serviço, execute o seguinte comando:

         gcloud iam service-accounts describe SERVICE_ACCOUNT_EMAIL\
            --format="value(uniqueId)"
      

      Nome da instância

      Para criar um arquivo de política de atestado que atesta com base no nome da instância, crie um arquivo com o seguinte conteúdo:

      {
         "attestationRules": [
            {
               "googleCloudResource": "//compute.googleapis.com/projects/WORKLOAD_PROJECT_NUMBER/name/zones/ZONE/instances/INSTANCE_NAME"
            }
         ],
      }
      

      Substitua:

      • WORKLOAD_PROJECT_NUMBER: o número do projeto que contém a instância de VM ou a conta de serviço.

        Para ver o número do projeto que contém a identidade gerenciada ou a conta de serviço que você acabou de criar, execute o seguinte comando:

        gcloud projects describe $(gcloud config get-value project) \
          --format="value(projectNumber)"
        
      • ZONE: a zona da VM do Compute Engine.

      • INSTANCE_NAME: o nome de uma instância de VM nova ou atual do Compute Engine.

      ID da instância

      Para criar um arquivo de política de atestado que ateste com base no ID da instância, crie um arquivo com o seguinte conteúdo:

      {
         "attestationRules": [
            {
               "googleCloudResource": "//compute.googleapis.com/projects/WORKLOAD_PROJECT_NUMBER/uid/zones/ZONE/instances/INSTANCE_ID"
            }
         ],
      }
      

      Substitua:

      • WORKLOAD_PROJECT_NUMBER: o número do projeto que contém a instância de VM ou a conta de serviço.

        Para ver o número do projeto que contém a identidade gerenciada ou a conta de serviço que você acabou de criar, execute o seguinte comando:

        gcloud projects describe $(gcloud config get-value project) \
          --format="value(projectNumber)"
        
      • INSTANCE_ID: o ID da instância de VM do Compute Engine.

        O valor de um ID de instância precisa vir de uma instância atual do Compute Engine. Para ver o ID da instância, execute o seguinte comando:

        gcloud compute instances describe INSTANCE_NAME --zone=ZONE --format="get(id)"
        
      • INSTANCE_NAME: o nome da instância de VM do Compute Engine.

      • ZONE: a zona da VM do Compute Engine.

  3. Crie a política de atestado usando o arquivo JSON de política que você criou anteriormente neste documento:

    gcloud iam workload-identity-pools managed-identities set-attestation-rules MANAGED_IDENTITY_ID \
       --namespace=NAMESPACE_ID \
       --workload-identity-pool=POOL_ID \
       --policy-file=PATH_TO_POLICY_JSON_FILE \
       --location=global
    

    Substitua:

    • MANAGED_IDENTITY_ID: o ID exclusivo da identidade gerenciada. O ID precisa ter entre 2 e 63 caracteres, conter apenas caracteres alfanuméricos minúsculos e traços, além de começar e terminar com um caractere alfanumérico. Depois de criar uma identidade da carga de trabalho gerenciada, não é possível alterar o ID dela.
    • NAMESPACE_ID: o ID do namespace que você criou anteriormente.
    • POOL_ID: o ID do pool de Identidade da carga de trabalho que você criou anteriormente.
    • PATH_TO_POLICY_JSON_FILE: caminho para o arquivo JSON que representa a política de atestado que você criou anteriormente.

    Também é possível atualizar a política adicionando ou removendo regras de atestado individualmente. Para adicionar um atestado à sua política de atestado, execute o seguinte comando:

    gcloud iam workload-identity-pools managed-identities add-attestation-rule MANAGED_IDENTITY_ID \
       --namespace=NAMESPACE_ID \
       --workload-identity-pool=POOL_ID \
       --google-cloud-resource='//compute.googleapis.com/projects/WORKLOAD_PROJECT_NUMBER/type/Instance/attached_service_account.uid/SERVICE_ACCOUNT_UID' \
       --location=global
    
  4. Para aprender mais sobre como listar ou remover as regras de atestação, execute os seguintes comandos:

    gcloud iam workload-identity-pools managed-identities list-attestation-rules --help
    gcloud iam workload-identity-pools managed-identities remove-attestation-rule --help
    

Opcional: ativar a federação de confiança entre pools de identidade da carga de trabalho

Para ativar a autenticação mútua para cargas de trabalho em diferentes domínios de confiança, configure a federação de confiança.

  1. Crie um arquivo trust-config.yaml com o seguinte conteúdo:

    inlineTrustConfig:
    additionalTrustBundles:
      POOL_ID.global.PROJECT_NUMBER.workload.id.goog:
         trustAnchors:
         - pemCertificate: "-----BEGIN CERTIFICATE-----\nPEM_ENCODED_CERTIFICATE\n-----END CERTIFICATE-----"

    Substitua o seguinte no arquivo:

    • POOL_ID: o ID do pool de Identidade da carga de trabalho com que você quer fazer a federação.
    • PROJECT_NUMBER: o número do projeto do pool de Identidade da carga de trabalho com que você quer fazer a federação.
    • PEM_ENCODED_CERTIFICATE: o certificado de CA raiz codificado em PEM do pool de Identidade da carga de trabalho com que você quer fazer a federação.
  2. Para atualizar o pool de Identidade da carga de trabalho com a configuração de confiança, execute o seguinte comando:

    gcloud iam workload-identity-pools update POOL_ID \
      --location="global" \
      --inline-trust-config-file=TRUST_CONFIG_FILE
    

    Substitua:

    • POOL_ID: o ID exclusivo do pool.
    • TRUST_CONFIG_FILE: o caminho para o arquivo trust-config.yaml.

A seguir