1. Crear cajas fuertes

Una caja fuerte es un único repositorio que controla el acceso de un usuario o un grupo de acceso a las claves y almacenes de claves gestionados a través de Cloud Identity and Access Management (IAM).

Complete los pasos siguientes para crear la primera caja fuerte:

1. Desde la interfaz de usuario de la instancia de servicio, pulse Cajas fuertes desde la navegación para ver todas las cajas fuertes disponibles.
2. Pulse Crear caja fuerte.
3. Especifique un nombre en Nombre de caja fuerte. El nombre de la caja fuerte puede tener de 1 a 100 caracteres. Opcionalmente, puede añadir una descripción ampliada a la caja fuerte en la sección Descripción.
4. Pulse Crear caja fuerte para confirmar.

2. Crear almacenes de claves

Un almacén de claves es un repositorio que almacena las claves criptográficas. Puede crear un almacén de claves interno dentro de la instancia de servicio o conectarse a un almacén de claves externo en otra instancia de servicio o incluso en otro proveedor de nube, como por ejemplo Microsoft Azure Key Vault, Amazon Web Services (AWS) Key Management Service (KMS) y Google Cloud KMS.

Realice los pasos siguientes para crear el primer almacén de claves interno:

1. En la interfaz de usuario de la instancia de servicio, pulse Almacenes de claves en la navegación para ver todos los almacenes de claves disponibles.
2. Pulse Añadir almacén de claves.
3. En Caja fuerte, seleccione la caja fuerte que crea y pulse Siguiente. Si desea asignar el almacén de claves a una nueva caja fuerte, pulse Crear caja fuerte.
4. En Tipo de almacén de claves, seleccione IBM Cloud KMS y pulse Siguiente.
5. En Propiedades de almacén de claves, especifique un nombre en Nombre del almacén. El nombre del almacén de claves puede tener de 1 a 100 caracteres. A continuación, pulse Siguiente.
6. En Resumen, puede ver el resumen del almacén de claves que crea, incluido el tipo de almacén de claves, la caja fuerte asignada y las propiedades generales.
7. Después de confirmar los detalles del almacén de claves, pulse Crear almacén de claves para crear el almacén de claves.

3. Crear plantillas clave

plantilla de clave especifica las propiedades de las claves gestionadas que se van a crear, como el convenio de denominación, el algoritmo de clave y la longitud de clave.

Realice los pasos siguientes para crear la primera plantilla de clave:

1. En la interfaz de usuario de la instancia de servicio, pulse Plantillas clave en la navegación.
2. Pulse Crear plantilla de clave.
3. En Caja fuerte, seleccione la caja fuerte que acaba de crear y, a continuación, pulse Siguiente.
4. En Almacenes de claves, seleccione IBM Cloud KMS como tipo de almacén de claves, seleccione el almacén de claves que acaba de crear y, a continuación, pulse Siguiente.
5. En Propiedades de plantilla clave, especifique los detalles siguientes de la plantilla clave. Pulse Siguiente para continuar.
6. En Resumen, visualice el resumen de la plantilla de clave y, a continuación, pulse Crear plantilla de clave para completar la creación de la plantilla de clave.

4. Crear claves gestionadas

Puede utilizar una clave gestionada para el cifrado o descifrado sólo después de que se haya creado y activado en al menos un almacén de claves. Realice los pasos siguientes para crear la primera clave KMS de IBM Cloud y activar la clave en el almacén de claves que cree:

1. Desde la interfaz de usuario de la instancia de servicio, pulse Claves gestionadas desde la navegación para ver todas las claves disponibles.
2. Pulse Crear clave.
3. En Caja fuerte, seleccione la caja fuerte que acaba de crear y, a continuación, pulse Siguiente.
4. En Plantilla de clave, seleccione Crear a partir de una plantilla de clave y, a continuación, seleccione la plantilla de clave que acaba de crear y pulse Siguiente.
5. En Propiedades clave, especifique los detalles de la clave. Pulse Siguiente para continuar cuando haya terminado. Tenga en cuenta que las claves Pre-active no se instalarán en los almacenes de claves hasta que las active manualmente. Las claves de Active se instalarán automáticamente en los almacenes de claves. Para obtener más información sobre las propiedades clave, consulte Creación de claves gestionadas con una plantilla de clave en la interfaz de usuario de IBM Cloud.
6. En Resumen, visualice el resumen de la clave y, a continuación, pulse Crear clave para crear la clave.

Realización de operaciones criptográficas con la API de PKCS #11

Para realizar operaciones criptográficas con la API de PKCS #11, siga estos pasos:

1. Configure los ID de servicio, roles y acciones de PKCS #11 . Para obtener más información, consulte Configuración de tipos de usuario de API PKCS #11.
2. Descargue, instale y configure la biblioteca de cliente PKCS #11 . Para obtener más información sobre cómo configurar la biblioteca de cliente PKCS #11 , consulte Realización de operaciones criptográficas con la API de PKCS #11.

Realización de operaciones criptográficas con la API de GREP11

Para realizar operaciones criptográficas con la API GREP11, debe asegurarse de que las aplicaciones se han desarrollado con lenguajes de programación soportados por gRPC.

El procedimiento siguiente utiliza el código Golang como ejemplo para probar las funciones de GREP11.

1. Instale Golang siguiendo la instrucción.

2. Clone el repositorio GitHub de ejemplo de para Golang en un directorio local de su elección. Los módulos Go se utilizan para este repositorio, por lo que no es necesario que coloque el repositorio clonado en GOPATH. Consulte el archivo README del repositorio para obtener más información sobre los ejemplos de código Go de GREP11.

3. Actualice el fragmento de código siguiente en el archivo examples/server_test.go.

   var (
       Address        = "<instance_ID>.ep11.us-east.hs-crypto.appdomain.cloud"
       APIKey         = "<ibm_cloud_apikey>"
   )
   

   En el ejemplo de código,

   • Sustituya <instance_ID> por el valor del punto final de API GREP11. Para encontrar el URL de punto final de servicio, en la interfaz de usuario de la instancia de servicio suministrada, pulse Visión general > Conectar > URL de punto final Enterprise PKCS #11.
   • Sustituya <ibm_cloud_apikey> por la clave de API de ID de servicio que ha creado.

4. En el directorio <your_repository_path>/hpcs-grep11-go/examples, ejecute los ejemplos ejecutando el mandato go test -v -run Example.