Tutorial: Configuración y consulta de registros de auditoría de operaciones de HSM para Azure Cloud HSM

Azure Cloud HSM admite el registro de operaciones de HSM a través de la configuración de diagnóstico de Azure Monitor. La categoría de registro HsmOperations contiene registros a prueba de manipulaciones generados por el firmware del HSM para las operaciones de administración realizadas en las particiones del HSM. Envíe estos registros tanto a una cuenta de almacenamiento como a un área de trabajo de Log Analytics para la recopilación, el análisis, la supervisión y la retención centralizados.

El registro de operaciones de HSM es la estrategia de registro recomendada para la seguridad y el cumplimiento. Registra operaciones de administración como inicios de sesión, administración de usuarios, creación y eliminación de claves, importación y exportación de claves, y copia de seguridad y restauración. Los registros se recuperan de cada partición de HSM en lotes y el HSM firma cada lote mediante la clave del certificado de la partición. Todos los registros de un lote comparten el mismo CorrelationId. Los registros exportados también incluyen la firma correspondiente para el lote firmado y los certificados públicos de HSM, que se pueden usar para comprobar la integridad y la autenticidad de la pista de auditoría.

Azure Cloud HSM también proporciona la HsmServiceOperations categoría de registro de eventos. Estos registros de operaciones de servicio describen las solicitudes observadas por el servicio HSM en la nube y pueden complementar los registros de operaciones de HSM para solucionar problemas. Puede habilitar ambas categorías en la misma configuración de diagnóstico, pero use HsmOperations como origen principal para auditar las operaciones registradas por el HSM.

En este tutorial, usted hará lo siguiente:

  • Configure y establezca los registros de operaciones de HSM, incluida la creación de una cuenta de almacenamiento y un área de trabajo de Log Analytics.
  • Opcionalmente, habilite los registros de operaciones de servicio junto con los registros de operaciones de HSM.
  • Consulte los registros de operaciones de HSM para recuperar operaciones de administración específicas.
  • Obtenga una lista completa de los comandos de administración registrados por los registros de operaciones de HSM.

Importante

La configuración de diagnóstico controla dónde se exportan los registros.

Restrinja el acceso a la cuenta de almacenamiento de destino y al área de trabajo de Log Analytics. Los registros de operaciones de HSM pueden incluir identificadores operativos, como identificadores de usuario, identificadores de sesión, identificadores de clave y detalles específicos de la operación.

Prerequisites

  • Una cuenta de Azure con una suscripción activa. Puede crear una cuenta gratuitamente.
  • Un recurso de Azure Cloud HSM que se ha implementado correctamente. Para obtener información, consulte la guía de incorporación de Azure Cloud HSM.

Configurar los registros de operaciones del HSM

Use los comandos de las secciones siguientes para configurar los recursos que desea supervisar.

Crear una cuenta de almacenamiento para almacenar registros de operaciones de HSM

Para conservar los registros de operaciones de HSM en una cuenta de almacenamiento, cree primero un grupo de recursos y, a continuación, cree la cuenta de almacenamiento en ese grupo de recursos.

az group create --name "<resource-group>" --location "<location>"

az storage account create \
  --name "<storage-account-name>" \
  --resource-group "<resource-group>" \
  --location "<location>" \
  --sku Standard_LRS \
  --kind StorageV2

Creación de un área de trabajo de Log Analytics

Para crear un área de trabajo de Log Analytics para almacenar y analizar registros de operaciones de HSM, use el siguiente comando.

az monitor log-analytics workspace create \
  --resource-group "<resource-group>" \
  --workspace-name "<workspace-name>" \
  --location "<location>" \
  --retention-time "<NumOfDays>"

Note

El tiempo de retención del área de trabajo de Log Analytics admitida debe ser de al menos 30 días.

Para más información sobre cómo crear un área de trabajo de Log Analytics para Azure Monitor, consulte Creación de un área de trabajo de Log Analytics.

Habilitación de la configuración de diagnóstico

Para exportar registros de operaciones de Azure Cloud HSM, cree una configuración de diagnóstico con la categoría HsmOperations habilitada. En los ejemplos siguientes se envían registros a una cuenta de almacenamiento y a un área de trabajo de Log Analytics.

resourceId="/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.HardwareSecurityModules/cloudHsmClusters/<hsm-name>"

storageAccountId="/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account-name>"

workspaceId="/subscriptions/<subscription-id>/resourcegroups/<resource-group>/providers/microsoft.operationalinsights/workspaces/<workspace-name>"

