Comment savoir si une clé peut être restaurée ?

Pour voir si une clé détruite peut être restaurée, procédez comme suit :

1. Accédez à votre instance Key Protect dans la console IBM Cloud.
2. Dans la zone de navigation de gauche, vérifiez que vous êtes sur l'écran Clés.
3. Recherchez la clé que vous souhaitez restaurer. Remarque : seules les clés dont l'état est « Supprimé » peuvent être restaurées.
4. Dans la colonne Last updated, notez la date. Reportez-vous ensuite au tableau 1, qui se trouve ci-dessus. Si la clé a été supprimée au cours des 30 derniers jours, elle peut être restaurée. Si elle l'a été il y a plus de 30 jours, vous ne pourrez pas la restaurer. Si vous tentez de restaurer une clé qui ne peut plus être restaurée, vous recevez une erreur lors de la tentative de restauration.

Restauration d'une clé supprimée à l'aide de la console

Si vous préférez restaurer votre clé à l'aide d'une interface graphique, vous pouvez utiliser la console IBM Cloud.

Après avoir importé vos clés existantes dans le service et supprimé une clé, procédez comme suit pour restaurer la clé :

1. Connectez-vous à la console IBM Cloud.

2. Accédez à Menu > Liste de ressources pour afficher la liste de vos ressources.

3. Dans la liste de ressources IBM Cloud, sélectionnez votre instance Key Protect mise à disposition.

4. Cliquez sur Clés pour ouvrir le panneau des clés et trouver la clé à l'état détruit que vous souhaitez restaurer. Pour ce faire, vous pouvez notamment ouvrir le panneau de filtrage et sélectionner l'état « Supprimé » dans la liste déroulante « États clés ». Cela limitera les résultats aux seules clés qui ont été supprimées.

5. Cliquez sur l'icône ... pour ouvrir une liste d'options pour la clé que vous souhaitez restaurer. Notez que si la clé a été supprimée et est passée à l'état « Destroyed », vous devez attendre 30 secondes avant de tenter de la restaurer.

6. Cliquez sur le bouton « Restaurer » pour ouvrir le panneau latéral de restauration.

7. Cliquez sur le bouton « Restaurer ».

8. Vérifiez que la clé a été restaurée dans le tableau Clés mis à jour.

Restauration d'une clé supprimée à l'aide de l'API

Restaurez une clé importée précédemment en effectuant un appel POST au nœud final suivant :

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

1. Extrayez vos données d'authentification afin d'utiliser les clés dans le service.

   Pour restaurer une clé, vous devez avoir le rôle Gestionnaire pour l'instance ou la clé. Pour savoir comment les rôles IAM sont mappés aux actions du service Key Protect, consultez la rubrique Rôles d'accès au service.

2. Extrayez l'ID de la clé à restaurer.

   Vous pouvez récupérer l'identifiant d'une clé spécifique en effectuant une requête « list keys », ou en consultant vos clés dans le tableau de bord « Key Protect ». Pour plus d'informations, voir Affichage d'une liste de clés.

3. Exécutez la commande curl suivante pour restaurer la clé et récupérer l'accès aux données associées. Notez que vous devez attendre 30 secondes après avoir supprimé une clé avant de pouvoir la restaurer.

   Vous ne pouvez pas restaurer une clé dont la date d'expiration est la date du jour ou une date passée.

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

   Remplacez les variables dans l'exemple de demande selon le tableau 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
        }
    ]
}