1. Creare i vault

Un vault è un repository singolo che controlla l'accesso di un utente o di un gruppo di accesso alle chiavi gestite e ai keystore tramite Cloud Identity and Access Management (IAM).

Completa la seguente procedura per creare il tuo primo vault:

1. Dalla tua IU dell'istanza del servizio, fai clic su Vaults dalla navigazione per visualizzare tutti i vault disponibili.
2. Fare clic su Crea vault.
3. Immettere un nome in Nome vault. Il nome del vault può contenere da 1 a 100 caratteri. Facoltativamente, puoi aggiungere una descrizione estesa al tuo vault nella sezione Descrizione.
4. Fare clic su Crea vault per confermare.

2. Creare i keystore

Un keystore è un repository che memorizza le chiavi crittografiche. È possibile creare un keystore interno all'istanza del servizio o connettersi a un keystore esterno in un'altra istanza del servizio o anche in un altro provider cloud, come ad esempio Microsoft Azure Key Vault, Amazon Web Services (AWS) Key Management Service (KMS) e Google Cloud KMS.

Completare la seguente procedura per creare il primo keystore interno:

1. Dalla tua IU dell'istanza del servizio, fai clic su Keystore dalla navigazione per visualizzare tutti i keystore disponibili.
2. Fare clic su Aggiungi keystore.
3. Sotto Vault, selezionare il vault creato e fare clic su Avanti. Se si desidera assegnare il keystore a un nuovo vault, fare clic su Crea vault.
4. In Tipo keystore, selezionare IBM Cloud KMS e fare clic su Avanti.
5. In Proprietà del keystore, immettere un nome in Nome keystore. Il nome keystore può contenere da 1 a 100 caratteri. Quindi, fare clic su Avanti.
6. In Riepilogo, è possibile visualizzare il riepilogo del keystore creato, incluso il tipo di keystore, il vault assegnato e le proprietà generali.
7. Dopo aver confermato i dettagli del keystore, fare clic su Crea keystore per creare il keystore.

3. Crea template chiave

La maschera chiave specifica le proprietà delle chiavi gestite da creare, come la convenzione di denominazione, l'algoritmo chiave e la lunghezza chiave.

Completa la seguente procedura per creare il tuo primo modello di chiave:

1. Dalla tua IU della tua istanza del servizio, fai clic su Key templates dalla navigazione.
2. Fai clic su Create key template.
3. In Vault, selezionare il vault appena creato e fare clic su Avanti.
4. In Keystore, selezionare IBM Cloud KMS come tipo di keystore, selezionare il keystore appena creato e fare clic su Avanti.
5. Sotto Proprietà del template chiave, specificare i seguenti dettagli del template chiave. Fai clic su Next per continuare.
6. In Riepilogo, visualizzare il riepilogo del modello di chiave, quindi fare clic su Crea modello di chiave per completare la creazione del modello di chiave.

4. Creare le chiavi gestite

È possibile utilizzare una chiave gestita per la codifica o la decodifica solo dopo che è stata creata e attivata in almeno un keystore. Completa la seguente procedura per creare la prima chiave KMS IBM Cloud e attivare la chiave nel keystore che crei:

1. Dalla tua IU dell'istanza del servizio, fai clic su Chiavi gestite dalla navigazione per visualizzare tutte le chiavi disponibili.
2. Fai clic su Create key.
3. In Vault, selezionare il vault appena creato e fare clic su Avanti.
4. In Template chiave, selezionare Crea da un template chiave, quindi selezionare il modello chiave appena creato e fare clic su Avanti.
5. In Proprietà chiave, specificare i dettagli della chiave. Fare clic su Avanti per continuare. Si noti che le chiavi Pre-active non devono essere installate nei keystore finché non vengono attivate manualmente. Le chiavi Active devono essere installate automaticamente nei keystore. Per ulteriori informazioni sulle proprietà della chiave, consulta Creazione di chiavi gestite con un modello di chiave nell'IU IBM Cloud.
6. In Riepilogo, visualizzare il riepilogo della chiave e fare clic su Crea chiave per creare la chiave.

Esecuzione di operazioni crittografiche con l'API PKCS #11

Per eseguire operazioni crittografiche con l'API PKCS #11 , completare la seguente procedura:

1. Imposta ID servizio, ruoli e azioni PKCS #11 . Per ulteriori informazioni, vedi Impostazione dei tipi utente API PKCS #11.
2. Scaricare, installare e configurare la libreria client PKCS #11 . Per ulteriori informazioni sulla configurazione della libreria client PKCS #11 , consultare Esecuzione di operazioni crittografiche con l'API PKCS #11.

Esecuzione di operazioni crittografiche con l'API GREP11

Per eseguire le operazioni di crittografia con l'API GREP11, devi assicurarti che le tue applicazioni siano sviluppate con linguaggi di programmazione supportati da gRPC.

La seguente procedura utilizza il codice Golang come esempio per verificare le funzioni GREP11.

1. Installa Golang seguendo l'istruzione.

2. Clona il repository GitHub di esempio per Golang in una directory locale a tua scelta. I moduli Go vengono utilizzati per questo repository, quindi non è necessario posizionare il repository clonato nel GOPATH. Fai riferimento al file README del repository per ulteriori informazioni sugli esempi di codice Go GREP11.

3. Aggiornare il seguente frammento di codice nel file examples/server_test.go.

   var (
       Address        = "<instance_ID>.ep11.us-east.hs-crypto.appdomain.cloud"
       APIKey         = "<ibm_cloud_apikey>"
   )
   

   Nell'esempio di codice,

   • Sostituisci <instance_ID> con il valore del tuo endpoint API GREP11. Per trovare l'URL dell'endpoint del servizio, dalla tua IU della tua istanza del servizio di cui è stato eseguito il provisioning, fai clic su Overview > Connect > Enterprise PKCS #11 endpoint URL.
   • Sostituisci <ibm_cloud_apikey> con la chiave API ID servizio che hai creato.

4. Dalla directory <your_repository_path>/hpcs-grep11-go/examples, eseguire gli esempi eseguendo il comando go test -v -run Example.