Creazione di un adattatore

È possibile creare un massimo di 200 adattatori su una singola istanza. Ogni adattatore può avere un massimo di 200 certificati associati.

Gli adattatori KMIP vengono creati usando le chiavi radice Key Protect. Se non si dispone di una chiave principale, crearne una.

Prima di iniziare, assicurati di disporre del ruolo “ Manager ” o del ruolo “ KmipAdapterManager ” sull’istanza.

Per creare un adattatore:

1. Nel menu di navigazione, fare clic su " Adattatori KMIP ". Se questo è il tuo primo adattatore, la tabella è vuota.

2. Fai clic su Crea.

3. Nel riquadro laterale, inserire le seguenti informazioni:

   • Nome- Inserisci un nome per l'adattatore (da 2 a 40 caratteri).
   • Descrizione (facoltativa)- Inserisci una descrizione per l'adattatore (da 2 a 240 caratteri).
   • Chiave di base- Selezionare la chiave di base da utilizzare per questo adattatore. La chiave radice crittografa le chiavi KMIP generate dall'adattatore. Affinché l'adattatore funzioni correttamente, la chiave root deve trovarsi in uno stato " active ".

4. Facoltativo: aggiungere un certificato pubblico TLS per consentire al titolare del corrispondente certificato privato di comunicare con Key Protect tramite l'adattatore KMIP. Solo i certificati autorizzati possono inviare richieste tramite il protocollo KMIP alla tua istanza.

   Per aggiungere un certificato:

   1. Fai clic su Aggiungi.
   2. Inserisci un nome per il certificato.
   3. Inserisci il contenuto del certificato nel formato PEM, includendo i tag BEGIN CERTIFICATE e END CERTIFICATE.
   4. Fare clic su " Aggiungi certificato ".

   L'associazione dei certificati può richiedere alcuni minuti. Un certificato può essere associato a un solo adattatore in una regione di Key Protect.

Non è possibile accedere alle risorse gestite tramite il protocollo KMIP tramite l'API HTTP.

Conservare in modo sicuro la chiave privata di tutti i certificati caricati. Qualsiasi certificato caricato su un adattatore KMIP è in grado di eseguire tutte le operazioni KMIP supportate.

Visualizzazione e aggiornamento dei dettagli dell'adattatore

Il pannello dei dettagli dell'adattatore mostra le informazioni relative a un adattatore e consente di eseguire operazioni quali l'aggiunta di certificati.

Per visualizzare i dettagli dell'adattatore:

1. Fai clic sul menu delle azioni (⋯) relativo all'adattatore.
2. Seleziona " Dettagli ".

Il pannello dei dettagli mostra il nome dell'adattatore, la descrizione, le chiavi simmetriche KMIP associate e i certificati caricati. Da questa schermata è anche possibile caricare ulteriori certificati.

Le chiavi simmetriche KMIP non possono essere eliminate tramite la console. Per eliminare le chiavi, utilizzare l'interfaccia a riga di comando (CLI). È possibile eliminare solo le chiavi simmetriche KMIP che non si trovano nello stato " Active " (stato 1). Non è possibile eliminare un adattatore se contiene chiavi con lo stato " Active ".

Le risorse di ciascun adattatore sono protette da una chiave principale. Non è possibile eliminare una chiave root attiva e associata a un adattatore.

Ogni chiave simmetrica KMIP creata conta come una singola versione di chiave e comporta l'addebito di una versione di chiave. La cancellazione di una chiave simmetrica KMIP è definitiva.

Creazione e utilizzo di adattatori KMIP nell'API

Questa sezione illustra come utilizzare gli adattatori KMIP del profilo native_1.0 con l'API, comprese le operazioni di aggiunta e rimozione dei certificati client KMIP e di visualizzazione ed eliminazione degli oggetti KMIP.

È possibile creare un adattatore KMIP effettuando una chiamata POST al seguente endpoint.

https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters

Le operazioni sulle sottorisorse dell'adattatore KMIP, compresi i certificati client KMIP e gli oggetti KMIP, saranno effettuate nei seguenti endpoint:

https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters/<adapter_name_or_ID>/certificates
https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters/<adapter_name_or_ID>/kmip_objects

1. Recupera le credenziali di autenticazione per lavorare con le chiavi nel servizio.

2. Copiare l'ID della chiave principale che si desidera utilizzare per creare l'adattatore KMIP.

   È possibile trovare l'ID di una chiave nel file Key Protect istanza di recuperando un elenco di chiavi, o accedendo all'istanza Key Protect. cruscotto.

3. Creare un adattatore KMIP con il seguente comando curl:

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters" \
       -H "accept: application/vnd.ibm.kms.kmip_adapter+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.kmip_adapter+json" \
       -d '{
               "metadata": {
                   "collectionType": "application/vnd.ibm.kms.kmip_adapter+json",
                   "collectionTotal": 1
               },
               "resources": [
                   {
                   "name": "<adapter_name>",
                   "description": "<adapter_description>",
                   "profile": "native_1.0",
                   "profile_data": {
                       "crk_id": "<root_keyID_or_alias>"
                   }
                   }
               ]
           }'
   

   Sostituisci le variabili nella richiesta di esempio in base alla seguente tabella.

4. Opzionale: è possibile elencare gli adattatori KMIP esistenti in un'istanza con il seguente comando curl:

   $ curl -X GET \
       "https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters" \
       -H "accept: application/vnd.ibm.kms.kmip_adapter+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.kmip_adapter+json"
   

   È inoltre possibile ottenere un adattatore KMIP specifico utilizzando il seguente comando curl:

   $ curl -X GET \
       "https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters/<adapter_name_or_ID>" \
       -H "accept: application/vnd.ibm.kms.kmip_adapter+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.kmip_adapter+json"
   

   Si noti che è possibile utilizzare l'UUID dell'adattatore o il nome dell'adattatore per ottenere un adattatore specifico.

5. È possibile eliminare un adattatore KMIP con il seguente comando curl:

   $ curl -X DELETE \
       "https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters/<adapter_name_or_ID>" \
       -H "accept: application/vnd.ibm.kms.kmip_adapter+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.kmip_adapter+json"
   

   È possibile eliminare l'adattatore KMIP solo se tutti gli oggetti KMIP sotto l'adattatore sono stati eliminati.