az monitor diagnostic-settings create \
  --resource $resourceId \
  --name "my-chsmAuditLogs" \
  --storage-account $storageAccountId \
  --workspace $workspaceId \
  --export-to-resource-specific true \
  --logs '[{"category":"HsmOperations","enabled":true}]'

Para recopilar también registros de operaciones de servicio para solucionar problemas, habilite HsmServiceOperations junto con HsmOperations.

az monitor diagnostic-settings create \
  --resource $resourceId \
  --name "my-chsmAuditLogs" \
  --storage-account $storageAccountId \
  --workspace $workspaceId \
  --export-to-resource-specific true \
  --logs '[{"category":"HsmOperations","enabled":true},{"category":"HsmServiceOperations","enabled":true}]'

Comprobación de la configuración de diagnóstico

Enumere la configuración de diagnóstico del recurso HSM en la nube y confirme que la configuración incluye la cuenta de almacenamiento, área de trabajo de Log Analytics, tipo de destino Dedicated y categoría HsmOperations habilitada. Si ha habilitado los registros de operaciones de servicio, confirme también que HsmServiceOperations está habilitado.

resourceId="/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.HardwareSecurityModules/cloudHsmClusters/<hsm-name>"

az monitor diagnostic-settings list \
  --resource $resourceId \
  --output json

Verificar la configuración del registro de operaciones de Cloud HSM

Después de crear la configuración de diagnóstico y realizar una operación de administración admitida, deje tiempo para que el HSM publique el lote de auditoría firmado y para que Azure Monitor lo ingiera.

Note

Después de crear una configuración de diagnóstico, los registros suelen aparecer en Log Analytics en cuestión de minutos. La ingesta de registros de recursos de Azure puede tardar aproximadamente 20 minutos en condiciones normales y la activación inicial de una nueva configuración de diagnóstico puede tardar ocasionalmente hasta 90 minutos. La configuración de diagnóstico no rellena los registros generados antes de que se creara la configuración.

Puede consultar los registros de operaciones de Cloud HSM desde el portal de Azure a través del área de trabajo de Log Analytics. Los registros de operaciones de HSM se almacenan en la CloudHsmHardwareOperationAuditLogs tabla. Si también ha habilitado HsmServiceOperations, esos registros se almacenan por separado en la CloudHsmServiceOperationAuditLogs tabla.

También puede consultar los registros de eventos de la operación HSM en la nube mediante el CLI de Azure o Azure PowerShell.

workspaceCustomerId=$(az monitor log-analytics workspace show \
  --resource-group "<resource-group>" \
  --workspace-name "<workspace-name>" \
  --query customerId --output tsv)

az monitor log-analytics query \
  --workspace $workspaceCustomerId \
  --analytics-query 'CloudHsmHardwareOperationAuditLogs'

Error de registro

Si recibe el mensaje de error "<subscription> no está registrado para usar microsoft.insights", la suscripción de Azure no está registrada para usar el Microsoft.Insights proveedor de recursos. Para resolver este problema, registre el proveedor Microsoft.Insights en su suscripción.

az provider register --namespace Microsoft.Insights

az provider show --namespace Microsoft.Insights --query "registrationState" --output table

Después de ejecutar el comando, asegúrese de que el proveedor de recursos está registrado. Si aún se está registrando, es posible que tenga que esperar unos instantes y volver a comprobarlo.

Consulta de registros de operaciones de HSM

Ejecute las siguientes consultas en el editor de Log Analytics Logs en el portal de Azure. Para ejecutarlos desde la línea de comandos, reemplace el texto de consulta del parámetro --analytics-query de la CLI de Azure o del parámetro -Query de Azure PowerShell que se muestra en los ejemplos de verificación anteriores.

Utilice las siguientes consultas para recuperar las operaciones de administración de HSM de CloudHsmHardwareOperationAuditLogs. Para enumerar todos los registros de operaciones de administración, ejecute:

CloudHsmHardwareOperationAuditLogs
| where OperationName startswith "CN_"

La tabla también puede contener registros de certificados y de lotes firmados cuyos nombres de operación comiencen por BATCH_. Para obtener más información sobre los registros por lotes y las operaciones de administración que pueden aparecer, consulte el glosario de operaciones.

Eventos de inicio de sesión y eventos de conexión

// Find login and session events.
CloudHsmHardwareOperationAuditLogs
| where OperationName in (
    "CN_LOGIN",
    "CN_LOGOUT",
    "CN_CLOSE_SESSION",
    "CN_CLOSE_ALL_SESSIONS",
    "CN_CLOSE_PARTITION_SESSIONS"
)
| project TimeGenerated, OperationName, ResultType, UserID, SessionHandle, HsmInstance, SequenceNumber

