Questa pagina mostra come creare un keyring in Cloud KMS. Un keyring è la risorsa principale per le chiavi e le versioni delle chiavi Cloud KMS. Ogni keyring esiste in una determinata località. Per ulteriori informazioni sulle risorse Cloud KMS, consulta la sezione Risorse Cloud KMS.
Prima di iniziare
Prima di completare le attività in questa pagina, devi disporre di quanto segue:
- Una risorsa del progetto Google Cloud per contenere le tue risorse Cloud KMS. Questo progetto è chiamato progetto principale. Ti consigliamo di non includere altre risorse Google Cloud nel progetto principale. Abilita l'API Cloud KMS nel progetto della chiave.
- Il nome della località in cui vuoi creare il keyring. Scegli una località vicina alle altre risorse e che supporti il livello di protezione scelto. Per visualizzare le località disponibili e i livelli di protezione supportati, consulta Località Cloud KMS.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per creare i portachiavi,
chiedi all'amministratore di concederti il ruolo IAM Amministratore Cloud KMS (roles/cloudkms.admin
) nel progetto o in una risorsa principale.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene le autorizzazioni necessarie per creare portachiavi. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
Per creare i portachiavi sono necessarie le seguenti autorizzazioni:
-
cloudkms.keyRings.create
-
cloudkms.keyRings.get
-
cloudkms.keyRings.list
-
cloudkms.locations.get
-
cloudkms.locations.list
-
resourcemanager.projects.get
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Creazione di un keyring
Segui questi passaggi per creare un mazzo di chiavi per la nuova chiave. Se vuoi utilizzare un mazzo di chiavi esistente, puoi creare una chiave.
Console
Vai alla pagina Gestione delle chiavi nella console Google Cloud.
Fai clic su Crea keyring.
In Nome portachiavi, inserisci un nome per il portachiavi.
In Posizione del mazzo di chiavi, seleziona una località, ad esempio
"us-east1"
.Fai clic su Crea.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
-
Nel tuo ambiente, esegui il comando
gcloud kms keyrings create
:gcloud kms keyrings create KEY_RING \ --location LOCATION
Sostituisci quanto segue:
KEY_RING
: il nome del mazzo di chiavi che contiene la chiave.LOCATION
: la posizione di Cloud KMS della raccolta di chiavi.
Per informazioni su tutti i flag e i possibili valori, esegui il comando con il flag
--help
.
C#
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo C# e installare l'SDK C# Cloud KMS.
Go
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Go e installare l'SDK Go Cloud KMS.
Java
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Java e installare l'SDK Java Cloud KMS.
Node.js
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Cloud KMS.
PHP
Per eseguire questo codice, devi innanzitutto scoprire come utilizzare PHP su Google Cloud e installare l'SDK PHP Cloud KMS.
Python
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Python e installare l'SDK Python Cloud KMS.
Ruby
Per eseguire questo codice, devi innanzitutto configurare un ambiente di sviluppo Ruby e installare l'SDK Ruby Cloud KMS.
API
Questi esempi utilizzano curl come client HTTP per dimostrare l'utilizzo dell'API. Per ulteriori informazioni sul controllo dell'accesso, consulta Accedere all'API Cloud KMS.
curl "https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings?key_ring_id=KEY_RING" \ --request "POST" \ --header "authorization: Bearer TOKEN"
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto che contiene la chiave automatizzata.KEY_RING
: il nome del mazzo di chiavi che contiene la chiave.LOCATION
: la posizione di Cloud KMS della raccolta di chiavi.
Per ulteriori informazioni, consulta la documentazione dell'API KeyRing.create
.
Passaggi successivi
- Scopri come creare una chiave.
- Scopri come importare le chiavi.
- Scopri come creare chiavi esterne.