Tutorial: Configurare la registrazione di audit per Azure Payment HSM v2

Azure Payment HSM v2 supporta la registrazione di controllo tramite le impostazioni di diagnostica di Monitoraggio di Azure. Inviare i log a un account Archiviazione di Azure per la conservazione e a un'area di lavoro Log Analytics per query, analisi e monitoraggio.

La registrazione degli eventi operativi fornisce un record coerente di accesso e operazioni del modulo di protezione hardware per supportare la responsabilità e la tracciabilità.

I log delle operazioni consentono di rilevare l'accesso non autorizzato, analizzare gli eventi imprevisti di sicurezza, supportare la conformità alle normative e identificare anomalie che potrebbero indicare violazioni o configurazioni errate. Queste funzionalità consentono di proteggere l'integrità e la riservatezza delle operazioni crittografiche.

In questa esercitazione, imparerai a:

  • Creare un account di archiviazione e un'area di lavoro Log Analytics e configurare la registrazione di controllo.
  • Interroga i log di audit per recuperare eventi specifici relativi alle operazioni dell'HSM.
  • Esaminare i comandi comuni dell'operazione HSM.

Importante

Per mantenere la sicurezza e la privacy, la registrazione esclude dettagli sensibili, ad esempio ID chiave, nomi di chiave e altre informazioni identificabili correlate a chiavi, utenti o sessioni. I log acquisiscono l'operazione HSM eseguita, l'ora dell'operazione e i metadati del modulo di protezione hardware pertinenti.

Prerequisiti

Impostare e configurare la registrazione di audit

Usare i comandi nelle sezioni seguenti per configurare le risorse da monitorare.

Creare un account di archiviazione per archiviare i log del modulo di protezione hardware

L'account di archiviazione dati archivia i log di controllo per l'analisi di conformità e il backup. L'area di lavoro Log Analytics supporta query interattive e monitoraggio. Configurare entrambe le destinazioni per conservare i log e analizzare gli eventi.

Creare prima di tutto un gruppo di risorse. Creare quindi un account di archiviazione in tale gruppo di risorse per archiviare i log HSM.

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

Creare un'area di lavoro Log Analytics

Usa uno dei comandi seguenti per creare un'area di lavoro Log Analytics per l'archiviazione e l'analisi dei log HSM.

az monitor log-analytics workspace create \
  --resource-group "<resource-group>" \
  --workspace-name "<workspace-name>"

Per altre informazioni sulla creazione di un'area di lavoro Log Analytics per Monitoraggio di Azure, vedere Creare un'area di lavoro Log Analytics.

Abilitare le impostazioni di diagnostica

Utilizzare il codice seguente per configurare le impostazioni di diagnostica per la registrazione di audit di Azure Payment HSM v2. Sostituire i segnaposto con i valori appropriati per l'ambiente.

resourceId="/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.HardwareSecurityModules/paymentHsmClusters/<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-phsmv2AuditLogs" \
  --storage-account $storageAccountId \
  --workspace $workspaceId \
  --logs '[{"category":"HsmOperations","enabled":true}]'

Verificare la configurazione della registrazione di Payment HSM v2

Dopo aver creato l'impostazione di diagnostica, i dati devono iniziare a passare alle destinazioni selezionate entro 90 minuti.

Nel portale di Azure, usare l'area di lavoro Log Analytics per interrogare i log di audit di Payment HSM v2. L'account di archiviazione mantiene i log esportati per il controllo o il backup.

Schermata del portale di Azure che mostra i risultati della query del log di controllo di Azure Payment HSM v2 in un'area di lavoro Log Analytics.

Usare interfaccia della riga di comando di Azure o Azure PowerShell per interrogare i log di controllo di Payment HSM v2.

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

az monitor log-analytics query \
  --workspace $workspaceId \
  --analytics-query "CloudHsmHardwareOperationAuditLogs | take 10"

La query restituisce record del log di controllo simili all'esempio seguente. I valori sono illustrativi e l'esempio omette i campi per la leggibilità.

