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.
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.
- Vaya al repositorio del SDK de HSM en la nube de Microsoft Azure.
- Abra la carpeta Utilidades .
- Descargue el
.zippaquete denominadoAzureCloudHSM-AuditLogUtils. - Extraiga el paquete y siga las instrucciones incluidas para verificar las firmas de lotes y la cadena de certificados del archivo de registro descargado.