Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este inicio rápido, conectará el HSM externo a Managed HSM, creará una referencia de clave externa y probará la ruta de acceso de protección de claves. Después, use el URI de la clave de HSM administrado para configurar el cifrado en reposo con claves administradas por el cliente (CMK) en un servicio de Azure compatible.
Para el modelo de cifrado y la compatibilidad del servicio, consulte ¿Qué es la administración de claves externa de HSM administrado?
Si prefiere usar el portal de Azure, consulte Inicio rápido: Creación de la primera clave externa mediante el portal de Azure.
Prerequisites
Antes de comenzar, necesita lo siguiente:
- Un HSM administrado existente implementado en cualquier región pública Azure, en una suscripción habilitada para la administración de claves externas. Para crear un HSM administrado, consulte Inicio rápido: Aprovisionamiento y activación de un HSM administrado mediante CLI de Azure.
- Un proxy EKM operativo accesible desde Azure. El proxy debe implementar la especificación de la API de proxy de EKM. Para consultar los proveedores admitidos, consulte ¿Qué es la administración externa de claves de Managed HSM?.
- Clave creada en el HSM externo con un identificador de clave externa conocido. El identificador de clave externa es el identificador que usa el proxy para buscar la clave.
- El certificado de CA raíz (formato PEM) que firmó el certificado de servidor TLS de su proxy.
- CLI de Azure versión 2.x con la extensión más reciente
keyvaultinstalada. Ejecuteaz extension add --name keyvaultoaz extension update --name keyvaultpara obtener la versión más reciente. - Rol
Managed HSM EKM Administratorpara administrar conexiones de administración de claves externas y elManaged HSM Crypto Userrol para crear y usar claves. Para conocer los pasos de asignación de roles, consulte Control de acceso de HSM administrado.
Iniciar sesión en Azure
az login
Establezca la suscripción si tiene más de una:
az account set --subscription "<subscription-id>"
Mostrar el certificado de cliente de Managed HSM
El HSM administrado presenta un certificado de cliente X.509 a su proxy EKM en cada conexión TLS mutua (mTLS) entrante. Antes de crear la conexión con el sistema externo de gestión de claves, recupere el nombre común del sujeto del certificado y el certificado raíz de la entidad de certificación, y añádalos a la lista de permitidos de su proxy. Esto permite al proxy comprobar que la conexión proviene del HSM administrado, no de un autor de llamada arbitrario.
az keyvault ekm-connection certificate show --hsm-name <Managed HSM Name>
La salida tiene un aspecto similar al siguiente:
{
"caCertificates": [
"MIIDj...<truncated>...MrY="
],
"subjectCommonName": "contoso.managedhsmclient.azure.net"
}
Configure su proxy para que confíe en las conexiones que presenten un certificado con el subjectCommonName y cuya cadena de confianza termine en uno de los certificados de la lista caCertificates anterior. Los pasos exactos dependen del proveedor de proxy.
Note
Para conocer los pasos de rotación y los detalles del ciclo de vida de los certificados, consulte Configuración de redes y mTLS para la administración de claves externas de HSM administrado.
Crear la conexión externa de gestión de claves
La conexión de administración de claves externas vincula su HSM administrado a un único Proxy de EKM. Contiene la dirección del proxy, el ancla de confianza de la CA del servidor y un prefijo de ruta opcional.
En esta sección se crea una conexión a Internet pública. Para Private Link, siga Configurar el modelo de Azure Private Link (versión preliminar) en su lugar y, después, continúe con Comprobar la conexión.
az keyvault ekm-connection create \
--hsm-name <Managed HSM Name> \
--host <EKMProxy Host> \
--server-ca-certificate <Root cert> \
[--path-prefix <prefix>]
Referencia de parámetros:
-
--hsm-name: el nombre del HSM administrado. -
--host: El nombre de host plenamente cualificado de su EKM Proxy. Por ejemplo:proxy.contoso.com. El proxy debe escuchar en el puerto TCP 443; No se admite un puerto no estándar. -
--server-ca-certificate: especifica la ruta de acceso al archivo de certificado de entidad de certificación raíz (formato PEM o DER) que se usa para comprobar el certificado de servidor TLS del proxy. -
--path-prefix(opcional): Un prefijo de ruta URL si tu proxy multiplexa varios clientes o grupos por ruta. Por ejemplo:/contoso/prod.
Note
Transmita el certificado raíz de la CA a --server-ca-certificate, no el certificado final del proxy. El HSM administrado usa esta autoridad de certificación para validar toda la cadena de certificados presentada por su proxy durante el protocolo de enlace de mTLS. Si se pasa el certificado leaf, el protocolo de enlace generará un error en cualquier renovación de certificado.
Verifique la conexión
Después de crear la conexión, compruebe que el HSM administrado puede acceder a su proxy:
az keyvault ekm-connection check --hsm-name <Managed HSM Name>
Este comando invoca el punto de conexión /info del proxy a través de la conexión configurada. La salida correcta tiene un aspecto similar al siguiente:
{
"apiVersion": "1.0",
"ekmProduct": "Contoso HSM v1.0.0",
"ekmVendor": "Contoso HSM",
"proxyName": "Contoso Proxy Service",
"proxyVendor": "Contoso Proxy"
}
Entre las causas comunes de errores se incluyen reglas de firewall que bloquean el puerto proxy, un valor incorrecto --host o el proxy que rechaza el certificado de cliente HSM administrado. Para conocer los pasos de corrección, consulte Solución de problemas de administración de claves externas de HSM administrado.
Creación de la clave externa
Crea una referencia de clave de HSM administrado que apunte a la clave externa de tu HSM. HSM administrado no genera ningún material de clave. Este comando registra una referencia a una clave existente identificada por su identificador de clave externa.
az keyvault key create \
--external-key-id <external-key-identifier> \
--hsm-name <Managed HSM Name> \
--name <key-ref-name>
Referencia de parámetros:
-
--external-key-id: identificador de clave externa registrado en el proxy. Este es el identificador que usa el proxy para buscar la clave correcta en el HSM externo. -
--hsm-name: el nombre del HSM administrado. -
--name: el nombre que desea asignar a la referencia de clave HSM administrada. Esto pasa a formar parte del URI de la clave que usan los servicios de Azure.
Importante
El identificador de clave externa es inmutable durante la vigencia de una versión de clave. No se puede cambiar después de la creación. Para rotar la clave, cree una nueva versión de clave con un nuevo identificador de clave externa mediante az keyvault key create con el mismo --name. El URI de clave (URI de HSM + nombre de clave) permanece estable entre versiones; solo cambia el segmento de versión.
El comando devuelve el URI de clave con el formato https://<hsm-name>.managedhsm.azure.net/keys/<key-ref-name>/<version>. Mantenga este URI para configurar el servicio de Azure.
Verifica el proceso de envoltura/desenvoltura
Pruebe la ruta de protección de la clave con una operación de ida y vuelta de encapsulamiento y desencapsulamiento. El HSM externo realiza las operaciones a través del proxy y HSM administrado devuelve el resultado. Esta prueba confirma que la ruta de la clave funciona. No configura ni valida la integración de CMK del servicio Azure.
Note
Usa los puntos de conexión del plano de datos wrapkey y unwrapkey con az rest para esta prueba.
az keyvault key encrypt llama a una operación de API de clave diferente y no es un sustituto de encapsular una clave de cifrado de datos.
Cree un cuerpo de solicitud para la operación de envoltura. Establezca
valueen el material de clave codificado en base64url que desee envolver.{ "alg": "RSA-OAEP-256", "value": "<base64url-encoded-plaintext-key>" }Guárdelo como
wrapkey.json. Para las claves externas de AES, use"alg": "A256KW"en lugar deRSA-OAEP-256.Llama al punto de conexión
wrapkeyde tu referencia de clave:az rest --method POST \ --uri "https://<Managed HSM Name>.managedhsm.azure.net/keys/<key-ref-name>/wrapkey?api-version=7.5" \ --resource "https://managedhsm.azure.net" \ --headers "Content-Type=application/json" \ --body @wrapkey.jsonLa respuesta devuelve la versión de la clave (
kid) y un campovalueque contiene la clave encapsulada codificada en base64url. Copie elvaluepara el siguiente paso.Crea un cuerpo de solicitud para la operación de desempaquetado, utilizando el
valueempaquetado del paso anterior:{ "alg": "RSA-OAEP-256", "value": "<wrapped-value-from-previous-step>" }Guárdelo como
unwrapkey.json.Llama al punto de conexión
unwrapkeypara confirmar que el ciclo de ida y vuelta es correcto:az rest --method POST \ --uri "https://<Managed HSM Name>.managedhsm.azure.net/keys/<key-ref-name>/unwrapkey?api-version=7.5" \ --resource "https://managedhsm.azure.net" \ --headers "Content-Type=application/json" \ --body @unwrapkey.jsonUna respuesta satisfactoria devuelve el texto sin formato original
valueque incluyó en el primer paso. Si el desempaquetado genera un error, consulta Solución de problemas de la administración de claves externas de Managed HSM para conocer los códigos de error del proxy y los pasos de corrección.
Usar la clave con un servicio de Azure
Complete la integración de la carga de trabajo siguiendo la documentación de configuración de CMK del servicio Azure:
- Confirme que el servicio admite CMK con Managed HSM y que el tipo y el algoritmo de la clave externa cumplen sus requisitos.
- Conceda a la identidad usada por el servicio los permisos de RBAC local de Managed HSM necesarios. Para obtener instrucciones sobre la asignación de roles, consulte Control de acceso de HSM administrado.
- Configure la configuración de CMK del servicio con el URI de la clave de HSM administrado. Utilice el formato de URI con versiones o sin versiones requerido por ese servicio. Para Azure Storage, consulte Configurar claves administradas por el cliente con Azure Key Vault Managed HSM.
- Confirme que el servicio informa de la configuración de CMK esperada y, a continuación, realice una operación de lectura y escritura en la carga de trabajo protegida. Revise los diagnósticos del servicio y los registros de administración de claves externa de HSM administrado si la operación produce un error.
El servicio Azure usa su integración de HSM administrado existente. No necesita la API ni las credenciales específicas de tu HSM externo.
Visualización de registros de auditoría
Cada llamada al Proxy de EKM genera una entrada EkmProxyOperation en los registros de diagnóstico de Managed HSM. Para consultarlos en Log Analytics:
AzureDiagnostics
| where ResourceProvider == "MICROSOFT.KEYVAULT"
| where OperationName contains "Ekm"
| project TimeGenerated, Resource, OperationName, requestUri_s, ResultType, ResultDescription
El registro incluye el tipo de operación (encapsular o desencapsular), el identificador de clave externa, el código de estado HTTP devuelto por el proxy y la latencia de ida y vuelta. Para consultar la guía completa de registro y supervisión, incluida la configuración de alertas y la correlación de registros del lado del proxy, véase Registro y supervisión de la administración de claves externas de HSM administrado.
Limpieza de recursos
Si configuró un servicio de Azure para usar esta clave, migre la carga de trabajo a otra clave antes de eliminar la referencia o la conexión. Conserve la clave externa y su conexión durante el tiempo que los datos, las copias de seguridad o las instantáneas de la carga de trabajo lo requieran.
Para eliminar los recursos creados en esta guía de inicio rápido:
Elimine la referencia de clave de HSM administrado:
az keyvault key delete \ --hsm-name <Managed HSM Name> \ --name <key-ref-name>Elimine la conexión de administración de claves externas:
az keyvault ekm-connection delete \ --hsm-name <Managed HSM Name>
La eliminación de la referencia de clave de HSM administrado no afecta al material de clave de su HSM externo. Esa clave permanece en el HSM hasta que la quite allí.
Pasos siguientes
- Inicio rápido: Creación de la primera clave externa mediante el portal de Azure: complete el mismo flujo en el portal de Azure.
- Ciclo de vida de las claves externas en la administración de claves externa de HSM administrado: rotación de claves, control de versiones y retirada de claves externas.
- Configurar las redes y mTLS para la administración de claves externa de HSM administrado: conectividad de Internet pública, integración con Private Link (versión preliminar) y rotación de certificados.
- Registro y supervisión de la administración de claves externas de Managed HSM: reglas de alerta, consultas del lenguaje de consulta Kusto (KQL) y correlación de registros de proxy.
- Solucionar problemas con la administración de claves externa de HSM administrado: códigos de error, diagnósticos del proxy y pasos de corrección.