[
  {
    "TimeGenerated": "2026-08-27T00:00:01.000Z",
    "ClusterType": "paymenthsm",
    "Location": "westus",
    "PartitionId": "1",
    "HSMSerialNumber": "RCN123456789A",
    "FirmwareVersion": "MARVELL-LS2-FW-10.23-1107",
    "AuditLogType": "ATALLA_LOG_SIGNED",
    "OperationName": "ATALLA_LOG_SIGNED",
    "ResultType": "Success",
    "CorrelationId": "42d04d6a-a1aa-11f1-80fd-00224809c5d2",
    "SequenceNumber": "0X000000000000023D",
    "BinaryLogData": "AAAAB2VjaG8gdGVzdA...",
    "BinarySignature": "MEUCIQDf8h2c...=="
  },
  {
    "TimeGenerated": "2026-08-27T00:00:01.000Z",
    "ClusterType": "paymenthsm",
    "Location": "westus",
    "PartitionId": "2",
    "HSMSerialNumber": "RCN123456789B",
    "FirmwareVersion": "MARVELL-LS2-FW-10.23-1107",
    "AuditLogType": "ATALLA_LOG_SIGNED",
    "OperationName": "ATALLA_LOG_SIGNED",
    "ResultType": "Success",
    "CorrelationId": "42629144-a1aa-11f1-8098-000d3a3045d2",
    "SequenceNumber": "0X000000000000022D",
    "BinaryLogData": "AAAAC2FwbSB2ZXJzaW9u...",
    "BinarySignature": "MEQCIH2fY9a...=="
  }
]

Per una descrizione completa di ogni colonna, vedere le informazioni di riferimento sulla tabella CloudHsmHardwareOperationAuditLogs .

Errore di registrazione

Se viene visualizzato il messaggio di errore "<subscription> non è registrato per l'uso di microsoft.insights", la sottoscrizione Azure non è registrata per l'uso del Microsoft.Insights provider di risorse. Per risolvere questo problema, registra il provider Microsoft.Insights nella tua sottoscrizione.

az provider register --namespace Microsoft.Insights

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

Dopo aver eseguito il comando, verificare che il provider di risorse sia registrato. Se è ancora in fase di registrazione, attendere alcuni istanti e riprovare.

Eseguire query sui log eventi dell'operazione

Esegui CloudHsmHardwareOperationAuditLogs in Log di Monitoraggio di Azure per elencare gli eventi operativi di Azure Payment HSM v2 acquisiti nei log di controllo.

Note

I log di controllo di Azure Payment HSM v2 usano la tabella CloudHsmHardwareOperationAuditLogs. Questa tabella riporta le operazioni hardware eseguite sulle partizioni Azure Payment HSM.

Voci del registro degli autotest giornalieri

Il log di controllo include una voce normale, Daily self-tests passedad esempio . Utimaco Atalla Payment Module (APM) genera questa voce per soddisfare i requisiti di conformità PCI. La convalida giornaliera automatizzata verifica l'integrità del modulo di protezione hardware, le protezioni antimanomissione e le funzioni crittografiche per verificare che la piattaforma rimanga invariata e conforme per i carichi di lavoro di elaborazione dei pagamenti.

Verificare la connettività dell'HSM di pagamento v2

Eseguire il comando seguente per verificare la connettività di base e confermare che la registrazione di audit acquisisca gli eventi operativi di Azure Payment HSM v2. Sostituisci <private-ip-address> con l'indirizzo IP privato dell'interfaccia di gestione del tuo Payment HSM v2. L'interfaccia di gestione usa sempre la porta 7005. Per informazioni dettagliate sulle operazioni eseguite da ogni comando, vedere il glossario delle operazioni.

{
  for c in \
    '<00#EchoTest#>' \
    '<1101#>' '<1100#>' '<1120#>' '<1200#>' \
    '<9A#ID#>' '<9A#INFO#>' '<9A#INFO#CLOUD#>' '<9A#MFK#>' '<9A#KEY#>' '<9A#SERIAL#>'; do
    printf '%s\r\n' "$c"
    sleep 1
  done
  sleep 3
} | timeout 25 openssl s_client -connect <private-ip-address>:7005 -quiet 2>/dev/null

Glossario delle operazioni

I comandi seguenti sono correlati agli eventi dell'operazione HSM. Per un elenco completo dei comandi, consultare il manuale di riferimento dei comandi di Atalla Payment Module (APM) di Utimaco.

Connettività di base

Comando Description
<00#EchoTest#> Rimanda i dati e dimostra che la connettività di base e il parser dei comandi funzionano.

Integrità della chiave e della chiave del file master

Comando Description
<9A#MFK#> Mostra le informazioni sulla chiave del file master.
<9A#KEY#> Mostra le informazioni sullo stato della chiave.

Conformità e controllo

Comando Description
<1200#> Restituisce le informazioni di conformità.
<1101#> Restituisce la versione del software APM.
<1100#> Restituisce informazioni sulla versione del software estesa.
<1120#> Restituisce informazioni generali sul sistema APM.
<9A#ID#> Restituisce l'identificazione e lo stato dell'appliance.
<9A#SERIAL#> Restituisce le informazioni sul numero di serie dell'HSM.
<9A#INFO#> Restituisce informazioni sul modulo di protezione hardware, tra cui configurazione, stato software, impostazioni di sicurezza e integrità operativa.
<9A#INFO#CLOUD#> Restituisce informazioni amministrative specifiche del cloud.