Habilitación y actualización de una política keyCreateImportAccess para su instancia de Key Protect con la consola

Si prefiere gestionar los valores de la política keyCreateImportAccess utilizando la interfaz gráfica de Key Protect, puede utilizar la consola de IBM Cloud.

Si se habilita "enforce_token", todas las acciones de importación de clave no estarán disponibles en la interfaz de usuario. La opción "enforce_token" hace que la Importación segura sea un requisito para todas las importaciones de clave. El soporte de importación segura sólo está disponible en la CLI o API de Key Protect.

Después de crear una instancia de Key Protect, complete los pasos siguientes para habilitar una política keyCreateImportAccess:

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. Haz clic en el enlace «Políticas» situado en la parte izquierda de la página.

   • Busque el panel Create and import access (en la parte superior de la página).

   • Habilite o inhabilite cualquier valor de keyCreateImportAccess que desee. Ten en cuenta que las acciones de creación o importación de claves que se hayan desactivado ya no estarán disponibles en el panel «Añadir clave».

   • Pulse Save o Cancel (lo que sea apropiado).

Habilitación y actualización de una política keyCreateImportAccess para la instancia de Key Protect con la API

Como administrador de seguridad, puede habilitar o actualizar una política keyCreateImportAccess para una instancia de Key Protect haciendo una PUT Realiza una llamada al siguiente punto final.

https://<region>.kms.cloud.ibm.com/api/v2/instance/policies?policy=keyCreateImportAccess

Si actualiza la política de IP permitidas de la instancia de Key Protect, recuerde que si se omite un atributo en la solicitud, el campo se establecerá en su valor predeterminado y el valor existente del campo omitido se sobrescribirá con el valor predeterminado.

1. Recupere sus credenciales de autenticación para trabajar con la API.

   Para habilitar las políticas keyCreateImportAccess, debe tener asignada una política de acceso de Gestor para su instancia de Key Protect instancia. Para saber cómo se correlacionan los roles de IAM con las acciones de servicio de Key Protect, consulte Roles de acceso al servicio.

2. Puede habilitar o actualizar una política keyCreateImportAccess para su instancia de Key Protect ejecutando el siguiente mandato curl.

   $ curl -X PUT \
       "https://<region>.kms.cloud.ibm.com/api/v2/instance/policies?policy=keyCreateImportAccess" \
       -H "accept: application/vnd.ibm.kms.policy+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.policy+json" \
       -d '{
               "metadata": {
                   "collectionType": "application/vnd.ibm.kms.policy+json",
                   "collectionTotal": 1
               },
               "resources": [
                   {
                       "policy_type": "keyCreateImportAccess",
                       "policy_data": {
                           "enabled": true,
                           "attributes": {
                               "create_root_key": <true/false>,
                               "create_standard_key": <true/false>,
                               "import_root_key": <true/false>,
                               "import_standard_key": <true/false>,
                               "enforce_token": <true/false>
                           }
                       }
                   }
               ]
           }'
   

   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 la instancia de Key Protect tiene ahora una política keyCreateImportAccess habilitada. La instancia de Key Protect ahora sólo permitirá la creación o importación de claves a partir de los métodos especificados en la solicitud.

Opcional: Verificar la habilitación de la política de acceso de importación y creación de claves

Puede verificar que se ha habilitado una política de acceso de creación e importación emitiendo una solicitud de listar políticas:

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/instance/policies?policy=keyCreateImportAccess" \
    -H "accept: application/vnd.ibm.kms.policy+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

Donde <instance_ID> es el nombre de la instancia y <IAM_token> es la señal IAM.

Inhabilitación de una política keyCreateImportAccess para la instancia de Key Protect

Como gestor de una instancia de Key Protect, puede inhabilitar una política keyCreateImportAccess existente para la instancia de Key Protect realizando una llamada PUT al punto final siguiente.

https://<region>.kms.cloud.ibm.com/api/v2/instance/policies?policy=keyCreateImportAccess

No proporcione ningún atributo al realizar una solicitud para inhabilitar la política keyCreateImportAccess.

1. Recupere sus credenciales de autenticación para trabajar con la API.

   Para inhabilitar las políticas keyCreateImportAccess, debe tener asignada una política de acceso de Gestor para la instancia de Key Protect instancia. Para saber cómo se correlacionan los roles de IAM con las acciones de servicio de Key Protect, consulte Roles de acceso al servicio.

2. Inhabilitar una política keyCreateImportAccess existente para su instancia de Key Protect ejecutando el siguiente mandato curl.

   $ curl -X PUT \
       "https://<region>.kms.cloud.ibm.com/api/v2/instance/policies?policy=keyCreateImportAccess" \
       -H "accept: application/vnd.ibm.kms.policy+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.policy+json" \
       -d '{
               "metadata": {
                   "collectionType": "application/vnd.ibm.kms.policy+json",
                   "collectionTotal": 1
               },
               "resources": [
                   {
                       "policy_type": "keyCreateImportAccess",
                       "policy_data": {
                           "enabled": false
                       }
                   }
               ]
           }'
   

   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 la política keyCreateImportAccess se ha actualizado para la instancia de servicio.

Opcional: Verificar la habilitación de la política de acceso de importación y creación de claves

Puede verificar que se ha inhabilitado una política de acceso de importación y creación de claves emitiendo una solicitud de listar políticas:

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/instance/policies?policy=keyCreateImportAccess" \
    -H "accept: application/vnd.ibm.kms.policy+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

Donde <instance_ID> es el nombre de la instancia y <IAM_token> es la señal IAM.