Come faccio a sapere se una chiave può essere ripristinata?

Per verificare se un tasto distrutto può essere ripristinato:

1. Naviga nella tua istanza Key Protect nella console IBM Cloud.
2. Nella navigazione di sinistra, assicurati di essere sulla schermata Chiavi.
3. Individua la chiave che desideri ripristinare. Nota: è possibile ripristinare solo le chiavi che si trovano nello stato “Eliminato ”.
4. Sotto la colonna Last updated, nota la data. Poi fare riferimento alla Tabella 1, che può essere trovata sopra. Se la chiave è stata cancellata entro gli ultimi 30 giorni, può essere ripristinata. Se si è passati più di 30 giorni, non sarà possibile ripristinare la chiave. Se si tenta di ripristinare una chiave non più idonea per essere ripristinata, si riceverà un errore durante il tentativo di ripristinare la chiave.

Ripristino di una chiave cancellata con la console

Se preferisci ripristinare la chiave utilizzando un'interfaccia grafica, puoi utilizzare la console IBM Cloud.

Dopo aver importato le chiavi esistenti nel servizio e elimina un tasto, completare i seguenti passaggi per ripristinare 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. Fare clic su Chiavi per aprire il pannello delle chiavi e trovare la chiave nello stato distrutto che si desidera ripristinare. Un modo per farlo è aprire il pannello dei filtri e selezionare lo stato " Eliminato " dall'elenco a discesa " Stati chiave ". Questo limiterà i risultati a solo chiavi cancellate.

5. Fai clic sull'icona ⋯ per aprire l'elenco delle opzioni relative al tasto che desideri ripristinare. Si noti che se la chiave è stata eliminata e spostata in uno stato Distrutto, è necessario attendere 30 secondi prima di tentare di ripristinarla.

6. Fai clic sul pulsante "Ripristina " per aprire il pannello laterale di ripristino.

7. Fare clic sul pulsante " Ripristina ".

8. Confermare la chiave è stata ripristinata nella tabella Keys aggiornata.

Ripristino di una chiave cancellata con l'API

Per ripristinare una chiave importata in precedenza, effettuare una chiamata di tipo " POST " all'endpoint seguente:

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

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

   Per ripristinare un tasto è necessario avere il ruolo Gestore per l'istanza o la chiave. Per informazioni su come si mappano i ruoli IAM alle azioni del servizio Key Protect, consulta Ruoli di accesso al servizio.

2. Recupera l'ID della chiave che desideri ripristinare.

   È possibile recuperare l'ID di una chiave specifica effettuando una richiesta "list keys " oppure visualizzando le proprie chiavi nella dashboard di Key Protect. Per ulteriori informazioni, verificare Visualizzazione di un elenco di chiavi.

3. Eseguire il seguente comando curl per ripristinare la chiave e ritrovare l'accesso ai propri dati associati. Da notare che è necessario attendere 30 seconds minuti dopo aver eliminato una chiave prima di poterla ripristinare.

   Non è possibile ripristinare una chiave che abbia una data di scadenza che sia attuale o in passato.

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

   Sostituire le variabili nella richiesta di esempio in base alla Tabella 2.

A successful restore request returns an HTTP `201 Created` response, which indicates that the key was restored to the _Active_ key state and is now available for encrypt and decrypt operations. All attributes and policies that were previously associated with the key are also restored.

You will have access to data associated with the key as soon as the key is restored.
{: note}

$ 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>"

{
    "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": "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
        }
    ]
}