In questa pagina vengono descritti i vari modi per accedere a gcloud CLI. Google Cloud CLI è uno strumento a riga di comando che puoi utilizzare per l'amministrazione di Google Cloud. La maggior parte dei servizi supporta gcloud CLI.
Se prevedi di utilizzare librerie client o strumenti di sviluppo di terze parti che supportano le Credenziali predefinite dell'applicazione (ADC) in un ambiente di sviluppo locale, devi configurare ADC nel tuo ambiente locale. Per saperne di più, consulta Configurare le Credenziali predefinite dell'applicazione per un ambiente di sviluppo locale.
La modalità di autenticazione e di utilizzo di gcloud CLI dipende da dove viene eseguito lo strumento:
Ambiente locale
Nella maggior parte dei casi d'uso, puoi utilizzare le credenziali utente per accedere a gcloud CLI, ma puoi anche utilizzare un account di servizio.
Quando accedi a gcloud CLI in un ambiente locale, lo strumento posiziona i token di accesso e aggiornamento nella tua directory home. Qualsiasi utente con accesso al tuo file system può utilizzare queste credenziali. Per maggiori informazioni, consulta Mitigare i token OAuth compromessi per Google Cloud CLI.
La tabella seguente descrive le opzioni a tua disposizione per accedere a gcloud CLI e il modo in cui ciò influisce sulle credenziali utilizzate dallo strumento per l'autenticazione e l'autorizzazione per le API di Google.
| Tipo di credenziale | Comando di autenticazione | Note | Ulteriori informazioni |
|---|---|---|---|
| Credenziali utente |
gcloud CLI utilizza le tue credenziali utente per l'autenticazione e l'autorizzazione per tutte le API di Google. Per utilizzare un account di servizio per l'autorizzazione alle API di Google, utilizza la rappresentazione dell'account di servizio. |
||
|
La federazione delle identità per la forza lavoro consente agli utenti gestiti da un provider di identità diverso da Google di accedere alle risorse Google Cloud. | ||
| Credenziali utente |
|
La federazione delle identità per la forza lavoro consente agli utenti gestiti da un provider di identità diverso da Google di accedere alle risorse Google Cloud. | |
| Account di servizio |
gcloud auth login --cred-file=WORKLOAD_IDENTITY_FEDERATION_CREDENTIAL_FILE
|
La federazione delle identità per i carichi di lavoro consente ai carichi di lavoro in esecuzione al di fuori di Google Cloud di accedere alle risorse Google Cloud. | Autentica un carico di lavoro |
gcloud auth login --cred-file=SERVICE_ACCT_KEY
|
Questo metodo non è consigliato, perché l'utilizzo delle chiavi degli account di servizio aumenta il rischio. Per utilizzare un account di servizio per l'autorizzazione alle API di Google, accedi a gcloud CLI con le tue credenziali utente, quindi utilizza la impersonificazione degli account di servizio. |
Cloud Shell
Quando utilizzi Cloud Shell, non è necessario accedere a gcloud CLI, ma devi autorizzare l'utilizzo dell'account prima di utilizzare qualsiasi strumento di sviluppo da Cloud Shell. Dopodiché, gcloud CLI utilizza le tue credenziali utente per accedere alle API di Google.
Per maggiori informazioni, vedi Autorizzare con Cloud Shell.
Risorse di computing Google Cloud
Quando utilizzi gcloud CLI su risorse di calcolo Google Cloud come le macchine virtuali Compute Engine, non è necessario inizializzare o accedere a gcloud CLI, poiché riceve le credenziali e le informazioni di configurazione dalla risorsa di computing di hosting utilizzando il server di metadati.
| Tipo di credenziale | Comando di autenticazione | Note | Ulteriori informazioni |
|---|---|---|---|
| Account di servizio | Non applicabile | gcloud CLI utilizza l'account di servizio collegato alla risorsa di computing per l'autenticazione e l'autorizzazione per tutte le API di Google. | Servizi Google Cloud che supportano il collegamento di un account di servizio |
Configurazione dell'autenticazione dell'interfaccia alla gcloud CLI e configurazione di ADC
Quando accedi a gcloud CLI, utilizzi il comando gcloud auth login per autenticare un'entità in gcloud CLI.
gcloud CLI utilizza questa entità per l'autenticazione e l'autorizzazione per gestire le risorse e i servizi Google Cloud. Questa è la tua configurazione dell'autenticazione dell'interfaccia a riga di comando gcloud.
Quando utilizzi gcloud CLI per configurare ADC, devi utilizzare il comando gcloud auth application-default login. Questo comando utilizza l'entità da te fornita per configurare ADC per l'ambiente locale. Questa è la tua configurazione ADC.
La configurazione dell'autenticazione gcloud CLI è diversa dalla configurazione di ADC. Possono utilizzare la stessa entità o entità diverse. gcloud CLI non utilizza ADC per accedere alle risorse Google Cloud.
La tabella seguente mostra i due comandi e la loro funzione:
| Comando | Descrizione |
|---|---|
gcloud auth login
|
Accetta le credenziali utilizzate per autenticarsi e autorizzare l'accesso ai servizi Google Cloud. |
gcloud auth application-default login
|
Genera un file ADC locale in base alle credenziali fornite al comando. |
In genere si utilizza lo stesso account per accedere a gcloud CLI e per configurare ADC, ma è possibile utilizzare account diversi, se necessario.
Passaggi successivi
- Scopri di più su come ADC trova le credenziali.
- Autenticazione per l'utilizzo delle librerie client di Cloud.
- Esplora i metodi di autenticazione.