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
- アクティブなサブスクリプションを持つ Azure アカウント。 無料でアカウントを作成できます。
- 正常にデプロイされた Azure Cloud HSM リソース。 詳細については、 Azure Cloud HSM オンボード ガイドを参照してください。
HSM 操作ログを設定および構成する
次のセクションのコマンドを使用して、監視するリソースを設定します。
HSM 操作ログを格納するストレージ アカウントを作成する
HSM 操作ログをストレージ アカウントに保持するには、まずリソース グループを作成してから、そのリソース グループにストレージ アカウントを作成します。
- Azure CLI
- Azure PowerShell
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 ワークスペースを作成するには、次のコマンドを使用します。
- Azure CLI
- Azure PowerShell
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 ワークスペースの両方にログを送信します。
- Azure CLI
- Azure PowerShell
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を有効にします。
- Azure CLI
- Azure PowerShell
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 も有効になっていることを確認します。
- Azure CLI
- Azure PowerShell
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 操作イベント ログのクエリを実行することもできます。
- Azure CLI
- 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'
登録エラー
"microsoft.insights を使用するために<subscription>が登録されていません" というエラー メッセージが表示された場合、Azure サブスクリプションは、Microsoft.Insights リソース プロバイダーを使用するように登録されていません。 この問題を解決するには、サブスクリプションに Microsoft.Insights プロバイダーを登録します。
- Azure CLI
- Azure PowerShell
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 フィルターでは大文字と小文字が区別されません。
- Azure CLI
- Azure PowerShell
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 を持つすべてのレコードは、順序に関係なく出力ファイルに書き込まれます。
- Azure CLI
- Azure PowerShell
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 操作ログの整合性と真正性を確認します。
- Microsoft Azure Cloud HSM SDK リポジトリに移動します。
- ユーティリティフォルダーを開きます。
-
.zipという名前のAzureCloudHSM-AuditLogUtilsパッケージをダウンロードします。 - パッケージを抽出し、含まれている手順に従って、ダウンロードしたログ ファイルのバッチ署名と証明書チェーンを確認してください。