Alcune o tutte le informazioni in questa pagina potrebbero non essere applicabili a Cloud de Confiance di S3NS. Per maggiori dettagli, consulta Differenze rispetto a Google Cloud.
Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.
Questa pagina descrive come utilizzare le librerie client per accedere alle API di Google.
Le librerie client semplificano l'accesso alle Cloud de Confiance by S3NS API
utilizzando un linguaggio supportato. Puoi utilizzare Cloud de Confiance by S3NS API direttamente
effettuando delle richieste non elaborate al server, ma le librerie client forniscono semplificazioni
che riducono notevolmente la quantità di codice da scrivere. Questo è
particolarmente vero per l'autenticazione, perché le librerie client supportano
le credenziali predefinite dell'applicazione (ADC).
Utilizzare le credenziali predefinite dell'applicazione con le librerie client
Per utilizzare le credenziali predefinite dell'applicazione per autenticare la tua applicazione, devi prima configurare ADC per l'ambiente in cui è in esecuzione l'applicazione. Quando utilizzi la libreria client
per creare un client, la libreria client controlla e utilizza automaticamente le credenziali che hai fornito ad ADC per l'autenticazione alle API
utilizzate dal tuo codice. La tua applicazione non deve autenticare esplicitamente
o gestire i token; questi requisiti vengono gestiti automaticamente dalle
librerie di autenticazione.
I seguenti esempi di codice creano un client per il servizio Cloud Storage.
È probabile che il tuo codice richieda client diversi; questi esempi hanno lo scopo di mostrare come creare un client e utilizzarlo senza alcun codice per l'autenticazione esplicita.
Prima di poter eseguire gli esempi seguenti, devi completare i seguenti passaggi:
Puoi utilizzare una chiave API solo con le librerie client per le API che accettano chiavi API. Inoltre, la chiave API non deve avere una limitazione API che ne impedisca l'utilizzo per l'API.
Quando utilizzi le chiavi API nelle tue applicazioni, assicurati che siano protette durante l'archiviazione e la trasmissione. L'esposizione pubblica delle chiavi API può comportare addebiti imprevisti sul tuo account. Per saperne di più, consulta
Best practice per la gestione delle chiavi API.
Requisiti di sicurezza quando si utilizzano configurazioni delle credenziali da un'origine esterna
In genere, le configurazioni delle credenziali vengono generate utilizzando i comandi gcloud CLI
o la Cloud de Confiance console. Ad esempio, puoi utilizzare gcloud CLI per generare un file ADC locale o un file di configurazione di accesso. Allo stesso modo, puoi utilizzare la Cloud de Confiance console per creare e scaricare
una chiave del account di servizio.
Tuttavia, per alcuni casi d'uso, le configurazioni delle credenziali vengono fornite da un'entità esterna; queste configurazioni delle credenziali sono destinate all'autenticazione alle API Google.
Alcuni tipi di configurazioni delle credenziali includono endpoint e percorsi di file, che le librerie di autenticazione utilizzano per acquisire un token. Quando accetti le configurazioni delle credenziali da un'origine esterna, devi convalidare la configurazione prima di utilizzarla. Se non convalidi la configurazione, un utente malintenzionato potrebbe utilizzare le credenziali per compromettere i tuoi sistemi e i tuoi dati.
Convalidare le configurazioni delle credenziali da origini esterne
La modalità di convalida delle credenziali esterne dipende dai tipi di credenziali accettate dalla tua applicazione.
Convalidare le chiavi dei account di servizio
Se la tua applicazione accetta solo le chiavi dei account di servizio, utilizza un caricatore di credenziali specifico per le chiavi dei account di servizio, come mostrato negli esempi seguenti. Il caricatore di credenziali specifico per il tipo analizza solo i campi presenti per le chiavi dei service account, che non espongono vulnerabilità.
Se non puoi utilizzare un caricatore di credenziali specifico per il tipo, convalida le credenziali confermando che il valore del campo type sia service_account. Se il valore del campo type è un altro valore, non utilizzare la chiave del account di servizio.
Convalidare altre configurazioni delle credenziali
La tabella seguente elenca i campi da convalidare, se presenti nelle credenziali. Non tutti questi campi sono presenti per tutte le configurazioni delle credenziali.
Campo
Finalità
Valore previsto
service_account_impersonation_url
Le librerie di autenticazione utilizzano questo campo per accedere a un endpoint per
generare un token di accesso per il account di servizio di cui viene simulata l'identità.
Le librerie di autenticazione inviano un token esterno a questo endpoint per
scambiarlo con un
token di accesso federato.
https://sts.s3nsapis.fr/v1/token
credential_source.file
Le librerie di autenticazione leggono un token esterno dal file nella
posizione specificata da questo campo e lo inviano all'
token_url endpoint.
Il percorso di un file contenente un token esterno. Dovresti
riconoscere questo percorso.
credential_source.url
Un endpoint che restituisce un token esterno. Le librerie di autenticazione
inviano una richiesta a questo URL e inviano la risposta all'
token_url endpoint.
Uno dei seguenti elementi:
Un endpoint noto fornito dal tuo cloud provider.
Un endpoint che hai configurato esplicitamente per fornire i token.
credential_source.executable.command
Se la variabile di ambiente GOOGLE_EXTERNAL_ACCOUNT_ALLOW_EXECUTABLES
è impostata su 1, le librerie di autenticazione
eseguono questo comando o file eseguibile.
Un file eseguibile o un comando che restituisce un token esterno.
Dovresti riconoscere questo comando e verificare che sia sicuro.
credential_source.aws.url
Le librerie di autenticazione inviano una richiesta a questo URL per recuperare
un token di sicurezza AWS.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2026-08-08 UTC."],[],[]]