Para informações sobre como o ADC funciona, incluindo onde as credenciais são encontradas, consulte Como o Application Default Credentials funciona.
As credenciais do usuário não funcionam
Se a solicitação de API retornar uma mensagem de erro informando que as credenciais do usuário final não são compatíveis com essa API, que a API não está sendo ativada no projeto ou que nenhum projeto de cota está definido, leia as seguintes informações.
Há dois tipos de APIs do Google Cloud :
APIs baseadas em recursos, que usam o projeto associado aos recursos que estão sendo acessados para faturamento e cota.
APIs baseadas em cliente, que usam o projeto associado ao cliente que acessa os recursos para faturamento e cota.
Ao fornecer credenciais de usuário para se autenticar em uma API baseada em cliente, você precisa especificar o projeto a ser usado para faturamento e cota. Esse projeto é chamado de projeto de cota.
Há várias maneiras de especificar um projeto de cota, incluindo as seguintes opções:
Atualize o arquivo ADC para usar um projeto diferente como o projeto de cota:
gcloud auth application-default set-quota-project YOUR_PROJECT
Se você estiver usando a CLI gcloud para chamar a API, defina o projeto de cota na configuração da CLI gcloud:
gcloud config set billing/quota_project YOUR_PROJECT
Se você estiver chamando a API REST ou RPC diretamente, use o cabeçalho HTTP
x-goog-user-projectpara especificar um projeto de cota em cada solicitação. Para detalhes, consulte Definir o projeto de cota com uma solicitação REST.
Você precisa ter a permissão do IAM serviceusage.services.use para que um projeto possa designá-lo como seu projeto de faturamento. A permissão serviceusage.services.use está incluída no papel de IAM de consumidor do Service Usage. Se você não tiver a permissão serviceusage.services.use para nenhum projeto, entre em contato com o administrador de segurança ou um proprietário do projeto que possa conceder a você o papel Consumidor do Service Usage no projeto.
Para saber mais sobre projetos de cotas, consulte Visão geral do projeto de cotas. Para saber mais sobre outras maneiras de definir o projeto de cota, consulte Definir o projeto de cota.
Credenciais incorretas
Se as credenciais aparentemente não fornecerem o acesso esperado ou não forem encontradas, verifique o seguinte:
Se você estiver usando a CLI gcloud para acessar o Google Cloud em um ambiente local, verifique quais credenciais você está usando. Ao usar a CLI gcloud, você está usando as credenciais fornecidas para a CLI gcloud usando o comando
gcloud auth login. Você não está usando as credenciais que forneceu ao ADC. Para mais informações sobre esses dois conjuntos de credenciais, consulte Configuração de autenticação da CLI gcloud e configuração do ADC.Verifique se a variável de ambiente
GOOGLE_APPLICATION_CREDENTIALSestá definida somente se você estiver usando uma chave de conta de serviço ou outro arquivo JSON para o ADC. As credenciais indicadas pela variável de ambiente têm precedência sobre outras credenciais, inclusive para a Federação de Identidade da Carga de Trabalho para GKE.Confirme se o principal que está fazendo a solicitação tem os papéis do IAM necessários. Se você estiver usando credenciais de usuário, os papéis precisarão ser concedidos ao endereço de e-mail associado à conta do usuário. Se você estiver usando uma conta de serviço, ela precisará ter os papéis necessários.
Se você fornecer uma chave de API com a solicitação de API, ela terá precedência sobre o ADC em qualquer local. Se você tiver definido a variável de ambiente
GOOGLE_APPLICATION_CREDENTIALSe estiver usando uma chave de API, a API poderá retornar um aviso informando que as credenciais fornecidas ao ADC estão sendo ignoradas. Para interromper o alerta, desative a variável de ambienteGOOGLE_APPLICATION_CREDENTIALS.
Escopos de autenticação insuficientes
Se a solicitação de API retornar Request had insufficient authentication scopes
com o motivo ACCESS_TOKEN_SCOPE_INSUFFICIENT, seu token de acesso não
inclui um escopo exigido pela API. A concessão de papéis do IAM não
corrige esse erro.
Para resolver o erro, faça o seguinte:
Identifique a API nos campos
serviceemethodnos detalhes do erro.Encontre o escopo exigido pela API na referência da API do método ou em Escopos do OAuth 2.0 para APIs do Google. A maioria das APIs do Google Cloud aceita o escopo
https://www.googleapis.com/auth/cloud-platform. As APIs do Google Workspace exigem escopos próprios.Verifique quais escopos seu token tem. No ambiente em que o erro ocorre, execute o seguinte comando e revise o campo
scope:curl "https://oauth2.googleapis.com/tokeninfo?access_token=$(gcloud auth application-default print-access-token)"
Adicione o escopo que está faltando onde suas credenciais recebem os escopos:
Compute Engine: atualize os escopos de acesso da VM. Para mais informações, consulte Escopos de acesso e Anexar a conta de serviço e atualizar o escopo de acesso.
GKE: crie um pool de nós com os escopos de acesso necessários ou use a Federação de Identidade da Carga de Trabalho para GKE nas suas cargas de trabalho. Para mais informações, consulte Escopos de acesso padrão e Autenticar nas APIs do Google Cloud com base nas cargas de trabalho do GKE.
Seu código: adicione o escopo aos escopos solicitados ao criar credenciais. Para saber quais escopos cada API exige, consulte Escopos do OAuth 2.0 para APIs do Google.
Delegação em todo o domínio: autorize os escopos necessários para o ID do cliente da conta de serviço no Admin Console do Google Workspace e solicite esses escopos no código ao criar credenciais. Para mais informações, consulte Delegar autoridade em todo o domínio à conta de serviço e Controlar o acesso à API com a delegação em todo o domínio.
Tipo de credencial não reconhecido
Se a solicitação de API retornar um erro que inclua Error creating credential
from JSON. Unrecognized credential type, verifique se você está usando uma credencial válida. Os arquivos de ID do cliente não são compatíveis com credenciais do ADC.