チュートリアル: Azure Cloud HSM の HSM 操作監査ログを構成してクエリを実行する

Azure Cloud HSM では、Azure Monitor診断設定による HSM 操作のログ記録がサポートされます。 HsmOperations ログ カテゴリには、HSM パーティションで実行される管理操作用に HSM ファームウェアによって生成された改ざん防止レコードが含まれています。 これらのレコードをストレージ アカウントとLog Analytics ワークスペースの両方に送信して、一元的な収集、分析、監視、保持を行います。

HSM 操作のログ記録は、セキュリティとコンプライアンスのための推奨されるログ記録戦略です。 サインイン、ユーザー管理、キーの作成と削除、キーのインポートとエクスポート、バックアップと復元などの管理操作を記録します。 ログは各 HSM パーティションからバッチで取得され、各バッチはパーティション証明書キーを使用して HSM によって署名されます。 バッチのすべてのレコードは、同じ CorrelationIdを共有します。 エクスポートされたレコードには、署名されたバッチに対応する署名と HSM パブリック証明書も含まれます。これを使用して、監査証跡の整合性と真正性を検証できます。

Azure Cloud HSM には、HsmServiceOperationsイベント ログ カテゴリも用意されています。 これらのサービス操作ログは、Cloud HSM サービスによって観測された要求を記述し、トラブルシューティングのために HSM 操作ログを補完できます。 同じ診断設定で両方のカテゴリを有効にできますが、HSM によって記録される監査操作のプライマリ ソースとしては HsmOperations を使用してください。

このチュートリアルでは、次の操作を行います。

  • ストレージ アカウントと Log Analytics ワークスペースの作成など、HSM 操作ログをセットアップおよび構成します。
  • 必要に応じて、HSM 操作ログと共にサービス操作ログを有効にします。
  • HSM 操作ログにクエリを実行して、特定の管理操作を取得します。
  • HSM 操作ログによって記録された管理コマンドの包括的な一覧を取得します。

Important

診断設定は、ログをエクスポートする場所を制御します。

宛先ストレージ アカウントと Log Analytics ワークスペースへのアクセスを制限します。 HSM 操作レコードには、ユーザー ID、セッション ハンドル、キー ハンドル、操作固有の詳細などの操作識別子を含めることができます。

Prerequisites

HSM 操作ログを設定および構成する

次のセクションのコマンドを使用して、監視するリソースを設定します。

HSM 操作ログを格納するストレージ アカウントを作成する

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

Log Analytics ワークスペースを作成する

HSM 操作ログを格納および分析するためのLog Analytics ワークスペースを作成するには、次のコマンドを使用します。

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

Note

サポートされているLog Analytics ワークスペースの保持時間は、少なくとも 30 日である必要があります。

Azure Monitor 用の Log Analytics ワークスペースの作成の詳細については、「 Log Analytics ワークスペースの作成」を参照してください。

診断設定を有効にする

Azure Cloud HSM の操作ログをエクスポートするには、HsmOperations カテゴリを有効にして診断設定を作成します。 次の例では、ストレージ アカウントと 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}]'

トラブルシューティングのためにサービス操作ログも収集するには、HsmOperationsと共にHsmServiceOperationsを有効にします。

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}]'

診断設定を確認する

Cloud HSM リソースの診断設定を一覧表示し、設定にストレージ アカウント、Log Analytics ワークスペース、Dedicated宛先の種類、有効なHsmOperations カテゴリが含まれていることを確認します。 サービス操作ログを有効にした場合は、HsmServiceOperations も有効になっていることを確認します。

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

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

Cloud HSM 操作ログの構成を確認する

診断設定を作成し、サポートされている管理操作を実行したら、HSM が署名済みの監査バッチを発行し、Azure Monitor がそれを取り込むまで時間を置いてください。

Note

診断設定を作成すると、ログは通常、数分以内にLog Analyticsに表示されます。 Azure のリソース ログの取り込みには、通常の条件下では約 20 分かかる場合があり、新しい診断設定の初期アクティブ化には最大 90 分かかる場合があります。 診断設定では、設定が作成される前に生成されたログはバックフィルされません。

