Creazione di anelli chiave con la UI

Devi avere il ruolo di servizio "Writer" o "Manager" per creare un anello chiave.

Per creare un portachiavi:

1. Clicca su anelli chiave nella navigazione a sinistra.
2. Nel pannello Key rings, fare clic sul pulsante Crea.
3. Nella scheda Crea una key ring, dare un nome al tuo nuovo key ring, seguendo le istruzioni sui caratteri consentiti. Quindi fare clic su Crea.

Dopo aver creato, il tuo nuovo anello chiave apparirà nella lista degli anelli chiave e sei in grado di trasferire chiavi in esso o creare chiavi per esso.

Se gestite i portachiavi in modo coerente in più ambienti, potete automatizzare la disposizione dei portachiavi e delle chiavi con il modulo Key Protect Key Ring o con il più ampio modulo Key Protect All-Inclusive. Per il contesto, vedere Informazioni sui moduli Terraform IBM.

Creazione di anelli chiave con l'API

Crea un portachiavi effettuando una chiamata di tipo " POST " all'endpoint seguente.

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

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

2. Creare un anello chiave eseguendo il seguente comando curl.

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/key_rings/<key_ring_id>" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "correlation-id: <correlation_ID>"
   

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

Una richiesta POST api/v2/key_rings andata a buon fine restituisce un HTTP 201 Created risposta, che indica che l'anello chiave è stato creato ed è ora disponibile per tenere chiavi standard e di root.

Concessione accesso ad un anello chiave

È possibile concedere l'accesso ad un anello chiave all'interno di un'istanza Key Protect utilizzando la console IBM Cloud, IAM APIo CLI{ :external}.

Riesamina ruoli e autorizzazioni per scoprire come si mappano i ruoli IBM Cloud IAM alle azioni Key Protect.

Per assegnare l'accesso ad un anello chiave con la console:

1. Dalla barra dei menu, fare clic su Gestisci > Accesso (IAM), quindi selezionare Utenti per visualizzare gli utenti presenti nel proprio account.

2. Seleziona una riga di tabella e fai clic sull'icona ⋯ per aprire un elenco di opzioni per tale utente.

3. Dal menu delle opzioni, fai clic su Assegna accesso.

4. Fai clic su " Assegna agli utenti un accesso aggiuntivo ".

5. Fai clic sul pulsante " Servizi IAM ".

6. Dall'elenco dei servizi, selezionare Key Protect.

7. Seleziona i servizi in base agli attributi.

8. Selezionare l'attributo ID istanza e selezionare l'istanza in cui risiede l'anello chiave.

9. Selezionare l'attributo ID key ring ed inserire l'ID associato all'anello chiave.

10. Scegli una combinazione di ruoli di accesso alla piattaforma e al servizio per assegnare l'accesso per l'utente.

11. Fai clic su Aggiungi.

12. Continuare ad aggiungere ruoli di accesso alla piattaforma e al servizio in base alle necessità e quando si è terminato, fare clic su Assegna. Si tenga presente che l'utente deve essere assegnato almeno Reader l'accesso all'intera istanza al fine di elencare, creare ed eliminare gli anelli chiave all'interno dell'istanza.

Elenco degli anelli chiave con l'API

Per una panoramica generale, è possibile visualizzare i portachiavi gestiti nella propria istanza di Key Protect già configurata, effettuando una chiamata GET all'endpoint seguente.

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

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

2. Visualizza le caratteristiche generali sui tuoi anelli chiave eseguendo il seguente curl .

   $ curl -X GET \ "https://<region>.kms.cloud.ibm.com/api/v2/key_rings?totalCount=<show_total>&offset=<offset_value>&limit=<offset_limit>" \
       -H "accept: application/vnd.ibm.kms.key_ring+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "correlation-id: <correlation_ID>"
   

   I parametri di query che seguono il punto interrogativo ? sono facoltativi, ma inclusi qui per documentarne l'utilizzo. (: :nota)

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

Una richiesta GET api/v2/key_rings di successo restituisce una raccolta di anelli chiave disponibili nel tuo Key Protect istanza di servizio.

{
    "metadata": {
        "collectionType": "application/vnd.ibm.kms.key_ring+json",
        "collectionTotal": 2
    },
    "resources": [
        {
            "id": "default"
        },
        {
            "id": "Sample Key Ring 2",
            "creationDate": "2020-03-12T11:00:06Z",
            "createdBy": "..."
        }
    ]
}

Eliminazione degli anelli chiave con l'API

È possibile eliminare un portachiavi effettuando una chiamata di tipo " DELETE " all'endpoint seguente.

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

Questa azione non avrà esito positivo se il key ring contiene almeno una chiave in uno stato diverso da Destroyed . Se le uniche chiavi nel key ring sono nello stato Destroyed , il key ring può essere eliminato se force=true viene aggiunto al comando delete. Le chiavi in tale stato vengono automaticamente trasferite al keyring default.

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

2. Recupera l'ID del portachiavi che desideri eliminare.

   Puoi trovare l'ID per un anello chiave nel tuo Key Protect istanza da recuperando una lista dei tuoi anelli chiave.

3. Esegui il seguente comando curl per eliminare il portachiavi. Notare la presenza di force=true, che forza l'eliminazione del keyring nel caso in cui contenga chiavi nello stato Distrutto .

   $ curl -X DELETE \
       "https://<region>.kms.cloud.ibm.com/api/v2/key_rings/<key_ring_id>?force=true" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "prefer: <return_preference>"
   

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

Una richiesta andata a buon fine restituisce una risposta HTTP 204 No Content, che indica che il portachiavi è stato eliminato con successo indica che il portachiavi è stato cancellato con successo.