Creación de conjuntos de claves con la interfaz de usuario

Debe tener el rol de "Escritor" o "Gestor" del servicio para crear un conjunto de claves.

Para crear un conjunto de claves:

1. Pulse en Conjuntos de claves en la navegación de la izquierda.
2. En el panel Conjuntos de claves, pulse el botón Crear.
3. En la pestaña Crear un conjunto de claves, proporcione un nombre al conjunto de claves nuevo, siguiendo las instrucciones respecto a caracteres permitidos. A continuación, pulse Crear.

Después de que se haya creado, el nuevo conjunto de claves aparecerá en la lista de conjuntos de claves y podrá transferirle claves o crear claves para él.

Si gestiona los llaveros de forma coherente en varios entornos, puede automatizar la disposición de llaveros y llaves con Key Protect Módulo llavero o la más amplia Key Protect Módulo todo incluido. Consulte Acerca de los módulos de Terraform IBM para obtener más información.

Creación de conjuntos de claves con la API

Cree un conjunto de claves realizando una llamada POST al punto final siguiente.

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

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

2. Cree un conjunto de claves ejecutando el mandato curl siguiente.

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/key_rings/<key_ring_id>" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "correlation-id: <correlation_ID>"
   

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

Si la solicitud a POST api/v2/key_rings tiene éxito, se devuelve un HTTP 201 Created respuesta, lo que indica que se ha creado el llavero y que ya está disponible para almacenar claves estándar y de root.

Cómo asignar el acceso a un conjunto de claves

Puedes conceder acceso a un llavero dentro de una instancia de « Key Protect » mediante la consola de « IBM Cloud », la API de IAM o la CLI{ :external}.

Revise el tema roles y permisos para saber cómo se correlacionan los roles de IBM Cloud IAM con las acciones de Key Protect.

Para asignar acceso a un conjunto de claves con la consola:

1. En la barra de menús, pulse Gestionar > Acceso (IAM) y seleccione Usuarios para examinar los usuarios existentes en su cuenta.

2. Seleccione una fila de la tabla y pulse el icono ⋯ para abrir una lista de opciones para dicho usuario.

3. En el menú de opciones, pulse Asignar acceso.

4. Pulse Asignar acceso a usuarios adicionales.

5. Pulse el botón Servicios IAM.

6. En la lista de servicios, seleccione Key Protect.

7. Seleccione Servicios basados en atributos.

8. Seleccione el atributo ID de instancia y seleccione la instancia en la que reside el conjunto de claves.

9. Seleccione el atributo ID de conjunto de claves y especifique el ID asociado al conjunto de claves.

10. Elija una combinación de roles de plataforma y de acceso al servicio para asignar acceso para el usuario.

11. Pulse Añadir.

12. Continúe añadiendo roles de acceso al servicio y plataforma según sea necesario y, cuando haya terminado, pulse Asignar. Tenga en cuenta que al usuario se le debe asignar al menos acceso de Lector a toda la instancia para que pueda listar, crear y suprimir anillos de claves dentro de la instancia.

Listado de conjuntos de claves con la API

Para una vista de alto nivel, puede examinar los conjuntos de claves que se gestionan en la instancia suministrada de Key Protect realizando una llamada GET al punto final siguiente.

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

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

2. Para consultar las características generales de tus llaveros, ejecuta lo siguiente: mandato curl.

   $ curl -X GET \ "https://<region>.kms.cloud.ibm.com/api/v2/key_rings?totalCount=<show_total>&offset=<offset_value>&limit=<offset_limit>" \
       -H "accept: application/vnd.ibm.kms.key_ring+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "correlation-id: <correlation_ID>"
   

   Los parámetros de consulta que siguen al signo de interrogación ? son opcionales, pero se incluyen aquí para documentar su uso. (: :note)

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

Una solicitud GET api/v2/key_rings satisfactoria devuelve una colección de anillos de claves que están disponibles en la instancia del servicio Key Protect.

{
    "metadata": {
        "collectionType": "application/vnd.ibm.kms.key_ring+json",
        "collectionTotal": 2
    },
    "resources": [
        {
            "id": "default"
        },
        {
            "id": "Sample Key Ring 2",
            "creationDate": "2020-03-12T11:00:06Z",
            "createdBy": "..."
        }
    ]
}

Suprimir conjuntos de claves con la API

Puede suprimir un conjunto de claves realizando una llamada DELETE al punto final siguiente.

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

Esta acción no se llevará a cabo correctamente si el conjunto de claves contiene al menos una clave en un estado distinto del estado Destruido . Si las únicas claves del conjunto de claves están en el estado Destruido , el conjunto de claves se puede suprimir si se añade force=true al mandato delete. Las claves en ese estado se transfieren automáticamente al conjunto de claves default.

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

2. Recupere el ID del conjunto de claves que desea suprimir.

   Puede encontrar el ID de un anillo de claves en la instancia de Key Protect recuperando una lista de los anillos de claves.

3. Ejecute el siguiente mandato curl para suprimir el conjunto de claves. Tenga en cuenta la presencia de force=true, que fuerza la supresión del conjunto de claves en el caso de que contenga claves en el estado Destruido .

   $ curl -X DELETE \
       "https://<region>.kms.cloud.ibm.com/api/v2/key_rings/<key_ring_id>?force=true" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "prefer: <return_preference>"
   

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

Una solicitud satisfactoria devuelve una respuesta HTTP 204 No Content, que indica que el conjunto de claves se ha suprimido satisfactoriamente.