Risolvere i problemi relativi alla configurazione di ADC

Questa pagina descrive alcuni problemi comuni che potresti riscontrare durante l'utilizzo delle Credenziali predefinite dell'applicazione (ADC).

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-project per 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_CREDENTIALS sia 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_CREDENTIALS e 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 ambiente GOOGLE_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:

  1. Identifica l'API dai campi service e method nei dettagli dell'errore.

  2. 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.

  3. 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)"
  4. Aggiungi l'ambito mancante nel punto in cui le tue credenziali ottengono gli ambiti:

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.