Questa pagina mostra come creare un keyring in Cloud KMS. Un keyring è la risorsa principale per le chiavi e le versioni delle chiavi di Cloud KMS. Ogni keyring esiste all'interno di una determinata località. Per ulteriori informazioni su Cloud KMS vedi Risorse Cloud KMS.
Prima di iniziare
Prima di completare le attività in questa pagina, è necessario quanto segue:
- Una risorsa di progetto Google Cloud che contenga delle risorse Cloud KMS. Questo progetto è chiamato progetto chiave. Me che il progetto chiave non contenga altri dell'accesso a specifiche risorse Google Cloud. Abilita l'API Cloud KMS sulla tua chiave progetto.
- Il nome della posizione in cui vuoi creare il keyring. Scegli un'opzione località vicina alle altre risorse e che supporta la scelta livello di protezione. Per visualizzare le località disponibili e i livelli di protezione supportati, consulta Località di Cloud KMS.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per creare i keyring,
chiedi all'amministratore di concederti
Ruolo IAM Amministratore Cloud KMS (roles/cloudkms.admin
) per il progetto o una risorsa padre.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Questo ruolo predefinito contiene le autorizzazioni necessarie per creare i keyring. Per vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per creare i keyring 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 riuscire a ottenere queste autorizzazioni con ruoli personalizzati altri ruoli predefiniti.
Creazione di un keyring
Segui questi passaggi per creare un keyring per la nuova chiave. Se vuoi utilizzare un esistente, puoi creare una chiave.
Console
Vai alla pagina Gestione delle chiavi nella console Google Cloud.
Fai clic su Crea keyring.
In Nome keyring, inserisci un nome per il keyring.
Per Posizione keyring, selezionane una, ad esempio
"us-east1"
.Fai clic su Crea.
gcloud
-
Nella console Google Cloud, attiva 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 keyring che contiene la chiave.LOCATION
: la località Cloud KMS del keyring.
Per informazioni su tutti i flag e sui possibili valori, esegui il comando con
--help
flag.
C#
Per eseguire questo codice, per prima cosa configura un ambiente di sviluppo C# e installare l'SDK Cloud KMS C#.
Go
Per eseguire questo codice, devi prima configurare un ambiente di sviluppo Go e installa l'SDK Cloud KMS Go.
Java
Per eseguire questo codice, per prima cosa configura un ambiente di sviluppo Java e installare l'SDK Java di Cloud KMS.
Node.js
Per eseguire questo codice, devi prima configurare un ambiente di sviluppo Node.js e installare l'SDK Node.js di Cloud KMS.
PHP
Per eseguire questo codice, scopri innanzitutto come utilizzare PHP su Google Cloud e installa l'SDK PHP di Cloud KMS.
Python
Per eseguire questo codice, configura prima un ambiente di sviluppo Python e installare l'SDK per Python di Cloud KMS.
Ruby
Per eseguire questo codice, prima configura un ambiente di sviluppo Ruby e installa l'SDK Ruby di Cloud KMS.
API
In questi esempi viene utilizzato curl come client HTTP per dimostrare l'uso dell'API. Per ulteriori informazioni sul controllo dell'accesso, vedi Accesso 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 il keyring.KEY_RING
: il nome del keyring che contiene la chiave.LOCATION
: la località Cloud KMS del keyring.
Consulta la documentazione dell'API KeyRing.create
per ulteriori informazioni.
Passaggi successivi
- Scopri come creare una chiave.
- Scopri come importare le chiavi.
- Scopri come creare chiavi esterne.