Tutorial: Configurar e consultar registos de auditoria de operações HSM para Azure Cloud HSM

O Azure Cloud HSM suporta o registo de operações HSM através das definições de diagnóstico do Azure Monitor. A HsmOperations categoria de registo contém registos à prova de adulteração gerados pelo firmware HSM para operações de gestão efetuadas nas suas partições HSM. Envie estes registos tanto para uma conta de armazenamento como para um espaço de trabalho Log Analytics para recolha, análise, monitorização e retenção centralizadas.

O registo das operações do HSM é a estratégia recomendada para segurança e conformidade. Regista operações de gestão, como log-ins, gestão de utilizadores, criação e eliminação de chaves, importação e exportação de chaves, e backup e restauro. Os registos são recuperados de cada partição HSM em lotes, e cada lote é assinado pelo HSM usando a chave de certificado de partição. Todos os registos de um lote partilham o mesmo CorrelationId. Os registos exportados incluem também a assinatura correspondente para o lote assinado e os certificados públicos HSM, que podem ser usados para verificar a integridade e autenticidade do trilho de auditoria.

O Azure Cloud HSM também fornece a HsmServiceOperations categoria de registo de eventos. Estes registos de operações de serviço descrevem pedidos observados pelo serviço Cloud HSM e podem complementar os registos de operação HSM para resolução de problemas. Pode ativar ambas as categorias na mesma definição de diagnóstico, mas use HsmOperations como fonte principal para auditar operações registadas pelo HSM.

Neste tutorial, irá aprender a:

  • Configure e defina os registos de operações do HSM, incluindo a criação de uma conta de armazenamento e de um espaço de trabalho do Log Analytics.
  • Opcionalmente, ativar registos de operações de serviço juntamente com os registos de operações HSM.
  • Consulta os registos de operações HSM para recuperar operações de gestão específicas.
  • Obtenha uma lista completa dos comandos de gestão registados nos registos de operações do HSM.

Importante

As definições de diagnóstico controlam onde os registos são exportados.

Restringa o acesso à conta de armazenamento de destino e ao espaço de trabalho do Log Analytics. Os registos operacionais HSM podem incluir identificadores operacionais como IDs de utilizador, identificadores de sessão, handles de chave e detalhes específicos da operação.

Prerequisites

Configurar e definir registos de operações HSM

Use os comandos nas seções a seguir para configurar os recursos que você deseja monitorar.

Crie uma conta de armazenamento para armazenar registos de operações HSM

Para reter registos de operações HSM numa conta de armazenamento, crie primeiro um grupo de recursos e depois crie a conta de armazenamento nesse 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

Criar uma área de trabalho do Log Analytics

Para criar um espaço de trabalho Log Analytics para armazenar e analisar registos de operações HSM, use o seguinte comando.

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

Note

O tempo de retenção do espaço de trabalho suportado pelo Log Analytics deve ser de pelo menos 30 dias.

Para mais informações sobre como criar um espaço de trabalho Log Analytics para Azure Monitor, consulte Criar um espaço de trabalho Log Analytics.

Ativar configurações de diagnóstico

Para exportar os registos de operações do Azure Cloud HSM, crie uma definição de diagnóstico com a HsmOperations categoria ativada. Os exemplos seguintes enviam registos tanto para uma conta de armazenamento como para um espaço de trabalho do 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 também recolher registos de operações de serviço para resolução de problemas, ative HsmServiceOperations juntamente com 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}]'

Verifique a configuração de diagnóstico

Liste as definições de diagnóstico para o seu recurso Cloud HSM e confirme que a definição inclui a conta de armazenamento, o espaço de trabalho do Log Analytics, Dedicated o tipo de destino e a categoria HsmOperations ativada. Se ativaste os registos de operações do serviço, confirma também que HsmServiceOperations está ativado.

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

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

Verificar a configuração do registo de operações do Cloud HSM

Depois de criar a definição de diagnóstico e realizar uma operação de gestão suportada, dê tempo ao HSM para publicar o lote de auditoria assinado e para o Azure Monitor o ingerir.

Note