Eventos para crear y eliminar usuarios

// Find user creation and deletion events.
CloudHsmHardwareOperationAuditLogs
| where OperationName in (
    "CN_CREATE_USER",
    "CN_CREATE_CO",
    "CN_CREATE_APPLIANCE_USER",
    "CN_CREATE_PRE_OFFICER",
    "CN_DELETE_USER"
)
| project TimeGenerated, OperationName, ResultType, UserID, HsmInstance, SequenceNumber, AdditionalInfo

Eventos para la creación de claves

// Find key creation events.
CloudHsmHardwareOperationAuditLogs
| where OperationName in (
    "CN_GENERATE_KEY",
    "CN_GENERATE_KEY_PAIR",
    "CN_GENERATE_PBE_KEY",
    "CN_GEN_KEY_ENC_KEY",
    "CN_GEN_PSWD_ENC_KEY",
    "CN_DERIVE_KEY"
)
| project TimeGenerated, OperationName, ResultType, UserID, HsmInstance, SequenceNumber, AdditionalInfo

Eventos para la eliminación de claves

// Find key deletion events.
CloudHsmHardwareOperationAuditLogs
| where OperationName in (
    "CN_DESTROY_OBJECT",
    "CN_TOMBSTONE_OBJECT",
    "CN_DELETE_TOMBSTONED_OBJECT"
)
| project TimeGenerated, OperationName, ResultType, UserID, HsmInstance, SequenceNumber, AdditionalInfo

Glosario de operaciones

El registro de operaciones de HSM registra los siguientes registros por lotes y comandos de administración de HSM. Las consultas y operaciones de solo lectura que no aparecen aquí no se capturan en HsmOperations.

Administración de sesiones

Nombre de la operación Description
CN_LOGIN Inicia la sesión de un usuario en una partición.
CN_LOGOUT Cierra la sesión de un usuario de una partición.
CN_CLOSE_SESSION Cierra una sesión específica.
CN_CLOSE_ALL_SESSIONS Cierra todas las sesiones en una partición.
CN_APP_FINALIZE Finaliza una sesión de aplicación, como PKCS#11 C_Finalize.
CN_CLOSE_PARTITION_SESSIONS Cierra todas las sesiones de una partición específica.
CN_ENCRYPT_SESSION Establece una sesión cifrada.

Ciclo de vida de la partición

Nombre de la operación Description
CN_INIT_TOKEN Inicializa o da formato a una partición.
CN_INIT_DONE Marca la inicialización de la partición como completada.
CN_ZEROIZE Sobrescribe una partición con ceros.
CN_VENDOR_ZEROIZE Realiza una operación de puesta a cero específica del proveedor.
CN_SET_NODEID Establece el identificador del nodo de partición.
CN_SET_M_VALUE Establece el valor M para el cuórum M de N.
CN_SET_POLICY Establece una directiva de partición.
CN_SET_HSM_CONFIG Establece la configuración del hardware del HSM.
CN_SET_KBK_PRIMARY Establece la Key Block Key (KBK) principal.
CN_PARTN_STORAGE_UPDATE Actualiza el almacenamiento persistente de la partición.
CN_PARTN_STORAGE_DELETE Elimina un registro de almacenamiento persistente de una partición.

Administración de usuarios

Nombre de la operación Description
CN_CREATE_USER Crea un usuario criptográfico (CU).
CN_CREATE_CO Crea un Crypto Officer (CO).
CN_CREATE_APPLIANCE_USER Crea un usuario de dispositivo o servicio.
CN_CREATE_PRE_OFFICER Crea un oficial previo.
CN_CHANGE_PSWD Cambia la contraseña o el PIN de un usuario.
CN_RENAME_PCO Cambia el nombre de un oficial previo.
CN_DELETE_USER Elimina un usuario.
CN_UNLOCK_CO Desbloquea un Crypto Officer bloqueado.
CN_GET_CHALLENGE_CO Obtiene un reto para el desbloqueo del Crypto Officer.
CN_SET_USER_ATTR Establece atributos de usuario.
CN_UNLOCK_USER Desbloquea un usuario bloqueado.
CN_ALWAYS_AUTHORIZE_USER Configura un usuario con autorización siempre para M-de-N.
CN_REGISTER_AUTH_PUB_KEY Registra una clave pública de autenticación.
CN_SET_AUTH_PUB_KEY Establece una clave pública de autenticación.

