Disabilitazione di una chiave root nella console

Dopo aver creato o importato le chiavi esistenti nel servizio, segui questi passaggi per disattivare una chiave:

1. Accedi alla console IBM Cloud.

2. Vai su Menu > Elenco risorse per visualizzare l'elenco delle tue risorse.

3. Dal tuo elenco risorse IBM Cloud, seleziona la tua istanza di cui è stato eseguito il provisioning di Key Protect.

4. Nella pagina dei dettagli dell'applicazione, utilizza la tabella "Chiavi " per visualizzare le chiavi presenti nella tua istanza di Key Protect.

5. Fai clic sull'icona ⋯ per aprire un elenco di opzioni relative al tasto che desideri disattivare.

6. Dal menu delle opzioni, fare clic su "Disattiva " e verificare che la chiave sia stata disattivata nella tabella delle chiavi aggiornata.

Abilitazione di una chiave root nella console

Dopo aver creato o importato le tue chiavi esistenti nel servizio e disabilitare una chiave root, completa la seguente procedura per abilitare la chiave:

1. Accedi alla console IBM Cloud.

2. Vai su Menu > Elenco risorse per visualizzare l'elenco delle tue risorse.

3. Dal tuo elenco risorse IBM Cloud, seleziona la tua istanza di cui è stato eseguito il provisioning di Key Protect.

4. Nella pagina dei dettagli dell'applicazione, utilizza la tabella Keys per sfogliare le chiavi nel tuo servizio.

5. Fai clic sull'icona ⋯ per aprire un elenco di opzioni relative al tasto che desideri attivare.

6. Dal menu delle opzioni, fare clic su "Abilita " e verificare che la chiave sia stata abilitata nella tabella " Chiavi " aggiornata.

Le tasti non possono essere abilitate immediatamente dopo essere state abilitate. Se una chiave è stata disabilitata per errore, attendere almeno 30 secondi prima di tentare di riabilitarla.

Disabilitazione di una chiave root con la API

Puoi disabilitare una chiave root che si trova nello stato della chiave Attiva effettuando una POST al seguente endpoint.

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

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

   Per disabilitare una chiave root, ti deve essere assegnato un ruolo di accesso al servizio Gestore per l'istanza o la chiave. Per informazioni su come i ruoli IAM vengono associati a Key Protect azioni di servizio, controllare Ruoli di accesso al servizio.

2. Recupera l'ID della chiave principale che desideri disabilitare.

   È possibile recuperare l'ID per una chiave specificata creando un GET /v2/keys richiestao visualizzando le tue chiavi nel Dashboard Key Protect.

3. Eseguire il seguente comando curl per disabilitare la chiave root e sospendere le relative operazioni di codifica e decodifica.

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/actions/disable" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "x-kms-key-ring: <key_ring_ID>"
   

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

Una richiesta di disabilitazione riuscita restituisce una risposta HTTP 204 No Content, che indica che la chiave radice è stata disabilitata per le operazioni di crittografia e decrittografia per le operazioni di crittografia e decrittografia.

Facoltativo: verificare la disabilitazione della chiave

È possibile verificare che una chiave sia stata disabilitata emettendo una richiesta di acquisizione metadati chiave:

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

Dove il <keyID_or_alias> è l'ID o l'alias della chiave, il <instance_ID> è il nome della tua istanza e il tuo <IAM_token> è il tuo token IAM.

Esamina il campo state nel corpo della risposta per verificare che la chiave sia passata allo stato della chiave Sospeso . Il seguente output JSON mostra i dettagli dei metadati per una chiave root disabilitata.

L'associazione del numero intero per lo stato chiave Sospeso è 2. Gli Stati chiave si basano sul NIST SP 800-57.

