Importación de claves raíz con la consola

Después de crear una instancia del servicio, siga los siguientes pasos para importar una clave con la consola de IBM Cloud.

Si habilita los valores de autorización dual para la instancia de Key Protect, tenga en cuenta que cualquier clave que añada al servicio necesita una autorización de dos usuarios para suprimir claves.

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. Para importar una clave, haz clic en « Añadir » y selecciona la ventana « Importar clave ».

   Especifique los detalles de la clave:

Cuando hayas terminado de rellenar los datos de la clave, haz clic en «Añadir» para confirmar.

Si eres el administrador de un llavero concreto, puedes añadir una clave directamente desde el panel « Llaveros ». En el menú de acciones del llavero (⋯), haz clic en « Añadir nueva clave ». Se abre el mismo panel que cuando haces clic en «Añadir» en la página «Claves», pero el campo «Llavero» ya aparece rellenado con el nombre del llavero seleccionado.

Si necesita importar y gestionar claves raíz de forma coherente en todas las cuentas o entornos, puede automatizarlo con el módulo Key Protect Key. Si desea una configuración completa que incluya la instancia Key Protect y los llaveros, consulte el módulo Key Protect con todo incluido. Para obtener una visión general, consulte Terraform IBM Modules.

Importación de claves raíz con la API

Puede importar claves simétricas a Key Protect realizando una llamada POST al siguiente punto final.

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

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

2. Llame a la APIKey Protect con el siguiente mandato curl.

   $ 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>
                   }
               ]
           }'
   

   Sustituya las variables de la solicitud de ejemplo de acuerdo con la siguiente tabla.

Para proteger la confidencialidad de sus datos personales, evite especificar información de identificación personal (PII), como el nombre o la ubicación, cuando añades claves al servicio.

Una respuesta POST api/v2/keys satisfactoria devuelve el valor del ID para la clave, junto con otros metadatos. El ID es un identificador exclusivo que se asigna a su clave y que posteriores llamadas lo utilizan para la API de Key Protect.

Opcional: Verifique que la clave se ha añadido ejecutando la llamada siguiente para examinar las claves en la instancia de servicio 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>"