Log Analytics ワークスペースを使用して、Azure ポータルから Cloud HSM 操作ログに対してクエリを実行できます。 HSM 操作レコードは、 CloudHsmHardwareOperationAuditLogs テーブルに格納されます。 HsmServiceOperationsも有効にした場合、それらのレコードは CloudHsmServiceOperationAuditLogs テーブルに個別に格納されます。

Azure CLIまたはAzure PowerShellを使用して、Cloud HSM 操作イベント ログのクエリを実行することもできます。

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'

登録エラー

"microsoft.insights を使用するために<subscription>が登録されていません" というエラー メッセージが表示された場合、Azure サブスクリプションは、Microsoft.Insights リソース プロバイダーを使用するように登録されていません。 この問題を解決するには、サブスクリプションに Microsoft.Insights プロバイダーを登録します。

az provider register --namespace Microsoft.Insights

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

コマンドを実行した後、リソース プロバイダーが登録されていることを確認します。 まだ登録している場合は、しばらく待ってからもう一度確認する必要があります。

HSM 操作ログのクエリ

Azure ポータルの Log Analytics ログ エディターで、次のクエリを実行します。 コマンド ラインから実行するには、Azure CLI --analytics-query パラメーターまたは前の検証例に示した Azure PowerShell -Query パラメーターのクエリ テキストを置き換えます。

次のクエリを使用して、CloudHsmHardwareOperationAuditLogs から HSM 管理操作に関する情報を取得します。 すべての管理操作レコードを一覧表示するには、次を実行します。

CloudHsmHardwareOperationAuditLogs
| where OperationName startswith "CN_"

テーブルには、操作名の先頭が BATCH_ で示される署名付きバッチ レコードと証明書レコードを含めることもできます。 表示される可能性があるバッチ レコードと管理操作の詳細については、「操作用語集」を参照してください。

ログインイベントとセッションイベント

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

ユーザーを作成および削除するためのイベント

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

キー作成のイベント

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

キー削除のイベント

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

操作の用語集

HSM 操作ログには、次のバッチ レコードと HSM 管理コマンドが記録されます。 ここに記載されていない読み取り専用のクエリと操作は、 HsmOperationsではキャプチャされません。

セッション管理

操作名 Description
CN_LOGIN ユーザーをパーティションにログインさせます。
CN_LOGOUT ユーザーをパーティションからログアウトします。
CN_CLOSE_SESSION 特定のセッションを閉じます。
CN_CLOSE_ALL_SESSIONS パーティション上のすべてのセッションを閉じます。
CN_APP_FINALIZE PKCS#11 C_Finalizeなどのアプリケーション セッションを終了します。
CN_CLOSE_PARTITION_SESSIONS 特定のパーティション上のすべてのセッションを閉じます。
CN_ENCRYPT_SESSION 暗号化されたセッションを確立します。

パーティションのライフサイクル

操作名 Description
CN_INIT_TOKEN パーティションを初期化または書式設定します。
CN_INIT_DONE パーティションの初期化を完了としてマークします。
CN_ZEROIZE パーティションをゼロ化します。
CN_VENDOR_ZEROIZE ベンダー固有のゼロ化操作を実行します。
CN_SET_NODEID パーティション ノード ID を設定します。
CN_SET_M_VALUE M-of-N クォーラムの M 値を設定します。
CN_SET_POLICY パーティション ポリシーを設定します。
CN_SET_HSM_CONFIG HSM ハードウェア構成を設定します。
CN_SET_KBK_PRIMARY キー ブロック キー (KBK) プライマリを設定します。
CN_PARTN_STORAGE_UPDATE パーティション永続ストレージを更新します。
CN_PARTN_STORAGE_DELETE パーティション永続ストレージ レコードを削除します。

ユーザー管理

