Creación de un adaptador

Se puede crear un máximo de 200 adaptadores en una única instancia. Cada adaptador puede tener asociados un máximo de 200 certificados.

Los adaptadores KMIP se crean utilizando Key Protect claves raíz. Si no tienes una clave raíz, crea una.

Antes de empezar, asegúrate de que dispones del rol « Manager » o del rol « KmipAdapterManager » en la instancia.

Para crear un adaptador:

1. En el menú de navegación, haz clic en « Adaptadores KMIP ». Si este es tu primer adaptador, la tabla está vacía.

2. Pulse Crear.

3. En el panel lateral, indique la siguiente información:

   • Nombre: introduce un nombre para el adaptador (de 2 a 40 caracteres).
   • Descripción (opcional): introduce una descripción para el adaptador (entre 2 y 240 caracteres).
   • Clave raíz: selecciona la clave raíz que se va a utilizar para este adaptador. La clave raíz cifra las claves KMIP que crea el adaptador. Tu clave raíz debe estar en estado « active » para que tu adaptador funcione correctamente.

4. Opcional: Añade un certificado público de TLS para permitir que el titular del certificado privado correspondiente se comunique con Key Protect a través del adaptador KMIP. Solo los certificados autorizados pueden realizar solicitudes mediante el protocolo KMIP a tu instancia.

   Para añadir un certificado:

   1. Pulse Añadir.
   2. Introduce un nombre para el certificado.
   3. Introduce el contenido del certificado en formato « PEM », incluyendo las etiquetas « BEGIN CERTIFICATE » y « END CERTIFICATE ».
   4. Haz clic en « Añadir certificado ».

   La asociación de certificados puede tardar unos minutos. Un certificado solo puede asociarse a un único adaptador en una región de Key Protect.

No se puede acceder a los recursos gestionados mediante el protocolo KMIP a través de la API HTTP.

Mantén a buen recaudo la clave privada de cualquier certificado que subas. Cualquier certificado que se cargue en un adaptador KMIP puede realizar todas las operaciones KMIP compatibles.

Ver y actualizar los datos del adaptador

El panel de detalles del adaptador muestra información sobre un adaptador y te permite realizar acciones como añadir certificados.

Para ver los detalles del adaptador:

1. Haz clic en el menú de acciones (⋯) del adaptador.
2. Selecciona « Detalles ».

El panel de detalles muestra el nombre del adaptador, la descripción, las claves simétricas KMIP asociadas y los certificados cargados. También puedes subir certificados adicionales desde este panel.

Las claves simétricas KMIP no se pueden eliminar mediante la consola. Para eliminar claves, utiliza la CLI. Solo se pueden eliminar las claves simétricas KMIP que no se encuentren en el estado « Active » (estado 1). No se puede eliminar un adaptador si contiene claves en estado « Active ».

Los recursos de cada adaptador están protegidos con una clave raíz. No se puede eliminar una clave raíz que esté activa y asociada a un adaptador.

Cada clave simétrica KMIP que se crea cuenta como una única versión de clave y conlleva un cargo de una versión de clave. La eliminación de una clave simétrica KMIP es definitiva.

Creación y uso de adaptadores KMIP en la API

En esta sección se describe cómo utilizar los adaptadores KMIP del perfil native_1.0 con la API, lo que incluye añadir y eliminar certificados de cliente KMIP, así como consultar y eliminar objetos KMIP.

Puedes crear un adaptador KMIP realizando una llamada « POST » al siguiente punto final.

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

Las operaciones sobre los subrecursos del adaptador KMIP, incluidos los certificados de cliente KMIP y los objetos KMIP, se realizarán en los siguientes endpoints:

https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters/<adapter_name_or_ID>/certificates
https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters/<adapter_name_or_ID>/kmip_objects

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

2. Copie el ID de la clave raíz que desea utilizar para crear su adaptador KMIP.

   Puede encontrar el ID de una clave en la instancia de Key Protect recuperando una lista de sus claves o accediendo al panel de control de Key Protect salpicadero.

3. Cree un adaptador KMIP con el siguiente comando curl:

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters" \
       -H "accept: application/vnd.ibm.kms.kmip_adapter+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.kmip_adapter+json" \
       -d '{
               "metadata": {
                   "collectionType": "application/vnd.ibm.kms.kmip_adapter+json",
                   "collectionTotal": 1
               },
               "resources": [
                   {
                   "name": "<adapter_name>",
                   "description": "<adapter_description>",
                   "profile": "native_1.0",
                   "profile_data": {
                       "crk_id": "<root_keyID_or_alias>"
                   }
                   }
               ]
           }'
   

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

4. Opcional: puede listar los adaptadores KMIP que existen en una instancia con el siguiente comando curl:

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

   También puede obtener un adaptador KMIP específico mediante el siguiente comando curl:

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

   Tenga en cuenta que puede utilizar el UUID del adaptador o el nombre del adaptador para obtener un adaptador específico.

5. Puede eliminar un adaptador KMIP con el siguiente comando curl:

   $ curl -X DELETE \
       "https://<region>.kms.cloud.ibm.com/api/v2/kmip_adapters/<adapter_name_or_ID>" \
       -H "accept: application/vnd.ibm.kms.kmip_adapter+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.kmip_adapter+json"
   

   Sólo se puede eliminar el adaptador KMIP si se eliminan todos los objetos KMIP bajo el adaptador.