Creazione di modelli di chiavi da zero con l'interfaccia utente

È possibile creare un modello di chiave da zero con il pieno controllo da soli. Per creare un modello di chiave utilizzando l'interfaccia utente, completare i seguenti passaggi:

1. Accedi all'istanza Hyper Protect Crypto Services.

2. Fare clic su Template chiave dalla navigazione per visualizzare tutti i template chiave disponibili.

3. Per creare un modello di chiave, fare clic su Crea modello di chiave.

4. Per controllare l'accesso alle chiavi che devono essere create con il template chiave, in Vault, selezionare un vault e fare clic su Avanti. Tutte le chiavi da creare con il modello chiave verranno gestite nel vault selezionato.

   Se si desidera gestire l'accesso chiave in un nuovo vault, fare clic su Crea vault. Per ulteriori istruzioni, vedi Creazione di vault.

5. In Keystore, effettuare le seguenti operazioni:

   • In Tipo di keystore, selezionare uno dei seguenti tipi di keystore, che determina le proprietà del modello chiave disponibili e il tipo di chiave che si sta per creare con il modello chiave:

     • AWS Key Management Service: creare un template di chiavi per le chiavi da utilizzare e memorizzare in una istanza AWS Key Management Service.
     • Azure Key Vault: crea un modello di chiavi per le chiavi da utilizzare e memorizzare in un Azure Key Vault.
     • Google Cloud KMS: crea un template chiave per le chiavi da utilizzare e archiviare in un keystore KMS Google Cloud.
     • IBM Cloud KMS: crea un template chiave per le chiavi da utilizzare e archiviare nel keystore IBM Cloud Hyper Protect Crypto Services.
     • IBM Key Protect: crea un modello di chiavi per le chiavi da utilizzare e archiviare in un file di chiavi IBM Key Protect.

     Per ulteriori informazioni sui keystore, consultare Componenti.

   • (Facoltativo) Stabilire dove verranno attivate o memorizzate le chiavi da creare con il modello di chiavi in Keystore impostando il gruppo di keystore. L'attivazione di una chiave in più keystore abilita la ridondanza.

     Se non ci sono keystore esistenti, fare clic su Aggiungi keystore per creare keystore KMS interni o connettersi ai keystore esterni.

     Una volta selezionato un tipo di keystore, è possibile creare chiavi solo nei keystore di questo tipo.

6. Fai clic su Next per continuare.

