Nesta página, você vai aprender como adquirir um token de ID do OpenID Connect (OIDC) assinado pelo Google.
Para informações sobre o conteúdo e o ciclo de vida dos tokens de ID, consulte Tokens de ID.
Os tokens de ID podem ser usados em serviços ou aplicativos específicos, que são
especificados pelo valor da declaração aud. Neste documento, usamos o termo
serviço de destino para fazer referência ao serviço ou aplicativo em que o token de ID pode
ser usado para autenticação.
Ao receber o token de ID, é possível incluí-lo em um
cabeçalho Authorization na solicitação para o serviço de destino.
Métodos para ter acesso a um token de ID
Há várias maneiras de acessar um token de ID. Nesta página, descrevemos os seguintes métodos:
- Receber um token de ID do servidor de metadados
- Usar um serviço de conexão para gerar um token de ID
- Gerar um token de ID com a representação de uma conta de serviço
Se você precisa que um token de ID seja aceito por um aplicativo não hospedado no Cloud de Confiance, provavelmente pode usar esses métodos, mas deve determinar as declarações do token de ID exigidas pelo aplicativo.
Receber um token de ID do servidor de metadados
Quando o código está em execução em um recurso que pode ter uma conta de serviço anexada, o servidor de metadados do serviço associado pode, na maioria dos casos, fornecer um token de ID. O servidor de metadados gera tokens de ID para a conta de serviço anexada. Não é possível receber um token de ID do servidor de metadados com base em credenciais de usuário.
É possível receber um token de ID do servidor de metadados quando o código é executado nos seguintes serviços do Cloud de Confiance :
Para recuperar um token de ID do servidor de metadados, consulte o endpoint de identidade da conta de serviço, conforme mostrado no exemplo.
curl
Substitua AUDIENCE pelo URI do serviço de destino,
como http://www.example.com.
curl -H "Metadata-Flavor: Google" \ 'http://metadata/computeMetadata/v1/instance/service-accounts/default/identity?audience=AUDIENCE'
PowerShell
Substitua AUDIENCE pelo URI do serviço de destino,
como http://www.example.com.
$value = (Invoke-RestMethod `
-Headers @{'Metadata-Flavor' = 'Google'} `
-Uri "http://metadata/computeMetadata/v1/instance/service-accounts/default/identity?audience=AUDIENCE")
$value
Java
Para executar o exemplo de código, primeiro siga estas etapas:
- Instale a biblioteca de cliente de autenticação para Java
-
Defina a variável de ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAINcomos3nsapis.fr.
Go
Antes de executar os exemplos de código, defina a variável
de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
Node.js
Para executar o exemplo de código, primeiro siga estas etapas:
- Instale a biblioteca de autenticação do Google para Node.js.
-
Defina a variável de ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAINcomos3nsapis.fr.
Python
Para executar o exemplo de código, primeiro siga estas etapas:
- Instale a biblioteca de autenticação do Google para Python.
-
Defina a variável de ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAINcomos3nsapis.fr.
Ruby
Para executar o exemplo de código, primeiro siga estas etapas:
- Instale a biblioteca de autenticação do Google para Ruby.
-
Defina a variável de ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAINcomos3nsapis.fr.
Usar um serviço de conexão para gerar um token de ID
Alguns serviços do Cloud de Confiance ajudam você a chamar outros serviços. Esses serviços
de conexão podem ajudar a determinar quando a chamada é feita ou gerenciar um fluxo de trabalho que
inclui a chamada ao serviço. Os serviços abaixo podem incluir automaticamente
um token de ID com o valor apropriado para a declaração aud quando iniciam uma chamada
para um serviço que exige um token de ID:
- Pub/Sub
- O Pub/Sub permite a comunicação assíncrona entre serviços. É possível configurar o Pub/Sub para incluir um token de ID com uma mensagem. Para mais informações, consulte Autenticação para assinaturas por push.
Gerar um token de ID com a representação de uma conta de serviço
A identidade temporária de conta de serviço (representação) permite que um principal gere credenciais de curta duração para uma conta de serviço confiável. O principal pode usar essas credenciais para realizar a autenticação como a conta de serviço.
Para que um principal possa representar uma conta de serviço, ele precisa ter um papel do IAM nessa conta que permita a representação. Se o principal for outra conta de serviço, poderá parecer mais fácil fornecer as permissões necessárias diretamente para ele, a fim de que represente a si mesmo. No entanto, essa configuração de autorepresentação cria uma vulnerabilidade de segurança, porque permite que a conta de serviço crie um token de acesso que pode ser atualizado perpetuamente.
A identidade temporária de conta de serviço precisa sempre envolver dois principais: um que representa o autor da chamada e a conta de serviço que está sendo representada, chamada de conta de serviço com privilégios.
Para gerar um token de ID por meio da representação de uma conta de serviço, use o processo geral a seguir.
Para instruções detalhadas, consulte Criar um token de ID.
Identifique ou crie uma conta de serviço para ter os privilégios.
- Consulte a documentação do produto para identificar os papéis necessários para invocar o serviço de destino. Conceda esses papéis à conta de serviço no serviço de destino.
Identifique o principal que executará a representação e configure o Application Default Credentials (ADC) para usar as credenciais do principal.
Para ambientes de desenvolvimento, o principal geralmente é a conta de usuário que você forneceu ao ADC usando a gcloud CLI. No entanto, para execuções em recursos com uma conta de serviço anexada, essa conta de serviço anexada é o principal.
Conceda ao principal o papel de Criador de tokens de identidade do OpenID Connect na conta de serviço (
roles/iam.serviceAccountOpenIdTokenCreator).Use a API IAM Credentials para gerar o token de ID da conta de serviço autorizada.
Substitua:
- AUDIENCE: o URI do serviço de destino, como
http://www.example.com. - SERVICE_ACCOUNT_EMAIL: o endereço de e-mail da conta de serviço com privilégios.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -d '{"audience": "AUDIENCE", "includeEmail": "true"}' \ https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/SERVICE_ACCOUNT_EMAIL:generateIdToken- AUDIENCE: o URI do serviço de destino, como
A seguir
- Entenda os tokens de ID.
- Use comandos do shell para consultar o servidor de metadados do Compute Engine.
- Saiba mais sobre os métodos de autenticação.