Crea e accedi a un secret utilizzando Secret Manager
Scopri come creare e accedere ai secret utilizzando Secret Manager su Google Cloud.
Per seguire le indicazioni dettagliate per questa attività direttamente nella console Google Cloud, fai clic su Procedura guidata:
Prima di iniziare
- Abilita Secret Manager API, una volta per progetto.
- Assegna il ruolo Amministratore Secret Manager (
roles/secretmanager.admin
) nel progetto, nella cartella o nell'organizzazione. Esegui l'autenticazione nell'API Secret Manager in uno dei seguenti modi:
- Se utilizzi librerie client per accedere all'API Secret Manager, imposta in 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 oppure Credenziali predefinite dell'applicazione.
Crea un secret e accedi a una versione del secret
Gli esempi seguenti mostrano la creazione di un secret e l'accesso a un i contenuti della versione del secret.
Console
Per creare il secret e la relativa versione:
-
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
my-secret
. -
Nel campo Valore secret, inserisci
my super secret data
. -
Fai clic sul pulsante Crea secret.
Per accedere ai contenuti della versione del secret:
-
Vai alla pagina Secret Manager nella console Google Cloud.
-
Nella pagina Secret Manager, fai clic su my-secret.
-
Nella tabella Versioni della pagina Dettagli secret, individua la versione 1.
-
Nella colonna Azioni, fai clic su Mostra altro
. -
Fai clic su Visualizza valore secret dal menu.
-
Viene visualizzata una finestra di dialogo che mostra il valore del secret. Fai clic su Fine per chiudere la finestra di dialogo.
gcloud
Per utilizzare Secret Manager nella riga di comando, devi prima Installa o esegui l'upgrade alla versione 378.0.0 o successive di Google Cloud CLI. In Compute Engine o GKE, devi eseguire l'autenticazione con l'ambito cloud-platform.
Per creare un secret e archiviare una stringa come contenuto della prima versione del secret:
$ echo -n "my super secret data" | gcloud secrets create my-secret \
--replication-policy="replication-policy" \
--data-file=-
Dove replication-policy è uno tra automatic
o user-managed
.
Per accedere ai contenuti di una versione specifica del secret:
$ gcloud secrets versions access 1 --secret="my-secret"
Per accedere ai contenuti della versione più recente del secret:
$ gcloud secrets versions access latest --secret="my-secret"
C#
Per eseguire questo codice, per prima cosa configura un ambiente di sviluppo C# e installare l'SDK Secret Manager C#. In Compute Engine o GKE, devi eseguire l'autenticazione con l'ambito cloud-platform.
Go
Per eseguire questo codice, devi prima configurare un ambiente di sviluppo Go e installa l'SDK Secret Manager Go. In Compute Engine o GKE, devi eseguire l'autenticazione con l'ambito cloud-platform.
Java
Per eseguire questo codice, per prima cosa configura un ambiente di sviluppo Java e installa l'SDK Java di Secret Manager. In Compute Engine o GKE, devi eseguire l'autenticazione con l'ambito cloud-platform.
Node.js
Per eseguire questo codice, devi prima configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Secret Manager. In Compute Engine o GKE, devi eseguire l'autenticazione con l'ambito cloud-platform.
PHP
Per eseguire questo codice, scopri innanzitutto come utilizzare PHP su Google Cloud e installa l'SDK PHP di Secret Manager. In Compute Engine o GKE, devi eseguire l'autenticazione con l'ambito cloud-platform.
Python
Per eseguire questo codice, configura prima un ambiente di sviluppo Python e installare l'SDK Python di Secret Manager. In Compute Engine o GKE, devi eseguire l'autenticazione con l'ambito cloud-platform.
Ruby
Per eseguire questo codice, prima configura un ambiente di sviluppo Ruby e installa l'SDK Ruby di Secret Manager. In Compute Engine o GKE, devi eseguire l'autenticazione con l'ambito cloud-platform.
API
In questi esempi viene utilizzato curl per dimostrare l'utilizzo dell'API. Puoi generare token di accesso con gcloud auth stampa-access-token. In Compute Engine o GKE, devi eseguire l'autenticazione con l'ambito cloud-platform.
Per creare il secret e archiviare una stringa come contenuto di una versione del secret:
$ curl "https://secretmanager.googleapis.com/v1/projects/project-id/secrets?secretId=my-secret" \
--request "POST" \
--header "authorization: Bearer $(gcloud auth print-access-token)" \
--header "content-type: application/json" \
--data "{\"replication\": {\"automatic\": {}}}"
Per accedere ai contenuti della versione del secret:
$ curl "https://secretmanager.googleapis.com/v1/projects/project-id/secrets/my-secret/versions/1:access" \
--request "GET" \
--header "authorization: Bearer $(gcloud auth print-access-token)" \
--header "content-type: application/json"
Passaggi successivi
- Scopri di più sulla modifica di un secret.
- Scopri di più sulla gestione dell'accesso ai secret.
- Scopri di più sull'assegnazione di un alias a una versione del secret.
- Scopri di più sulla configurazione delle notifiche su un secret.
- Scopri di più sulle best practice.