Per informazioni sul funzionamento di ADC, incluso dove vengono trovate le credenziali, consulta Come funzionano le credenziali predefinite dell'applicazione.
Le credenziali utente non funzionano
Se la richiesta API restituisce un messaggio di errore che indica che le credenziali utente non sono supportate da questa API, che l'API non è abilitata nel progetto o che non è stato impostato un progetto di quota, esamina le seguenti informazioni.
Esistono due tipi di API Google Cloud :
API basate sulle risorse, che utilizzano il progetto associato alle risorse a cui si accede per la fatturazione e la quota.
API basate su client, che utilizzano il progetto associato al client che accede alle risorse per la fatturazione e la quota.
Quando fornisci le credenziali utente per l'autenticazione a un'API basata su client, devi specificare il progetto da utilizzare per la fatturazione e la quota. Questo progetto è chiamato progetto di quota.
Esistono diversi modi per specificare un progetto di quota, tra cui le seguenti opzioni:
Aggiorna il file ADC per utilizzare un progetto diverso come progetto di quota:
gcloud auth application-default set-quota-project YOUR_PROJECT
Se utilizzi gcloud CLI per chiamare l'API, puoi impostare il progetto di quota nella configurazione di gcloud CLI:
gcloud config set billing/quota_project YOUR_PROJECT
Se chiami direttamente l'API REST o RPC, utilizza l'intestazione HTTP
x-goog-user-projectper specificare un progetto di quota in ogni richiesta. Per maggiori dettagli, consulta Imposta il progetto di quota con una richiesta REST.
Per poter designare un progetto come progetto di fatturazione, devi disporre dell'autorizzazione IAM serviceusage.services.use per il progetto. L'autorizzazione serviceusage.services.use è inclusa nel ruolo IAM Service Usage Consumer. Se non disponi dell'autorizzazione serviceusage.services.use per un progetto, contatta l'amministratore della sicurezza o un Project Owner che possa assegnarti il ruolo Service Usage Consumer nel progetto.
Per saperne di più sui progetti di quota, consulta Panoramica dei progetti di quota. Per informazioni su altri modi per impostare il progetto di quota, consulta Imposta il progetto di quota.
Credenziali non corrette
Se le tue credenziali non sembrano fornire l'accesso previsto o non vengono trovate, controlla quanto segue:
Se utilizzi gcloud CLI per accedere a Google Cloud in un ambiente locale, assicurati di comprendere quali credenziali stai utilizzando. Quando utilizzi gcloud CLI, utilizzi le credenziali che hai fornito a gcloud CLI utilizzando il comando
gcloud auth login. Non stai utilizzando le credenziali che hai fornito ad ADC. Per saperne di più su questi due set di credenziali, consulta Configurazione dell'autenticazione di gcloud CLI e configurazione di ADC.Assicurati che la variabile di ambiente
GOOGLE_APPLICATION_CREDENTIALSsia impostata solo se utilizzi una chiave dell'account di servizio o un altro file JSON per ADC. Le credenziali indicate dalla variabile di ambiente hanno la precedenza su altre credenziali, incluse quelle per Workload Identity Federation for GKE.Verifica che l'entità che effettua la richiesta disponga dei ruoli IAM richiesti. Se utilizzi le credenziali utente, i ruoli devono essere concessi all'indirizzo email associato all'account utente. Se utilizzi un account di servizio, questo deve disporre dei ruoli richiesti.
Se fornisci una chiave API con la richiesta API, la chiave API ha la precedenza su ADC in qualsiasi località. Se hai impostato la variabile di ambiente
GOOGLE_APPLICATION_CREDENTIALSe utilizzi una chiave API, l'API potrebbe restituire un avviso che ti informa che le credenziali fornite ad ADC vengono ignorate. Per interrompere l'avviso, annulla l'impostazione della variabile di ambienteGOOGLE_APPLICATION_CREDENTIALS.
Ambiti di autenticazione insufficienti
Se la richiesta API restituisce Request had insufficient authentication scopes
con il motivo ACCESS_TOKEN_SCOPE_INSUFFICIENT, il token di accesso non
include un ambito richiesto dall'API. La concessione di ruoli IAM non risolve questo errore.
Per risolvere l'errore:
Identifica l'API dai campi
serviceemethodnei dettagli dell'errore.Trova l'ambito richiesto dall'API nel riferimento API del metodo o in Ambiti OAuth 2.0 per le API di Google. La maggior parte delle API Google Cloud accetta l'ambito
https://www.googleapis.com/auth/cloud-platform. Le API Google Workspace richiedono i propri ambiti.Controlla gli ambiti del tuo token. Dall'ambiente in cui si verifica l'errore, esegui il seguente comando ed esamina il campo
scope:curl "https://oauth2.googleapis.com/tokeninfo?access_token=$(gcloud auth application-default print-access-token)"
Aggiungi l'ambito mancante nel punto in cui le tue credenziali ottengono gli ambiti:
Compute Engine: aggiorna gli ambiti di accesso della VM. Per ulteriori informazioni, consulta Ambiti di accesso e Collega il account di servizio e aggiorna l'ambito di accesso.
GKE: crea un pool di nodi con gli ambiti di accesso richiesti o utilizza Workload Identity Federation for GKE per i tuoi workload. Per saperne di più, consulta Ambiti di accesso predefiniti e Autenticati alle API Google Cloud dai workload GKE.
Il tuo codice: aggiungi l'ambito agli ambiti che richiedi quando crei le credenziali. Per gli ambiti richiesti da ogni API, consulta Ambiti OAuth 2.0 per le API di Google.
Delega a livello di dominio: autorizza gli ambiti richiesti per l'ID client del account di servizio nella Console di amministrazione Google Workspace, quindi richiedi questi ambiti nel codice quando crei le credenziali. Per saperne di più, consulta Delega l'autorità a livello di dominio al service account e Controlla l'accesso all'API con la delega a livello di dominio.
Tipo di credenziali non riconosciuto
Se la richiesta API restituisce un errore che include Error creating credential
from JSON. Unrecognized credential type, assicurati di utilizzare una credenziale valida. I file ID client non sono supportati per fornire le credenziali per ADC.