7. Sotto Proprietà del template chiave, specificare i seguenti dettagli del template chiave. Fare clic su Avanti per continuare. Per impostazione predefinita, alcune configurazioni sono preselezionate. Tuttavia, è possibile modificarlo in base alle proprie necessità.

   Tabella 1. AWS Proprietà dei modelli chiave

   Proprietà	Descrizione
   Nome modello di chiave	Un nome univoco e leggibile per identificare facilmente il modello di chiave. Deve avere una lunghezza compresa tra 1 e 100 caratteri.
   Descrizione	(Facoltativo) Una descrizione estesa per il modello di chiave, con un massimo di 200 caratteri.
   Schema di denominazione	(Facoltativo) Immettere stringhe o segnaposto per applicare lo schema di denominazione delle chiavi. Dopo aver definito lo schema di denominazione delle chiavi, è possibile creare un gruppo di chiavi con le stesse convenzioni di denominazione delle chiavi, ma non è più possibile modificare lo schema di denominazione delle chiavi. Per ulteriori informazioni, consultare Definizione degli schemi di denominazione delle chiavi.
   Esempio di nome chiave gestita	Sola lettura. Un esempio di nome chiave gestito basato sullo schema di denominazione delle chiavi viene compilato automaticamente come riferimento.
   Algoritmo	L'algoritmo di codifica per crittografare i dati per la chiave da creare con il modello.
   Lunghezza	Il numero di bit che rappresenta il livello di crittografia della chiave da creare con il template.
   Stato	Lo stato della chiave iniziale da creare con il modello chiave, inclusi Pre - attivo e Attivo. Le chiavi pre - attive non sono attivate nei keystore per la codifica. Le chiavi attive vengono attivate automaticamente nei keystore. Per ulteriori informazioni sugli stati della chiave, vedi Monitoraggio del ciclo di vita delle chiavi di codifica in Unified Key Orchestrator.
   Attiva chiavi dopo	(Facoltativo) Pianificare una data per l'attivazione delle chiavi pre - attive da creare dalla creazione della chiave. È solo a scopo di pianificazione.
   Disattiva chiavi dopo	(Facoltativo) Pianificare una data per disattivare le chiavi da creare dalla creazione della chiave. È solo a scopo di pianificazione.

   Tabella 2. Azure Proprietà dei modelli chiave

   Proprietà	Descrizione
   Nome modello di chiave	Un nome univoco e leggibile per identificare facilmente il modello di chiave. Deve avere una lunghezza compresa tra 1 e 100 caratteri.
   Descrizione	(Facoltativo) Una descrizione estesa per il modello di chiave, con un massimo di 200 caratteri.
   Schema di denominazione	(Facoltativo) Immettere stringhe o segnaposto per applicare lo schema di denominazione delle chiavi. Dopo aver definito lo schema di denominazione delle chiavi, è possibile creare un gruppo di chiavi con le stesse convenzioni di denominazione delle chiavi, ma non è più possibile modificare lo schema di denominazione delle chiavi. Per ulteriori informazioni, consultare Definizione degli schemi di denominazione delle chiavi.
   Esempio di nome chiave gestita	Sola lettura. Un esempio di nome chiave gestito basato sullo schema di denominazione delle chiavi viene compilato automaticamente come riferimento.
   Livello di protezione	Livello di protezione dei dati delle chiavi da creare con il modello di chiave Chiave protetta da HSM viene archiviato e generato in un modulo di sicurezza hardware certificato FIPS. È disponibile solo in Azure Key Vault (Premium). Questo tipo di chiavi garantisce la massima sicurezza. Chiave protetta da software è disponibile in entrambiAzure Key Valut (Standard) e Key Vault (Premium). Puoi scegliere questo livello per ridurre i costi. Nota: se ti connetti a un keystore esterno di tipo Azure Key Vault, puoi distribuire sia le chiavi protette da HSM che quelle protette dal software a Azure Key Vault (Premium). Tuttavia, è possibile distribuire solo chiavi protette da software aAzure Insieme di credenziali delle chiavi (standard).
   Algoritmo	L'algoritmo di codifica per crittografare i dati per la chiave da creare con il modello.
   Lunghezza	Il numero di bit che rappresenta il livello di crittografia della chiave da creare con il template.
   Stato	Lo stato della chiave iniziale da creare con il modello chiave, inclusi Pre - attivo e Attivo. Le chiavi pre - attive non sono attivate nei keystore per la codifica. Le chiavi attive vengono attivate automaticamente nei keystore. Per ulteriori informazioni sugli stati della chiave, vedi Monitoraggio del ciclo di vita delle chiavi di codifica in Unified Key Orchestrator.
   Attiva chiavi dopo	(Facoltativo) Pianificare una data per l'attivazione delle chiavi pre - attive da creare dalla creazione della chiave. È solo a scopo di pianificazione.
   Disattiva chiavi dopo	(Facoltativo) Pianificare una data per disattivare le chiavi da creare dalla creazione della chiave. È solo a scopo di pianificazione.

   Tabella 3. Google Proprietà dei modelli chiave

   Proprietà	Descrizione
   Nome modello di chiave	Un nome univoco e leggibile per identificare facilmente il modello di chiave. Deve avere una lunghezza compresa tra 1 e 100 caratteri.
   Descrizione	(Facoltativo) Una descrizione estesa per il modello di chiave, con un massimo di 200 caratteri.
   Schema di denominazione	(Facoltativo) Immettere stringhe o segnaposto per applicare lo schema di denominazione delle chiavi. Dopo aver definito lo schema di denominazione delle chiavi, è possibile creare un gruppo di chiavi con le stesse convenzioni di denominazione delle chiavi, ma non è più possibile modificare lo schema di denominazione delle chiavi. Per ulteriori informazioni, consultare Definizione degli schemi di denominazione delle chiavi.
   Esempio di nome chiave gestita	Sola lettura. Un esempio di nome chiave gestito basato sullo schema di denominazione delle chiavi viene compilato automaticamente come riferimento.
   Livello di protezione	Livello di protezione dei dati delle chiavi da creare con il modello di chiave Il livello di protezione chiave protetta da HSM si applica alle chiavi protette da HSM (Hardware Security Module) FIPS 140-2 livello 3 in Google Cloud. Questo tipo di chiavi garantisce una maggiore sicurezza. Il livello di protezione Chiave protetta dal software si riferisce alle chiavi protette dal software. È possibile scegliere questo livello per ridurre i costi. Per ulteriori informazioni, vedi Cloud KMS software backend: SOFTWARE protection level e Cloud KMS HSM backend: HARDWARE protection level. Nota: le chiavi protette dal software non supportano l'algoritmo della curva ellittica secp256k1.
   Scopo	Le funzionalità crittografiche della chiave, che è ciò che si intende fare con questa chiave. Lo scopo determina anche gli algoritmi chiave disponibili. Gli scopi chiave supportati sono Symmetric encrypt/decrypt, Asymmetric sign, Asymmetric decrypt e MAC signing/verification. Per ulteriori informazioni, vedi Scopo chiave.
   Stato	Lo stato della chiave iniziale da creare con il modello chiave, inclusi Pre - attivo e Attivo. Le chiavi pre - attive non sono attivate nei keystore per la codifica. Le chiavi attive vengono attivate automaticamente nei keystore. Per ulteriori informazioni sugli stati della chiave, vedi Monitoraggio del ciclo di vita delle chiavi di codifica in Unified Key Orchestrator.
   Attiva chiavi dopo	(Facoltativo) Pianificare una data per l'attivazione delle chiavi pre - attive da creare dalla creazione della chiave. È solo a scopo di pianificazione.
   Disattiva chiavi dopo	(Facoltativo) Pianificare una data per disattivare le chiavi da creare dalla creazione della chiave. È solo a scopo di pianificazione.

   Tabella 4. IBM Cloud Proprietà dei modelli di chiavi KMS

   Proprietà	Descrizione
   Nome modello di chiave	Un nome univoco e leggibile per identificare facilmente il modello di chiave. Deve avere una lunghezza compresa tra 1 e 100 caratteri.
   Descrizione	(Facoltativo) Una descrizione estesa per il modello di chiave, con un massimo di 200 caratteri.
   Schema di denominazione	(Facoltativo) Immettere stringhe o segnaposto per applicare lo schema di denominazione delle chiavi. Dopo aver definito lo schema di denominazione delle chiavi, è possibile creare un gruppo di chiavi con le stesse convenzioni di denominazione delle chiavi, ma non è più possibile modificare lo schema di denominazione delle chiavi. Per ulteriori informazioni, consultare Definizione degli schemi di denominazione delle chiavi.
   Esempio di nome chiave gestita	Sola lettura. Un esempio di nome chiave gestito basato sullo schema di denominazione delle chiavi viene compilato automaticamente come riferimento.
   Algoritmo	L'algoritmo di codifica per crittografare i dati per la chiave da creare con il modello.
   Lunghezza	Il numero di bit che rappresenta il livello di crittografia della chiave da creare con il template.
   Stato	Lo stato della chiave iniziale da creare con il modello chiave, inclusi Pre - attivo e Attivo. Le chiavi pre - attive non sono attivate nei keystore per la codifica. Le chiavi attive vengono attivate automaticamente nei keystore. Per ulteriori informazioni sugli stati della chiave, vedi Monitoraggio del ciclo di vita delle chiavi di codifica in Unified Key Orchestrator.
   Attiva chiavi dopo	(Facoltativo) Pianificare una data per l'attivazione delle chiavi pre - attive da creare dalla creazione della chiave. È solo a scopo di pianificazione.
   Disattiva chiavi dopo	(Facoltativo) Pianificare una data per disattivare le chiavi da creare dalla creazione della chiave. È solo a scopo di pianificazione.

   Tabella 5. IBM Key Protect Key templates

   Proprietà	Descrizione
   Nome modello di chiave	Un nome univoco e leggibile per identificare facilmente il modello di chiave. Deve avere una lunghezza compresa tra 1 e 100 caratteri.
   Descrizione	(Facoltativo) Una descrizione estesa per il modello di chiave, con un massimo di 200 caratteri.
   Schema di denominazione	(Facoltativo) Immettere stringhe o segnaposto per applicare lo schema di denominazione delle chiavi. Dopo aver definito lo schema di denominazione delle chiavi, è possibile creare un gruppo di chiavi con le stesse convenzioni di denominazione delle chiavi, ma non è più possibile modificare lo schema di denominazione delle chiavi. Per ulteriori informazioni, consultare Definizione degli schemi di denominazione delle chiavi.
   Esempio di nome chiave gestita	Sola lettura. Un esempio di nome chiave gestito basato sullo schema di denominazione delle chiavi viene compilato automaticamente come riferimento.
   Algoritmo	L'algoritmo di codifica per crittografare i dati per la chiave da creare con il modello.
   Lunghezza	Il numero di bit che rappresenta il livello di crittografia della chiave da creare con il template.
   Stato	Lo stato della chiave iniziale da creare con il modello chiave, inclusi Pre - attivo e Attivo. Le chiavi pre - attive non sono attivate nei keystore per la codifica. Le chiavi attive vengono attivate automaticamente nei keystore. Per ulteriori informazioni sugli stati della chiave, vedi Monitoraggio del ciclo di vita delle chiavi di codifica in Unified Key Orchestrator.
   Attiva chiavi dopo	(Facoltativo) Pianificare una data per l'attivazione delle chiavi pre - attive da creare dalla creazione della chiave. È solo a scopo di pianificazione.
   Disattiva chiavi dopo	(Facoltativo) Pianificare una data per disattivare le chiavi da creare dalla creazione della chiave. È solo a scopo di pianificazione.