Depois de criar uma definição de diagnóstico, os registos normalmente aparecem no Log Analytics em poucos minutos. A ingestão do registo de recursos do Azure pode demorar aproximadamente 20 minutos em condições normais, e a ativação inicial de uma nova definição de diagnóstico pode ocasionalmente demorar até 90 minutos. As definições de diagnóstico não preenchem retroativamente os registos gerados antes da criação da definição.

Pode consultar os registos de operações do Cloud HSM a partir do portal do Azure através do espaço de trabalho Log Analytics. Os registos de operações HSM são armazenados na tabela CloudHsmHardwareOperationAuditLogs. Se também ativaste HsmServiceOperations, esses registos são armazenados separadamente na CloudHsmServiceOperationAuditLogs tabela.

Também pode consultar registos de eventos de operações HSM na cloud usando a CLI do Azure ou 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'

Erro de registo

Se receber a mensagem de erro "<subscription> não está registado para utilizar microsoft.insights", a sua subscrição do Azure não está registada para utilizar o fornecedor de recursos Microsoft.Insights. Para resolver este problema, registe o Microsoft.Insights fornecedor na tua subscrição.

az provider register --namespace Microsoft.Insights

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

Depois de executar o comando, verifique se o provedor de recursos está registrado. Se ainda estiver a registar-se, poderá ter de esperar alguns instantes e verificar novamente.

Consultar registos de operações HSM

Execute as seguintes consultas no editor Log Analytics Logs no portal do Azure. Para os executar a partir da linha de comandos, substitua o texto da consulta no parâmetro CLI do Azure --analytics-query ou no parâmetro Azure PowerShell -Query mostrado nos exemplos de verificação anteriores.

Utilize as seguintes consultas para recuperar operações de gestão HSM a partir de CloudHsmHardwareOperationAuditLogs. Para listar todos os registos de operação de gestão, execute:

CloudHsmHardwareOperationAuditLogs
| where OperationName startswith "CN_"

A tabela também pode conter registos de lotes assinados e certificados cujos nomes de operações começam por BATCH_. Para detalhes sobre os registos de lote e operações de gestão que possam aparecer, consulte o glossário de operações.

Eventos de login e sessão

// 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 criar e excluir usuários

// 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 a criação de chaves

// 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 associados à exclusão de chave

// 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

Glossário de operações

O registo operacional do HSM regista os seguintes registos de lote e comandos de gestão do HSM. Consultas e operações de apenas leitura que não estão listadas aqui não são capturadas em HsmOperations.

Gestão de sessões

Nome da operação Description
CN_LOGIN Inicia sessão de um utilizador numa partição.
CN_LOGOUT Termina a sessão de um utilizador numa partição.
CN_CLOSE_SESSION Fecha uma sessão específica.
CN_CLOSE_ALL_SESSIONS Encerra todas as sessões numa partição.
CN_APP_FINALIZE Finaliza uma sessão de aplicação, como PKCS#11 C_Finalize.
CN_CLOSE_PARTITION_SESSIONS Fecha todas as sessões numa partição específica.
CN_ENCRYPT_SESSION Estabelece uma sessão encriptada.

Ciclo de vida da partição

Nome da operação Description
CN_INIT_TOKEN Inicializa ou formata uma partição.
CN_INIT_DONE Marca a inicialização da partição como concluída.
CN_ZEROIZE Apaga em segurança uma partição.
CN_VENDOR_ZEROIZE Realiza uma operação de zeroização específica do fornecedor.
CN_SET_NODEID Define o ID do nó da partição.
CN_SET_M_VALUE Define o valor M para o quórum M-de-N.
CN_SET_POLICY Define uma política de partição.
CN_SET_HSM_CONFIG Configura a configuração de hardware do HSM.
CN_SET_KBK_PRIMARY Define a Key Block Key (KBK) como primária.
CN_PARTN_STORAGE_UPDATE Atualiza o armazenamento persistente da partição.
CN_PARTN_STORAGE_DELETE Apaga um registo de armazenamento persistente de uma partição.

Gestão de utilizadores

