O token de acesso da aplicação
Uma service account é uma identidade que uma aplicação usa para se autenticar. No Google Cloud, cada service account tem um endereço de email próprio. Ao chamar uma API, a aplicação apresenta um token de acesso associado a essa identidade. O serviço consulta as políticas para verificar se a identidade tem permissão para fazer a chamada.
Em uma máquina virtual do Compute Engine, você pode associar uma service account à instância. A biblioteca cliente do Google Cloud usa as credenciais padrão da aplicação para obter um token temporário dessa identidade. Assim, o programa consegue chamar a API sem precisar carregar um arquivo de chave.
Leitura de um arquivo no Cloud Storage
O IAM (Identity and Access Management) reúne permissões em papéis. Para um programa que importa vendas.csv do Cloud Storage, você pode conceder à service account o papel Storage Object Viewer (roles/storage.objectViewer) no bucket de origem. A permissão storage.objects.list permite que o programa encontre o arquivo na listagem do bucket. Para ler o conteúdo de vendas.csv, a permissão usada é storage.objects.get, incluída no mesmo papel.
Para gravar um novo arquivo no mesmo bucket, a aplicação precisaria também da permissão storage.objects.create. Se a leitura for recusada, confira a identidade usada na chamada e o papel concedido no bucket. Se a aplicação usa a service account associada a uma máquina virtual do Compute Engine, verifique também se o escopo OAuth da instância permite a leitura no Cloud Storage.
Dúvidas frequentes
Perguntas frequentes sobre service account
- Para que serve o arquivo de chave de uma service account?
- A aplicação usa a chave privada do arquivo para assinar um JWT (JSON Web Token) e trocá-lo por um token de acesso. O acesso ao arquivo deve ser restrito porque a chave permite agir com as permissões da service account.
- Uma service account padrão pode vir com permissões no projeto?
- A service account padrão do Compute Engine pode receber o papel de Editor no projeto conforme a política da organização. Confira os papéis associados a ela no IAM antes de usar essa identidade em uma aplicação.
- Como autenticar uma aplicação que roda fora do Google Cloud?
- Com o Workload Identity Federation, a aplicação usa uma credencial de um provedor de identidade confiável para obter acesso temporário. Ela pode acessar recursos diretamente com a identidade federada quando a API oferece esse suporte. Para agir como uma service account, a identidade federada precisa ter permissão para assumi-la.
Para continuar
Recursos relacionados
Documentação
Service accounts no IAM do Google Cloud
Consulte os tipos de service account e os mecanismos do Google Cloud para autenticar uma aplicação com essa identidade.
Abrir recursoSite de referência
Desenvolvimento Colaborativo da Dev Side Studio
Se a aplicação recebe uma recusa ao ler um bucket, você pode conferir com a Dev Side Studio qual identidade fez a chamada e quais papéis ela tem.
Abrir recursoDocumentação
Papéis do IAM no Cloud Storage
Consulte a lista de permissões do papel Storage Object Viewer para conferir quais operações de leitura ele autoriza no bucket.
Abrir recursoAplicação na formação
Formação DevOps
Ao configurar uma aplicação para ler arquivos de um bucket, você pode usar uma service account com permissões de leitura para aquele bucket.
Conhecer a formação
Fontes consultadas
Referências deste verbete
- Autenticação de aplicações com Workload Identity Federation
- Service accounts em máquinas virtuais do Compute Engine
- Google Cloud: credenciais de identidades de serviço
- Google Cloud: papéis de acesso
- Google Cloud: tipos de identidade de serviço
- Google Cloud: papéis de acesso do Cloud Storage
- Google Cloud: identidades de aplicações e permissões
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.