{
    "metadata": {
        "collectionType": "application/vnd.ibm.kms.key+json",
        "collectionTotal": 1
    },
    "resources": [
        {
            "type": "application/vnd.ibm.kms.key+json",
            "id": "02fd6835-6001-4482-a892-13bd2085f75d",
            "name": "...",
            "description": "...",
            "tags": [
                "..."
            ],
            "state": 2,
            "extractable": false,
            "crn": "crn:v1:bluemix:public:kms:us-south:a/f047b55a3362ac06afad8a3f2f5586ea:12e8c9c2-a162-472d-b7d6-8b9a86b815a6:key:02fd6835-6001-4482-a892-13bd2085f75d",
            "imported": true,
            "creationDate": "2020-03-10T20:41:27Z",
            "createdBy": "...",
            "algorithmType": "Deprecated",
            "algorithmMetadata": {
                "bitLength": "128",
                "mode": "Deprecated"
            },
            "algorithmBitSize": 128,
            "algorithmMode": "Deprecated",
            "lastUpdateDate": "2020-03-16T20:41:27Z",
            "keyVersion": {
                "id": "30372f20-d9f1-40b3-b486-a709e1932c9c",
                "creationDate": "2020-03-12T03:37:32Z"
            },
            "dualAuthDelete": {
                "enabled": false
            },
            "deleted": false
        }
    ]
}

Abilitazione di una chiave root disabilitata con l'API

Puoi abilitare una chiave root che si trova nello stato della chiave Sospeso effettuando una POST al seguente endpoint.

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

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

   Per abilitare una chiave root, devi avere un ruolo di accesso al servizio Gestore per l'istanza o la chiave. Per informazioni su come i ruoli IAM vengono associati a Key Protect azioni di servizio, controllare Ruoli di accesso al servizio.

2. Recupera l'ID della chiave root disabilitata che desideri abilitare.

   È possibile recuperare l'ID per una chiave specificata creando un GET /v2/keys richiestao visualizzando le tue chiavi nel Dashboard Key Protect.

3. Eseguire il seguente comando curl per abilitare la chiave root e ripristinare le relative operazioni di codifica e decodifica.

   È necessario attendere 30 secondi dopo la disabilitazione di una chiave root prima di poterla abilitare nuovamente.

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/actions/enable" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "x-kms-key-ring: <key_ring_ID>"
   

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

Una richiesta di abilitazione riuscita restituisce una risposta HTTP 204 No Content, che indica che la chiave root è stata ripristinata per la crittografia e la decrittografia indica che la chiave principale è stata ripristinata per le operazioni di crittografia e decrittografia per le operazioni di crittografia e decrittografia.

Facoltativo: verificare l'abilitazione della chiave

È possibile verificare che una chiave sia stata abilitata emettendo una richiesta di acquisizione dei metadati della chiave:

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

Dove il <keyID_or_alias> è l'ID o l'alias della chiave, il <instance_ID> è il nome della tua istanza e il tuo <IAM_token> è il tuo token IAM.

Rivedi il campo state nel corpo della risposta per verificare che la chiave root sia passata allo stato della chiave Attiva . Il seguente output JSON mostra i dettagli dei metadati per una chiave attiva.

L'associazione dei numeri interi per lo stato chiave Attivo è 1. Gli Stati chiave si basano sul NIST SP 800-57.

{
    "metadata": {
        "collectionType": "application/vnd.ibm.kms.key+json",
        "collectionTotal": 1
    },
    "resources": [
        {
            "type": "application/vnd.ibm.kms.key+json",
            "id": "02fd6835-6001-4482-a892-13bd2085f75d",
            "name": "...",
            "description": "...",
            "tags": [
                "..."
            ],
            "state": 1,
            "extractable": false,
            "crn": "crn:v1:bluemix:public:kms:us-south:a/f047b55a3362ac06afad8a3f2f5586ea:12e8c9c2-a162-472d-b7d6-8b9a86b815a6:key:02fd6835-6001-4482-a892-13bd2085f75d",
            "imported": true,
            "creationDate": "2020-03-10T20:41:27Z",
            "createdBy": "...",
            "algorithmType": "AES",
            "algorithmMetadata": {
                "bitLength": "128",
                "mode": "CBC_PAD"
            },
            "algorithmBitSize": 128,
            "algorithmMode": "CBC_PAD",
            "lastUpdateDate": "2020-03-16T20:41:27Z",
            "keyVersion": {
                "id": "30372f20-d9f1-40b3-b486-a709e1932c9c",
                "creationDate": "2020-03-12T03:37:32Z"
            },
            "dualAuthDelete": {
                "enabled": false
            },
            "deleted": false
        }
    ]
}