8. In Riepilogo, visualizzare il riepilogo del modello di chiave, quindi fare clic su Crea modello di chiave per confermare.

È stato correttamente creato un modello di chiave.

Creazione di modelli di chiavi da zero tramite API

Per creare un modello di chiave da zero tramite l'API, attieniti alla seguente procedura:

1. Richiama le credenziali di autenticazione e del servizio per utilizzare i modelli chiave nel servizio.

2. Crea un modello di chiave creando un file POST chiamata al seguente endpoint.

   https://<instance_ID>.uko.<region>.hs-crypto.appdomain.cloud/api/v4/templates
   
   

   Per istruzioni dettagliate ed esempi di codice sull'uso del metodo API, consulta la documentazione di riferimento APIHyper Protect Crypto Services Unified Key Orchestrator.

Creazione di una copia di un modello di chiave esistente con l'interfaccia utente

Se si desidera personalizzare un modello di chiave basato su un modello esistente, creare una copia del modello di chiave e quindi modificare le proprietà del modello. È possibile copiare da un modello di chiave attivo o archiviato. Per farlo tramite l'interfaccia utente, completa la seguente procedura:

1. Accedi all'istanza Hyper Protect Crypto Services.

2. Fare clic su Template chiave dalla navigazione per visualizzare tutti i template chiave disponibili.

   È possibile visualizzare i modelli chiave archiviati facendo clic sull'icona Mostra modelli archiviati sulla tabella.