Nome da operação Description
CN_CREATE_USER Cria um utilizador de criptomoedas (CU).
CN_CREATE_CO Cria um Oficial de Cripto (CO).
CN_CREATE_APPLIANCE_USER Cria um utilizador de dispositivo virtual/appliance ou de serviço.
CN_CREATE_PRE_OFFICER Criar pre-officer.
CN_CHANGE_PSWD Altera a palavra-passe ou PIN de um utilizador.
CN_RENAME_PCO Muda o nome de um pré-responsável.
CN_DELETE_USER Exclui um usuário.
CN_UNLOCK_CO Desbloqueia um Oficial de Criptografia impedido de aceder.
CN_GET_CHALLENGE_CO Recebe um desafio para o desbloqueio do Crypto Officer.
CN_SET_USER_ATTR Define os atributos do utilizador.
CN_UNLOCK_USER Desbloqueia um utilizador impedido de iniciar sessão.
CN_ALWAYS_AUTHORIZE_USER Configura um utilizador sempre autorizado para M-of-N.
CN_REGISTER_AUTH_PUB_KEY Regista uma chave pública de autenticação.
CN_SET_AUTH_PUB_KEY Define uma chave pública de autenticação.

Geração de chaves

Nome da operação Description
CN_GENERATE_KEY Gera uma chave simétrica.
CN_GENERATE_KEY_PAIR Gera um par de chaves assimétrico.
CN_GENERATE_PBE_KEY Gera uma chave de encriptação baseada em palavra-passe.
CN_GEN_KEY_ENC_KEY Gera uma chave de encriptação de chaves (KEK).
CN_GEN_PSWD_ENC_KEY Gera uma chave de encriptação de palavra-passe.
CN_DERIVE_KEY Deriva uma chave a partir de uma chave base.

Encapsulamento de chaves, importação e exportação

Nome da operação Description
CN_WRAP_KEY Encapsula uma chave para exportação protegida.
CN_WRAP_KEY2 Envolve uma chave com atributos estendidos.
CN_UNWRAP_KEY Desencapsula uma chave protegida.
CN_UNWRAP_KEY2 Desencapsula-se uma chave protegida com atributos estendidos.
CN_NIST_AES_WRAP Realiza o key wrap NIST AES.
CN_NIST_AES_WRAP_UNWRAP2 Realiza o encapsulamento ou desencapsulamento de chave AES do NIST.
CN_INSERT_MASKED_OBJECT Insere um objeto-chave mascarado.
CN_EXTRACT_MASKED_OBJECT Extrai um objeto de chave com máscara.
CN_INSERT_MASKED_OBJECT_USER Insere um objeto mascarado com o contexto do utilizador.
CN_EXTRACT_MASKED_OBJECT_USER Extrai um objeto mascarado com o contexto do utilizador.
CN_STORE_KBK_SHARE Armazena uma partilha KBK para proteção de chaves M-of-N.

Ciclo de vida da chave e do objeto

Nome da operação Description
CN_CREATE_OBJECT Cria uma chave ou objeto de dados.
CN_MODIFY_OBJECT Modifica atributos de objeto.
CN_MODIFY_KEY_OWNER Transfere a titularidade da chave para outro utilizador.
CN_DESTROY_OBJECT Apaga permanentemente um objeto.
CN_TOMBSTONE_OBJECT Marca um objeto como marcado como eliminado para sincronização.
CN_DELETE_TOMBSTONED_OBJECT Remove um objeto marcado como eliminado permanentemente.
CN_SHARE_OBJECT Partilha um objeto-chave com utilizadores adicionais.
CN_PARK_OBJECT Serializa um objeto para transferência.
CN_UNPARK_OBJECT Desserializa um objeto em espera.

Backup e restauração

Nome da operação Description
CN_BACKUP_BEGIN Inicia uma operação de cópia de segurança.
CN_BACKUP_CONFIG Efetua uma cópia de segurança da configuração da partição.
CN_BACKUP_USERS Cria uma cópia de segurança da base de dados dos utilizadores.
CN_BACKUP_KEY Faz cópia de segurança das chaves.
CN_BACKUP_OBJECT Cria cópias de segurança de objetos.
CN_BACKUP_END Conclui e finaliza uma cópia de segurança.
CN_RESTORE_BEGIN Inicia uma operação de restauro.
CN_RESTORE_END Conclui uma operação de restauro.
CN_CLONE_SOURCE_INIT Inicializa uma partição como uma fonte clone.
CN_CLONE_TARGET_INIT Inicializa uma partição como alvo clone.
CN_CLONE_SOURCE_STAGE1 Realiza a fase 1 de clone-source.
CN_CLONE_TARGET_STAGE1 Executa o estágio 1 de clone-target.