操作名 Description
CN_CREATE_USER Crypto User (CU) を作成します。
CN_CREATE_CO Crypto Officer (CO) を作成します。
CN_CREATE_APPLIANCE_USER アプライアンスまたはサービス ユーザーを作成します。
CN_CREATE_PRE_OFFICER pre-officer を作成します。
CN_CHANGE_PSWD ユーザーのパスワードまたは PIN を変更します。
CN_RENAME_PCO pre-officer の名前を変更します。
CN_DELETE_USER ユーザーを削除します。
CN_UNLOCK_CO ロックアウトされたCrypto Officerのロックを解除します。
CN_GET_CHALLENGE_CO 暗号管理責任者のロック解除のためのチャレンジを取得します。
CN_SET_USER_ATTR ユーザー属性を設定します。
CN_UNLOCK_USER ロックアウトされたユーザーのロックを解除します。
CN_ALWAYS_AUTHORIZE_USER M-of-N に対して always-authorize ユーザーを構成します。
CN_REGISTER_AUTH_PUB_KEY 認証公開キーを登録します。
CN_SET_AUTH_PUB_KEY 認証公開キーを設定します。

キーの生成

操作名 Description
CN_GENERATE_KEY 対称キーを生成します。
CN_GENERATE_KEY_PAIR 非対称キー ペアを生成します。
CN_GENERATE_PBE_KEY パスワード ベースの暗号化キーを生成します。
CN_GEN_KEY_ENC_KEY キー暗号化キーを生成します。
CN_GEN_PSWD_ENC_KEY パスワード暗号化キーを生成します。
CN_DERIVE_KEY 基本キーからキーを派生させます。

鍵ラッピング、インポート、エクスポート

操作名 Description
CN_WRAP_KEY 保護されたエクスポートのキーをラップします。
CN_WRAP_KEY2 拡張属性を持つキーをラップします。
CN_UNWRAP_KEY 保護されたキーのラップを解除します。
CN_UNWRAP_KEY2 拡張属性を持つ保護されたキーのラップを解除します。
CN_NIST_AES_WRAP NIST AES キー ラップを実行します。
CN_NIST_AES_WRAP_UNWRAP2 NIST AES キーラップまたはラップ解除を実行します。
CN_INSERT_MASKED_OBJECT マスクされたキー オブジェクトを挿入します。
CN_EXTRACT_MASKED_OBJECT マスクされたキー オブジェクトを抽出します。
CN_INSERT_MASKED_OBJECT_USER ユーザー コンテキストでマスクされたオブジェクトを挿入します。
CN_EXTRACT_MASKED_OBJECT_USER ユーザー コンテキストでマスクされたオブジェクトを抽出します。
CN_STORE_KBK_SHARE M-of-N キー保護用の KBK 共有を格納します。

キーとオブジェクトのライフサイクル

操作名 Description
CN_CREATE_OBJECT キーまたはデータ オブジェクトを作成します。
CN_MODIFY_OBJECT オブジェクト属性を変更します。
CN_MODIFY_KEY_OWNER キーの所有権を別のユーザーに転送します。
CN_DESTROY_OBJECT オブジェクトを完全に削除します。
CN_TOMBSTONE_OBJECT オブジェクトを同期のためにトゥームストーン化済みとしてマークします。
CN_DELETE_TOMBSTONED_OBJECT トゥームストーン化されたオブジェクトを完全に削除します。
CN_SHARE_OBJECT キー オブジェクトを追加のユーザーと共有します。
CN_PARK_OBJECT 転送するオブジェクトをシリアル化します。
CN_UNPARK_OBJECT パークされたオブジェクトを逆シリアル化します。

バックアップと復元

操作名 Description
CN_BACKUP_BEGIN バックアップ操作を開始します。
CN_BACKUP_CONFIG パーティション構成をバックアップします。
CN_BACKUP_USERS ユーザー データベースをバックアップします。
CN_BACKUP_KEY キーをバックアップします。
CN_BACKUP_OBJECT オブジェクトをバックアップします。
CN_BACKUP_END バックアップを完了し、確定します。
CN_RESTORE_BEGIN 復元操作を開始します。
CN_RESTORE_END 復元操作を完了します。
CN_CLONE_SOURCE_INIT パーティションを複製ソースとして初期化します。
CN_CLONE_TARGET_INIT パーティションを複製ターゲットとして初期化します。
CN_CLONE_SOURCE_STAGE1 clone-source ステージ 1 を実行します。
CN_CLONE_TARGET_STAGE1 clone-target ステージ 1 を実行します。

