¿Cómo puedo saber si se puede restaurar una clave?

Para ver si se puede restaurar una clave destruida:

1. Vaya a la instancia de Key Protect en la consola IBM Cloud.
2. En el panel de navegación izquierdo, asegúrese de que está en la pantalla Claves.
3. Busque la clave que desea restaurar. Nota: solo se pueden restaurar las claves que se encuentren en estado « Eliminado ».
4. En la columna Last updated, fíjese en la fecha. A continuación, consulte la Tabla 1, que se puede encontrar más arriba. Si la clave se ha suprimido en los últimos 30 días, se puede restaurar. Si han transcurrido más de 30 días, no podrá restaurar la clave. Si intenta restaurar una clave que ya no es elegible para restaurarla, recibirá un error al intentar restaurar la clave.

Restauración de una clave suprimida con la consola

Si prefiere restaurar la clave utilizando una interfaz gráfica, puede utilizar la consola de IBM Cloud.

Después de importar las claves existentes en el servicio y suprimir una clave, complete los pasos siguientes para restaurar la clave:

1. Inicia sesión en la consola de IBM Cloud.

2. Vaya a Menú > Lista de recursos para ver una lista de sus recursos.

3. Desde la lista de recursos de IBM Cloud seleccione su instancia suministrada de Key Protect.

4. Pulse Claves para abrir el panel de claves y encontrar la clave en el estado destruido que desea restaurar. Una forma de hacerlo es abrir el panel de filtros y seleccionar el estado « Eliminado » en la lista desplegable « Estados clave ». Esto limitará los resultados sólo a las claves que se han suprimido.

5. Pulse el icono ... para abrir una lista de opciones para la clave que desea restaurar. Ten en cuenta que, si la clave se ha eliminado y ha pasado al estado «Destruida», debes esperar 30 segundos antes de intentar restaurarla.

6. Haz clic en el botón «Restaurar» para abrir el panel lateral de restauración.

7. Haz clic en el botón « Restaurar ».

8. Confirme que la clave se ha restaurado en la tabla claves actualizada.

Restauración de una clave suprimida con la API

Restaure una clave importada anteriormente haciendo una llamada POST al punto final siguiente:

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

1. Recupere sus credenciales de autenticación para trabajar con claves en el servicio.

   Para restaurar una clave, debe tener el rol Gestor para la instancia o clave. Para saber cómo se correlacionan los roles de IAM con las acciones de servicio de Key Protect, consulte los Roles de acceso al servicio.

2. Recupere el ID de la clave que desea restaurar.

   Puedes obtener el ID de una clave concreta realizando una solicitud «list keys » o consultando tus claves en el panel de control de Key Protect. Para obtener más información, consulte Visualización de una lista de claves.

3. Ejecute el siguiente mandato curl para restaurar la clave y recuperar el acceso a sus datos asociados. Tenga en cuenta que debe esperar 30 segundos después de suprimir una clave para poder restaurarla.

   No puede restaurar una clave que tenga una fecha de caducidad que sea actual o anterior.

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

   Sustituya las variables en la solicitud de ejemplo de acuerdo con la Tabla 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
        }
    ]
}