Importation de clés racine à l'aide de la console

Après avoir créé une instance du service, procédez comme indiqué ci-après pour importer une clé à l'aide de la console IBM Cloud.

Si vous activez les paramètres d'autorisation double pour votre instance Key Protect, gardez à l'esprit que les clés que vous ajoutez au service requièrent une autorisation de deux utilisateurs pour pouvoir être supprimées.

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. Pour importer une clé, cliquez sur « Ajouter » et sélectionnez la fenêtre « Importer une clé ».

   Indiquez les détails relatifs à la clé :

Une fois que vous avez terminé de renseigner les informations relatives à la clé, cliquez sur « Ajouter » pour valider.

Si vous êtes responsable d'un trousseau de clés spécifique, vous pouvez ajouter une clé directement depuis le panneau « Trousseaux de clés ». Dans le menu contextuel du porte-clés (⋯), cliquez sur « Ajouter une nouvelle clé ». Le même panneau s'ouvre que lorsque vous cliquez sur « Ajouter » dans la page « **Clés ** », mais le champ « Trousseau » est déjà renseigné avec le nom du trousseau sélectionné.

Si vous avez besoin d'importer et de gérer les clés racine de manière cohérente entre les comptes ou les environnements, vous pouvez l'automatiser avec le module Key Protect Key. Pour une installation complète comprenant également l'instance Key Protect et les porte-clés, consultez le site Key Protect module. Pour une vue d'ensemble, voir Terraform IBM Modules.

Importation de clés racine à l'aide de l'API

Importez des clés symétriques dans Key Protect en soumettant un appel POST au noeud final ci-après.

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

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

2. Appelez l'APIKey Protect avec la commande curl suivante.

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.key+json" \
       -d '{
               "metadata": {
                   "collectionType": "application/vnd.ibm.kms.key+json",
                   "collectionTotal": 1
               },
               "resources": [
                   {
                       "type": "application/vnd.ibm.kms.key+json",
                       "name": "<key_name>",
                       "aliases": [alias_list],
                       "description": "<key_description>",
                       "expirationDate": "<expiration_date>",
                       "payload": "<key_material>",
                       "extractable": <key_type>
                   }
               ]
           }'
   

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

Pour protéger la confidentialité de vos données personnelles, évitez d'entrer des informations identifiant la personne, comme votre nom ou votre emplacement, lorsque vous ajoutez des clés au service.

Une réponse POST api/v2/keys qui aboutit renvoie la valeur de l'ID de la clé, ainsi que d'autres métadonnées. L'ID est un identificateur unique qui est affecté à la clé et qui est utilisé pour les appels adressés ultérieurement à Key Protect.

Facultatif : vérifiez que la clé a été ajoutée en exécutant l'appel suivant pour parcourir les clés dans votre instance Key Protect.

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