Operações de token M-of-N

Nome da operação Description
CN_APPROVE_TOKEN Aprova um token de autorização M-of-N.
CN_GET_TOKEN Recupera um token M-of-N.
CN_DELETE_TOKEN Elimina um token M-of-N.
CN_TOKEN_TIMEOUT Regista um tempo limite do token M-of-N.

Firmware e operações de aplicação segura

Nome da operação Description
CN_SMAPP_DELETE Apaga uma aplicação segura.
CN_SMAPP_CTRL Contém uma aplicação segura.
CN_SMAPP_UPDATE_BEGIN Inicia uma atualização segura da aplicação.
CN_SMAPP_UPDATE Escreve dados de atualização de aplicação segura.
CN_SMAPP_UPDATE_END Finaliza uma atualização da aplicação segura.
CN_SMAPP_DELETE_FILE Apaga um ficheiro de aplicação protegido.
CN_SMAPP_WRITE_SFRAM Escreve para a SFRAM.
CN_SMAPP_READ_SFRAM Lê da SFRAM.
CN_SMAPP_WRITE_DATA Escreve dados da aplicação segura.
CN_SMAPP_READ_DATA Lê dados de uma aplicação segura.

Integridade do lote e registos de certificados

Todos os registos do mesmo lote partilham um CorrelationId. Use este valor para associar os registos de operações de gestão do HSM aos registos correspondentes de assinatura e de certificado público.

Nome da operação Description
BATCH_BINARY_SIGNATURE Contém a assinatura gerada pelo HSM e o hash SHA-256 para o lote. Use a assinatura e a cadeia de certificados para verificar a integridade e autenticidade do lote.
BATCH_PARTITION_IDENTITY_CERT Contém o certificado de identidade da partição assinado pelo HSM.
BATCH_HSM_DEVICE_CERT Contém o certificado que identifica o dispositivo HSM.
BATCH_HSM_MANUFACTURER_ROOT_CERT Contém o certificado raiz do fabricante HSM, que é a âncora de confiança para a cadeia de certificados HSM.
BATCH_HSM_OWNER_AUTH_CERT Contém o Certificado de Autenticação do Proprietário HSM, que identifica o proprietário do hardware.

Descarregue registos de operação HSM para verificação de assinatura

Descarregue os registos de operações do HSM como ficheiro JSON para os usar para verificação de assinaturas. O ficheiro exportado deve conter todos os registos para cada CorrelationId incluído, incluindo os registos de assinatura de lote e de certificado. Não adicione take nem limit a estas consultas porque, ao fazê-lo, pode exportar um lote assinado incompleto.

Descarregue os registos dos últimos sete dias de um recurso

Substitua os marcadores de posição pelos valores do seu recurso Cloud HSM e do seu espaço de trabalho Log Analytics. A consulta identifica lotes que têm registos dos últimos sete dias e depois exporta todos os registos desses lotes para que permaneçam completos. O filtro _ResourceId não distingue maiú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"

Descarregue todos os registos para um determinado ID de correlação

Use esta consulta para descarregar um lote completo assinado. Todos os registos que têm o CorrelationId especificado são escritos no ficheiro de saída, independentemente da sua ordem.

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"

Próximo passo: Verificação de assinatura dos registos descarregados

Use as utilidades de registos de auditoria do Azure Cloud HSM para verificar a integridade e autenticidade dos registos de operações do HSM descarregados.

  1. Vai ao repositório do SDK HSM Cloud da Microsoft Azure.
  2. Abra a pasta Utilitários .
  3. Descarregue o .zip pacote chamado AzureCloudHSM-AuditLogUtils.
  4. Extraia o pacote e siga as instruções incluídas para verificar as assinaturas do lote e a cadeia de certificados do ficheiro de registo descarregado.