Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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
- Uma conta do Azure com uma assinatura ativa. Você pode criar uma conta gratuitamente.
- Um recurso Azure Cloud HSM que é implantado com sucesso. Para obter informações, consulte o guia de integração do Azure Cloud HSM.
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.
- Vai ao repositório do SDK HSM Cloud da Microsoft Azure.
- Abra a pasta Utilitários .
- Descarregue o
.zippacote chamadoAzureCloudHSM-AuditLogUtils. - 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.