Supprimer des clés avec l'interface utilisateur

Par défaut, Hyper Protect Crypto Services requiert une autorisation pour supprimer une clé. Si vous préférez supprimer vos clés de cryptage à l'aide d'une interface graphique, vous pouvez utiliser l'interface utilisateur.

Après avoir créé ou importé vos clés existantes dans le service, procédez comme suit pour supprimer une clé :

1. Connectez-vous à l'interface utilisateur.
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 Hyper Protect Crypto Services mise à disposition.
4. Sur la page Clés KMS, utilisez la table Clés pour parcourir les clés de votre service.
5. Sélectionnez la clé à supprimer et cliquez sur l'icône Actions pour ouvrir une liste d'options pour la clé.
6. Dans le menu d'options, cliquez sur Supprimer une clé, entrez le nom de la clé pour confirmer la clé à supprimer et cliquez sur Supprimer une clé.

Après avoir supprimé une clé, celle-ci passe à l'état Détruit. Vous pouvez restaurer la clé supprimée dans les 30 jours suivant sa suppression. Les métadonnées associées à la clé, comme la date de suppression de la clé, sont conservées dans la base de données Hyper Protect Crypto Services.

Suppression de clés à l'aide de l'API

Par défaut, Hyper Protect Crypto Services requiert une autorisation pour supprimer une clé. Vous pouvez supprimer une clé et son contenu en créant une Appel DELETE vers le noeud final suivant.

https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/<key_ID>

Cette action ne peut pas aboutir si la clé protège activement une ou plusieurs ressources de cloud. Vous pouvez examiner les ressources associées à la clé ou utiliser le paramètre force lors de la phase d'interrogation pour supprimer la clé.

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

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

   Vous pouvez trouver l'ID d'une clé dans votre instance de service en récupérer une liste de vos clés, ou en accédant à l'interface utilisateur.

3. Exécutez la commande cURL suivante pour supprimer définitivement la clé et le contenu.

   curl -X DELETE \
     "https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/<key_ID>" \
     -H "authorization: Bearer <IAM_token>" \
     -H "bluemix-instance: <instance_ID>" \
     -H "x-kms-key-ring: <key_ring_ID>" \
     -H "prefer: <return_preference>"
   

   Remplacez les variables de l'exemple de demande conformément au tableau suivant :

   Tableau 1. Décrit les variables requises pour supprimer des clés à l'aide de l'API

   Variables	Description
   region	Obligatoire. L'abréviation de la région, telle que us-south ou au-syd, qui représente la zone géographique où se trouve votreHyper Protect Crypto Services l'instance réside. Pour plus d'informations, voir Noeuds finaux de service régional.
   port	Obligatoire. Numéro de port du noeud final d'API.
   key_ID	Obligatoire. Identificateur unique de la clé à supprimer.
   IAM_token	Obligatoire. Votre jeton d'accès IBM Cloud. Incluez l'ensemble du contenu du jeton IAM, y compris la valeur Bearer, dans la demande cURL. Pour plus d'informations, voir Extraction d'un jeton d'accès.
   instance_ID	Obligatoire. Identificateur unique affecté à votre instance Hyper Protect Crypto Services. Pour plus d'informations, voir Extraction d'un ID d'instance.
   key_ring_ID	Facultatif. Identificateur unique du fichier de clés auquel appartient la clé. S'il n'est pas spécifié, Hyper Protect Crypto Services recherche la clé dans chaque fichier de clés associé à l'instance spécifiée. Par conséquent, il est conseillé de spécifier l'ID du fichier de clés pour une demande plus optimisée. Remarque : l'ID du fichier de clés des clés créées sans en-tête x-kms-key-ring est default. Pour plus d'informations, voir Gestion des fichiers de clés.
   return_preference	Un en-tête qui modifie le comportement du serveur pour POST et DELETE opérations. Lorsque vous définissez le return_preference variable à return=minimal, le service renvoie une réponse de suppression réussie. Si cette variable a pour valeur return=representation, le service renvoie à la fois le matériel de clé et ses métadonnées.

   Si la variable return_preference a pour valeur return=representation, les détails de la demande DELETE sont renvoyés dans la section entity-body de la réponse.

   L'objet JSON suivant montre un exemple de valeur renvoyée.

   {
     "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": "test-root-key",
               "aliases": [
                   "alias-1",
                   "alias-2"
                 ],
               "state": 5,
               "extractable": false,
               "crn": "crn:v1:bluemix:public:hs-crypto:us-south:a/f047b55a3362ac06afad8a3f2f5586ea:12e8c9c2-a162-472d-b7d6-8b9a86b815a6:key:02fd6835-6001-4482-a892-13bd2085f75d",
               "imported": false,
               "creationDate": "2020-03-10T20:41:27Z",
               "createdBy": "...",
               "algorithmType": "AES",
               "algorithmMetadata": {
                   "bitLength": "256",
                   "mode": "CBC_PAD"
               },
               "algorithmBitSize": 256,
               "algorithmMode": "CBC_PAD",
               "lastUpdateDate": "2020-03-16T20:41:27Z",
               "dualAuthDelete": {
                   "enabled": false
               },
               "deleted": true,
               "deletionDate": "2020-03-16T21:46:53Z",
               "deletedBy": "..."
           }
       ]
   }
   

   Pour une description détaillée des paramètres disponibles, voir leHyper Protect Crypto ServicesDocument de référence sur l'API du service de gestion des clés.

https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/<key_ID>?force=true