Generación de la clave

Nombre de la operación Description
CN_GENERATE_KEY Genera una clave simétrica.
CN_GENERATE_KEY_PAIR Genera un par de claves asimétrico.
CN_GENERATE_PBE_KEY Genera una clave de cifrado basada en contraseña.
CN_GEN_KEY_ENC_KEY Genera una clave de cifrado de claves.
CN_GEN_PSWD_ENC_KEY Genera una clave para cifrar contraseñas.
CN_DERIVE_KEY Deriva una clave a partir de una clave base.

Encapsulación de claves, importación y exportación

Nombre de la operación Description
CN_WRAP_KEY Encapsula una clave para la exportación protegida.
CN_WRAP_KEY2 Envuelve una clave con atributos extendidos.
CN_UNWRAP_KEY Desencapsula una clave protegida.
CN_UNWRAP_KEY2 Desencapsula una clave protegida con atributos extendidos.
CN_NIST_AES_WRAP Realiza el encapsulado de claves AES de NIST.
CN_NIST_AES_WRAP_UNWRAP2 Realiza el encapsulado o desencapsulado de claves AES de NIST.
CN_INSERT_MASKED_OBJECT Inserta un objeto de clave enmascarado.
CN_EXTRACT_MASKED_OBJECT Extrae un objeto de clave enmascarado.
CN_INSERT_MASKED_OBJECT_USER Inserta un objeto enmascarado con contexto de usuario.
CN_EXTRACT_MASKED_OBJECT_USER Extrae un objeto enmascarado con contexto de usuario.
CN_STORE_KBK_SHARE Almacena un recurso compartido de KBK para la protección de claves M-de-N.

Ciclo de vida de la clave y del objeto

Nombre de la operación Description
CN_CREATE_OBJECT Crea una clave o un objeto de datos.
CN_MODIFY_OBJECT Modifica los atributos del objeto.
CN_MODIFY_KEY_OWNER Transfiere la propiedad de la clave a otro usuario.
CN_DESTROY_OBJECT Elimina permanentemente un objeto .
CN_TOMBSTONE_OBJECT Marca un objeto como lápida para la sincronización.
CN_DELETE_TOMBSTONED_OBJECT Quita permanentemente un objeto marcado como eliminado.
CN_SHARE_OBJECT Comparte un objeto clave con usuarios adicionales.
CN_PARK_OBJECT Serializa un objeto para la transferencia.
CN_UNPARK_OBJECT Deserializa un objeto estacionado.

Copias de seguridad y restauración

Nombre de la operación Description
CN_BACKUP_BEGIN Inicia una operación de copia de seguridad.
CN_BACKUP_CONFIG Realiza una copia de seguridad de la configuración de la partición.
CN_BACKUP_USERS Realiza una copia de seguridad de la base de datos de usuario.
CN_BACKUP_KEY Realiza copia de seguridad de claves.
CN_BACKUP_OBJECT Realiza una copia de seguridad de los objetos.
CN_BACKUP_END Completa y finaliza una copia de seguridad.
CN_RESTORE_BEGIN Inicia una operación de restauración.
CN_RESTORE_END Completa una operación de restauración.
CN_CLONE_SOURCE_INIT Inicializa una partición como origen de clonación.
CN_CLONE_TARGET_INIT Inicializa una partición como destino clonado.
CN_CLONE_SOURCE_STAGE1 Realiza la fase 1 del origen de clonación.
CN_CLONE_TARGET_STAGE1 Realiza la fase 1 del destino de clonación.

Operaciones de token M-de-N

Nombre de la operación Description
CN_APPROVE_TOKEN Aprueba un token de autorización M-of-N.
CN_GET_TOKEN Obtiene un token de tipo M-of-N.
CN_DELETE_TOKEN Elimina un token M-of-N.
CN_TOKEN_TIMEOUT Registra un tiempo de espera de token M-de-N.

Operaciones de firmware y aplicación segura

Nombre de la operación Description
CN_SMAPP_DELETE Elimina una aplicación segura.
CN_SMAPP_CTRL Controla una aplicación segura.
CN_SMAPP_UPDATE_BEGIN Inicia una actualización de aplicación segura.
CN_SMAPP_UPDATE Escribe los datos de actualización de la aplicación segura.
CN_SMAPP_UPDATE_END Finaliza una actualización de la aplicación segura.
CN_SMAPP_DELETE_FILE Elimina un archivo de la aplicación segura.
CN_SMAPP_WRITE_SFRAM Escribe en SFRAM.
CN_SMAPP_READ_SFRAM Lee desde SFRAM.
CN_SMAPP_WRITE_DATA Escribe datos de la aplicación segura.
CN_SMAPP_READ_DATA Lee datos de la aplicación segura.

