Questo argomento descrive come creare un secret. Un secret contiene una o più versioni, oltre a metadati come etichette e informazioni sulla replica. I contenuti effettivi di un secret vengono archiviati in una versione del secret.
Prima di iniziare
- Abilita l'API Secret Manager una volta per progetto.
- Assegna il ruolo Amministratore Secret Manager (
roles/secretmanager.admin
) al progetto, alla cartella o all'organizzazione. Esegui l'autenticazione all'API Secret Manager in uno dei seguenti modi:
- Se utilizzi le librerie client per accedere all'API Secret Manager, configura le credenziali predefinite dell'applicazione.
- Se utilizzi Google Cloud CLI per accedere all'API Secret Manager, utilizza le tue credenziali Google Cloud CLI per l'autenticazione.
- Per autenticare una chiamata REST, utilizza le credenziali di Google Cloud CLI o le Credenziali predefinite dell'applicazione.
Crea un secret
Console
-
Vai alla pagina Secret Manager nella console Google Cloud.
-
Nella pagina Secret Manager, fai clic su Crea secret.
-
Nella pagina Crea secret, in Nome, inserisci un nome per il secret (ad esempio
my-secret
). Un nome di secret può contenere lettere maiuscole e minuscole, numeri, trattini e trattini bassi. La lunghezza massima consentita per un nome è 255 caratteri. -
(Facoltativo) Per aggiungere anche una versione del secret durante la creazione del secret iniziale, inserisci un valore per il secret nel campo Valore secret, ad esempio
abcd1234
. Il valore del secret può essere in qualsiasi formato, ma non deve essere superiore a 64 KB. Puoi anche caricare un file di testo contenente il valore del secret utilizzando l'opzione Carica file. -
Fai clic sul pulsante Crea secret.
gcloud
Per utilizzare Secret Manager sulla riga di comando, installa o esegui l'upgrade alla versione 378.0.0 o successive di Google Cloud CLI. Su Compute Engine o GKE, devi autenticarti con l'ambito cloud-platform.
$ gcloud secrets create secret-id \
--replication-policy="automatic"
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK C# di Secret Manager. Su Compute Engine o GKE, devi autenticarti con l'ambito cloud-platform.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Go di Secret Manager. Su Compute Engine o GKE, devi autenticarti con l'ambito cloud-platform.
Java
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Java e installare l'SDK Java di Secret Manager. Su Compute Engine o GKE, devi autenticarti con l'ambito cloud-platform.
Node.js
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Secret Manager. Su Compute Engine o GKE, devi autenticarti con l'ambito cloud-platform.
PHP
Per eseguire questo codice, devi innanzitutto scoprire come utilizzare PHP su Google Cloud e installare l'SDK PHP di Secret Manager. Su Compute Engine o GKE, devi autenticarti con l'ambito cloud-platform.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK Python di Secret Manager. Su Compute Engine o GKE, devi autenticarti con l'ambito cloud-platform.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK Ruby di Secret Manager. Su Compute Engine o GKE, devi autenticarti con l'ambito cloud-platform.
API
Questi esempi utilizzano curl per dimostrare l'utilizzo dell'API. Puoi generare token di accesso con gcloud auth print-access-token. Su Compute Engine o GKE, devi autenticarti con l'ambito cloud-platform.
$ curl "https://secretmanager.googleapis.com/v1/projects/project-id/secrets?secretId=secret-id" \
--request "POST" \
--header "authorization: Bearer $(gcloud auth print-access-token)" \
--header "content-type: application/json" \
--data "{\"replication\": {\"automatic\": {}}}"
Per selezionare il criterio di replica corretto per il tuo secret, consulta Scegliere un criterio di replica.
Aggiungi una versione del secret
Secret Manager esegue automaticamente la versione dei dati dei secret utilizzando le versioni dei secret e la maggior parte delle operazioni come accesso, distruzione, disattivazione e attivazione avviene su una versione del secret.
Con Secret Manager, puoi aggiungere un secret a versioni specifiche come 42
o ad alias mobili come latest
. Scopri come aggiungere una versione del secret.
Accedere a una versione del secret
Per accedere ai dati del secret da una determinata versione del secret per un'autenticazione riuscita, consulta Accedere a una versione del secret.
Passaggi successivi
- Scopri come scegliere un criterio di replica.
- Scopri come gestire l'accesso ai secret.
- Scopri come configurare le notifiche per un secret.