Creación de claves estándares en la consola

Después de crear una instancia del servicio, siga los siguientes pasos para crear una clave estándar en la consola de IBM Cloud.

Si despliega la oferta Dedicated Key Protect, primero debe inicializar su instancia antes de poder crear cualquier recurso.

Si activas la configuración de autorización dual para tu instancia de Key Protect, cualquier clave que añadas al servicio requerirá la autorización de dos usuarios para poder eliminarla.

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

2. En el menú de navegación, ve a «Lista de recursos» para ver una lista de tus recursos.

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

4. Para crear una nueva clave, haz clic en «Añadir» y selecciona la opción « Crear una clave ».

   1. Especifique los detalles de la clave:

   Configuración para crear una clave.

   Valor	Descripción
   Tipo	El Tipo de clave que desea gestionar en Key Protect. Las claves raíz se seleccionan de forma predeterminada. Seleccione el botón Clave estándar para crear una clave estándar.
   Nombre de clave	Un nombre de visualización legible por el usuario para facilitar la identificación de la clave. La longitud debe estar comprendida entre 2 y 90 caracteres (ambos incluidos). Para proteger su privacidad, asegúrese de que el nombre de clave no contiene información de identificación personal (PII), como el nombre o la ubicación. Tenga en cuenta que los nombres de clave no necesitan ser exclusivos.
   Alias de clave	Opcional. Los alias de clave son una forma de describir una clave que permite identificarlas y agruparlas más allá de los límites de un nombre de visualización. Las claves pueden tener hasta cinco alias.
   Conjunto de claves	Opcional. Los conjuntos de claves son agrupaciones de claves que permiten que esas agrupaciones se gestionen de forma independiente, según sea necesario. Cada tecla debe formar parte de un conjunto de claves. Si no se selecciona ningún conjunto de claves, las claves se colocan en el conjunto de claves default. Tenga en cuenta que para colocar la clave que está creando en un anillo de claves, debe tener el rol de Gestor sobre ese anillo de claves. Para obtener más información sobre los roles, consulte Gestión del acceso de usuario.

   2. Cuando haya terminado de cumplimentar los detalles de la clave, pulse Añadir clave para confirmar.

Si sabes qué llavero quieres utilizar y tienes el rol de «Administrador» para ese llavero, también puedes crear una clave directamente desde el panel « Llaveros ». Selecciona el menú de acciones (⋯) del llavero y haz clic en « Añadir nueva llave ». Esto abre el mismo panel que al hacer clic en «Añadir» en la página «Claves», con el campo «Llavero» ya rellenado con el nombre del llavero seleccionado.

Si necesita aprovisionar claves estándar 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.

Creación de claves estándar con la API

Si despliega la oferta Dedicated Key Protect, primero debe inicializar su instancia antes de poder crear cualquier recurso.

Cree una clave estándar 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 Key Protect API con el siguiente curl comando.

      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" \
       -H "x-kms-key-ring: <key_ring_ID" \
       -H "correlation-id: <correlation_ID>" \
       -H "prefer: <return_preference>" \
       -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>",
                       "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 creado ejecutando la llamada siguiente para obtener 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>"