Integridad de lote y registros de certificados

Todos los registros del mismo lote comparten un CorrelationId. Use este valor para asociar los registros de operaciones de administración de HSM con los registros correspondientes de firma y certificado público.

Nombre de la operación Description
BATCH_BINARY_SIGNATURE Contiene la firma generada por HSM y el hash SHA-256 para el lote. Use la firma y la cadena de certificados para comprobar la integridad y la autenticidad del lote.
BATCH_PARTITION_IDENTITY_CERT Contiene el certificado de identidad de partición firmado por el HSM.
BATCH_HSM_DEVICE_CERT Contiene el certificado que identifica el dispositivo HSM.
BATCH_HSM_MANUFACTURER_ROOT_CERT Contiene el certificado raíz del fabricante de HSM, que es el ancla de confianza de la cadena de certificados HSM.
BATCH_HSM_OWNER_AUTH_CERT Contiene el certificado de autenticación de propietario de HSM, que identifica al propietario del hardware.

Descargar registros de operaciones de HSM para la verificación de firmas

Descargue los registros de operaciones de HSM como un archivo JSON para usarlos para la comprobación de firmas. El archivo exportado debe contener todos los registros para cada CorrelationId incluido, incluidos los registros de firma de lotes y de certificado. No agregue take ni limit a estas consultas porque, al hacerlo, puede exportar un lote firmado incompleto.

Descarga de registros de los últimos siete días para un recurso

Reemplace los marcadores de posición por los valores del recurso HSM en la nube y el espacio de trabajo de Log Analytics. La consulta identifica lotes que tienen registros de los últimos siete días y, a continuación, exporta todos los registros de esos lotes para que permanezcan completos. El _ResourceId filtro no distingue mayúsculas de minúsculas.

resourceGroupName="<resource-group>"
workspaceName="<workspace-name>"
resourceId="/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.HardwareSecurityModules/cloudHsmClusters/<hsm-name>"
outputFile="./logs/CloudHsmOperationLogsLast7Days.json"

mkdir -p ./logs

workspaceCustomerId=$(az monitor log-analytics workspace show \
  --resource-group "$resourceGroupName" \
  --workspace-name "$workspaceName" \
  --query customerId \
  --output tsv)

query=$(cat <<EOF
let recentBatches =
    CloudHsmHardwareOperationAuditLogs
    | where TimeGenerated >= ago(7d)
    | where _ResourceId =~ "$resourceId"
    | distinct CorrelationId;
CloudHsmHardwareOperationAuditLogs
| where _ResourceId =~ "$resourceId"
| where CorrelationId in (recentBatches)
EOF
)

az monitor log-analytics query \
  --workspace "$workspaceCustomerId" \
  --analytics-query "$query" \
  --output json > "$outputFile"

Descargar todos los registros para un identificador de correlación determinado

Use esta consulta para descargar un lote firmado completo. Todos los registros que tienen especificado CorrelationId se escriben en el archivo de salida, independientemente de su orden.

resourceGroupName="<resource-group>"
workspaceName="<workspace-name>"
correlationId="<correlation-id>"
outputFile="./logs/CloudHsmOperationLogsByCorrelationId.json"

mkdir -p ./logs

workspaceCustomerId=$(az monitor log-analytics workspace show \
  --resource-group "$resourceGroupName" \
  --workspace-name "$workspaceName" \
  --query customerId \
  --output tsv)

query=$(cat <<EOF
CloudHsmHardwareOperationAuditLogs
| where CorrelationId == "$correlationId"
EOF
)

az monitor log-analytics query \
  --workspace "$workspaceCustomerId" \
  --analytics-query "$query" \
  --output json > "$outputFile"

Paso siguiente: Comprobación de firma de los registros descargados

Utilice las utilidades de registro de auditoría de HSM en la nube de Azure para comprobar la integridad y la autenticidad de los registros de operaciones de HSM descargados.

  1. Vaya al repositorio del SDK de HSM en la nube de Microsoft Azure.
  2. Abra la carpeta Utilidades .
  3. Descargue el .zip paquete denominado AzureCloudHSM-AuditLogUtils.
  4. Extraiga el paquete y siga las instrucciones incluidas para verificar las firmas de lotes y la cadena de certificados del archivo de registro descargado.