M-of-N トークン操作

操作名 Description
CN_APPROVE_TOKEN M-of-N 承認トークンを承認します。
CN_GET_TOKEN M-of-N トークンを取得します。
CN_DELETE_TOKEN M-of-N トークンを削除します。
CN_TOKEN_TIMEOUT M-of-N トークンのタイムアウトを記録します。

ファームウェアとセキュア アプリケーションの操作

操作名 Description
CN_SMAPP_DELETE セキュリティで保護されたアプリケーションを削除します。
CN_SMAPP_CTRL セキュリティで保護されたアプリケーションを制御します。
CN_SMAPP_UPDATE_BEGIN セキュリティで保護されたアプリケーションの更新を開始します。
CN_SMAPP_UPDATE 安全なアプリケーション更新データを書き込みます。
CN_SMAPP_UPDATE_END セキュア アプリケーションの更新を完了します。
CN_SMAPP_DELETE_FILE セキュリティで保護されたアプリケーション ファイルを削除します。
CN_SMAPP_WRITE_SFRAM SFRAM に書き込みます。
CN_SMAPP_READ_SFRAM SFRAM から読み取ります。
CN_SMAPP_WRITE_DATA セキュリティで保護されたアプリケーション データを書き込みます。
CN_SMAPP_READ_DATA セキュリティで保護されたアプリケーション データを読み取ります。

バッチの整合性と証明書の記録

同じバッチ内のすべてのレコードが CorrelationIdを共有します。 この値を使用して、HSM 管理操作レコードを対応する署名およびパブリック証明書レコードに関連付けます。

操作名 Description
BATCH_BINARY_SIGNATURE HSM で生成された署名と、バッチの SHA-256 ハッシュが含まれます。 署名と証明書チェーンを使用して、バッチの整合性と真正性を確認します。
BATCH_PARTITION_IDENTITY_CERT HSM によって署名されたパーティション ID 証明書が含まれています。
BATCH_HSM_DEVICE_CERT HSM デバイスを識別する証明書が含まれています。
BATCH_HSM_MANUFACTURER_ROOT_CERT HSM の製造元のルート証明書 (HSM 証明書チェーンのトラスト アンカー) が含まれています。
BATCH_HSM_OWNER_AUTH_CERT ハードウェア所有者を識別する HSM 所有者認証証明書が含まれています。

署名検証用の HSM 操作ログをダウンロードする

HSM 操作ログを JSON ファイルとしてダウンロードし、署名検証に使用します。 エクスポートされるファイルには、バッチ署名と証明書レコードを含め、含まれる各 CorrelationIdのすべてのレコードが含まれている必要があります。 追加すると、不完全な署名済みバッチがエクスポートされる可能性があるため、これらのクエリに take または limit を追加しないでください。

リソースの過去 7 日間のログをダウンロードする

プレースホルダーを Cloud HSM リソースと Log Analytics ワークスペースの値で置き換えます。 このクエリでは、過去 7 日間のレコードを含むバッチを識別し、それらのバッチのすべてのレコードをエクスポートして、完全な状態に保ちます。 _ResourceId フィルターでは大文字と小文字が区別されません。

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"

特定の関連付け ID のすべてのログをダウンロードする

このクエリを使用して、1 つの完全な署名済みバッチをダウンロードしてください。 指定した CorrelationId を持つすべてのレコードは、順序に関係なく出力ファイルに書き込まれます。

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"

次の手順: ダウンロードしたログの署名検証

Azure Cloud HSM 監査ログ ユーティリティを使用して、ダウンロードした HSM 操作ログの整合性と真正性を確認します。

  1. Microsoft Azure Cloud HSM SDK リポジトリに移動します。
  2. ユーティリティフォルダーを開きます。
  3. .zip という名前の AzureCloudHSM-AuditLogUtils パッケージをダウンロードします。
  4. パッケージを抽出し、含まれている手順に従って、ダウンロードしたログ ファイルのバッチ署名と証明書チェーンを確認してください。