3. Individuare il modello di chiave che si desidera copiare dall'elenco, fare clic sull'icona Azioni e selezionare Copia.

   In alternativa, fare clic sull'icona Azioni e selezionare Mostra dettagli. Quindi, nella pagina dei dettagli del template, selezionare Azioni > Copia.

4. Tutte le proprietà sono preconfigurati in base al modello di chiave copiato. È comunque possibile apportare le seguenti modifiche, se necessario:

   • Vault
   • Tipo di keystore
   • Keystore
   • Proprietà modello di chiave

   Fare riferimento a Creazione di modelli chiave da zero con l'interfaccia utente per spiegazioni dettagliate.

5. In Riepilogo, visualizzare il riepilogo del modello di chiave, quindi fare clic su Crea modello di chiave per confermare.

È stata creata correttamente una copia di un modello di chiave esistente.

Creazione di modelli di chiavi da un modello di chiave esistente tramite l'API

Per eseguire una copia da un modello di chiave esistente tramite l'API, attieniti alla seguente procedura:

1. Richiama le credenziali di autenticazione e del servizio per utilizzare i modelli chiave nel servizio.

2. Crea un modello di chiave creando un file POST chiamata al seguente endpoint.

   https://<instance_ID>.uko.<region>.hs-crypto.appdomain.cloud/api/v4/templates
   
   

   Per istruzioni dettagliate ed esempi di codice sull'uso del metodo API, consulta la documentazione di riferimento APIHyper Protect Crypto Services Unified Key Orchestrator.

Definizione degli schemi di denominazione delle chiavi

Definendo lo schema di denominazione delle chiavi per il template delle chiavi, è possibile creare un gruppo di chiavi con le stesse convenzioni di denominazione delle chiavi. È possibile specificare diversi segnaposti di schema di denominazione. Gli schemi di denominazione sono costituiti da stringhe fisse, segnaposti personalizzati e segnaposti di sistema, che verranno popolati durante la creazione di ogni chiave.

Quando si definisce uno schema di denominazione delle chiavi, un esempio di nome di chiave gestita basato sullo schema di denominazione delle chiavi viene popolato automaticamente come riferimento in Esempio di denominazione delle chiavi gestite. Ad esempio, se si immette akms-<PROJECT>-<LOCATION>-<ENV>-appdata come schema di denominazione delle chiavi, viene visualizzato un esempio di nome di chiave gestita akms-XYZ-XYZ-XYZ-appdata. In questo esempio, akms e appdata sono le stringhe fisse e XYZ è il valore per PROJECT, LOCATION e ENV che è necessario fornire ogni volta durante la creazione della chiave con questo template chiave.

Tenere presente quanto segue:

• A seconda del tipo di keystore, i requisiti di denominazione chiave possono essere diversi:

  • AWS Key Management Service: deve contenere da 1 a 250 caratteri. I caratteri possono essere lettere (con distinzione tra maiuscole e minuscole), cifre (0–9) o simboli (/_-). Tuttavia, non iniziare il nome con AWS/.
  • Azure Key Vault: deve avere una lunghezza compresa tra 1 e 127 caratteri. I caratteri possono essere lettere (con distinzione tra maiuscole e minuscole), cifre (0–9) o trattini (-).
  • KMS Google Cloud: deve contenere da 1 a 63 caratteri. I caratteri possono essere lettere (con distinzione tra maiuscole e minuscole), cifre (0–9) o simboli (_-).
  • IBM Cloud KMS: deve avere una lunghezza compresa tra 2 e 50 caratteri. I caratteri possono essere lettere (con distinzione tra maiuscole e minuscole), cifre (0–9) o spazi.
  • IBM Key Protect: deve avere una lunghezza compresa tra 2 e 50 caratteri. I caratteri possono essere lettere (con distinzione tra maiuscole e minuscole), cifre (0–9) o spazi.

• Immettere stringhe fisse o segnaposto per lo schema di denominazione delle chiavi. Ogni segnaposto deve avere una lunghezza compresa tra 1 e 20 caratteri. Notare che Š necessario utilizzare le parentesi angolari (<>) per inserire i segnaposto.

• Immettere una parentesi angolare di apertura (<) oppure fare clic sulla tag segnaposto di sistema per inserire un segnaposto di sistema. Ogni segnaposto di sistema è composto da lettere (sensibili al maiuscolo / minuscolo), cifre (0-9) o una barra (/). La seguente tabella elenca i segnaposto di sistema:

  Se i nomi delle chiavi contengono segnaposto di sistema, le chiavi da creare non possono essere ruotate.

  Tabella 8. Segnaposto di sistema per lo schema di denominazione

  Segnaposto di sistema	Ortografia alternativa	Descrizione
  lastActiveYear	lay lastActiveYear/yyyy lay/yyyy lastActiveYear/4 lay/4	Un formato a 4 cifre dell'anno in cui la chiave è scaduta.
  lastActiveYear/yy	lay/2 lastActiveYear/2 lay/yy	Un formato a 2 cifre dell'anno in cui la chiave è scaduta.
  lastActiveMonth	lam	Un formato a 2 cifre del mese in cui la chiave è scaduta.
  yy		Un formato a 2 cifre dell'anno in cui è stata creata la chiave.
  yyyy		Un formato a 4 cifre dell'anno in cui è stata creata la chiave.
  mm		Un formato a due cifre del mese in cui è stata creata la chiave.

• Non utilizzare i seguenti segnaposti riservati per lo schema di denominazione delle chiavi.

  Tabella 9. Segnaposto riservati per lo schema di denominazione

  Segnaposto riservato	Ortografia alternativa
  SEQUENCENUMBER	seqno sqn sequenceNumber SEQNO SQN
  hierarchy	h hier
  keyType	kt
  institutionId	iid

• È possibile immettere una parentesi angolare di apertura (<) per inserire un segnaposto personalizzato. Ogni segnaposto personalizzato è composto da lettere (sensibili al maiuscolo / minuscolo) o cifre (0-9). Per applicare lo schema di denominazione a più chiavi, assicurarsi di utilizzare almeno un segnaposto personalizzato.

• Se definisci un segnaposto personalizzato, devi fornire un valore per il segnaposto durante la creazione della chiave.

• Non è possibile modificare il nome chiave dopo la creazione della chiave gestita con gli schemi di denominazione delle chiavi.