Palo Alto Cortex XDR イベントログを収集する
このドキュメントでは、 Google Cloud Storage を使用して Palo Alto Cortex XDR イベントログを Google Security Operations に取り込む方法について説明します。パーサーは、Palo Alto Networks Cortex XDR JSON ログからセキュリティ イベント データを抽出します。フィールドをマッピングし、データ型を変換して、event_type フィールドと event_sub_type フィールドに関連付けられた条件付きロジックに基づいて、ベンダー、プロダクト、イベントタイプなどのメタデータでイベントを拡充することで、データを統合データモデル(UDM)に正規化します。また、ネットワーク接続、ファイルとレジストリの操作、プロセス情報、ユーザー アクティビティも処理します。
始める前に
次の前提条件を満たしていることを確認してください。
- Google SecOps インスタンス
- Google Cloud Storage が設定され、 Google Cloud 環境で有効になっている
- Google Cloud への特権アクセスと適切な権限
- Palo Alto Cortex XDR への特権アクセス
Google Cloud Storage バケットの作成
- Google Cloud コンソールにログインします。
[Cloud Storage バケット] のページに移動します。
[作成] をクリックします。
[バケットの作成] ページでユーザーのバケット情報を入力します。以下のステップでは、操作を完了した後に [続行] をクリックして、次のステップに進みます。
[始める] セクションで、次の操作を行います。
- バケット名の要件を満たす一意の名前を入力します(例: cortex-xdr-events-secops)。
階層名前空間を有効にするには、展開矢印をクリックして [Optimize for file oriented and data-intensive workloads] セクションを開き、[このバケットで階層的な名前空間を有効にする] を選択します。
バケットラベルを追加するには、展開矢印をクリックして [ラベル] セクションを開きます。
[ラベルを追加] をクリックして、ラベルのキーと値を指定します。
[データの保存場所の選択] セクションで、次の操作を行います。
- ロケーション タイプを選択してください。
ロケーション タイプのメニューを使用して、バケット内のオブジェクト データが永続的に保存されるロケーションを選択します。
クロスバケット レプリケーションを設定するには、[クロスバケット レプリケーションを設定する] セクションを開きます。
[データのストレージ クラスを選択する] セクションで、バケットのデフォルトのストレージ クラスを選択します。あるいは、Autoclass を選択して、バケットデータのストレージ クラスを自動的に管理します。
[オブジェクトへのアクセスを制御する方法を選択する] セクションで、[なし] を選択して公開アクセスの防止を適用し、バケットのオブジェクトの [アクセス制御モデル] を選択します。
[オブジェクト データを保護する方法を選択する] セクションで、次の操作を行います。
- [データ保護] で、バケットに設定するオプションを選択します。
- オブジェクト データの暗号化方法を選択するには、[データ暗号化] 展開矢印をクリックし、データの暗号化方法を選択します。
[作成] をクリックします。
新しく作成した宛先バケットにオブジェクトのライフサイクル管理ルールを構成して、7 日後にオブジェクトを削除します。
- [Cloud Storage バケット] リストで、バケットの名前をクリックします。
- [ライフサイクル] タブを選択し、[ルールの追加] をクリックします。
- [アクションを選択] セクションで、[オブジェクトを削除する] を選択します。
- [オブジェクトの条件を選択] セクションで、[経過日数] を選択し、値を
7日に設定します。 - [保存] をクリックします。
Cortex XDR イベント転送を構成する
- Cortex XDR ウェブ UI にログインします。
- [Settings] > [Configurations] > [Data Management] > [Event Forwarding] に移動します。
- [Activation] セクションでライセンスを有効にします。
- GB イベント転送を有効にして、Cortex XDR Pro の解析済みログを GB 単位で外部 SIEM にエクスポートして保存します。
- エンドポイント イベント転送を有効にして、Cortex XDR Pro EP とクラウド エンドポイントの未加工のエンドポイント データをエクスポートします。
- 選択内容を保存します。
- 表示されたストレージパスをコピーします。
- アクセスキーを含むサービス アカウントの JSON ウェブトークンを生成してダウンロードします。
- 安全な場所に保存します。
Google Cloud Secret Manager を構成する
- GCP にログインします。
- [Secret Manager] ページに移動します。
- 初めての場合は、Secret Manager API を有効にするよう求められます。
- EVENT_FRWD_CRTX_KEY というシークレットを作成し、ダウンロードした JSON xdr_sa_key.json の内容をシークレットの値としてコピーします。
フィードを設定する
フィードを構成する手順は次のとおりです。
- [設定] > [データ管理] > [フィード] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [フィード] に移動します。
- [Add New Feed] をクリックします。
- 次のページで、[単一のフィードを構成する] をクリックします。
- [フィード名] フィールドに、フィードの名前を入力します(例: PANW Cortex XDR イベントログ)。
- [Source type] として [Google Cloud Storage V2] を選択します。
- [ログタイプ] として [Palo Alto Cortex XDR Events] を選択します。
- [Chronicle サービス アカウント] で [サービス アカウントを取得する] をクリックします。
- [次へ] をクリックします。
次の入力パラメータの値を指定します。
- Storage Bucket URI: Google Cloud ストレージ バケットの URL(例:
gs://cortex-xdr-events-secops/)。この URL の末尾はスラッシュ(/)にする必要があります。 ソース削除オプション: [転送されたファイルを削除しない] を選択します。
ファイルの最長存続期間: 過去数日間に変更されたファイルが含まれます。デフォルトは 180 日です。
- Storage Bucket URI: Google Cloud ストレージ バケットの URL(例:
[次へ] をクリックします。
[Finalize] 画面で新しいフィードの設定を確認し、[送信] をクリックします。
フィードが作成されたら、[フィード] リストでそのフィードを見つけ、行の右側にある 3 つのアクション ドットをクリックします。
[フィードを無効にする] を選択します。
Cloud Storage への Secret JSON アクセスを構成する
- GCP にログインします。
- [Secret Manager] ページに移動します。
- シークレット EVENT_FRWD_CRTX_KEY を選択します。
- [権限] タブに移動します。
- 以前に作成したバケット cortex-xdr-events-secops へのストレージ オブジェクト管理者とストレージ レガシー バケット読み取りのアクセス権を付与します。
Cloud Storage の Google SecOps 権限を構成する
- [IAM と管理] > [IAM] に移動します。
- Chronicle サービス アカウントを見つけます。
- 以前に作成したバケット cortex-xdr-events-secops への Storage オブジェクト閲覧者(roles/storage.objectViewer)アクセス権を付与します。
PANW Cortex XDR イベントログのプロジェクト Cloud Storage への取り込みを構成する
- Google Cloudで、[API とサービス] > [ライブラリ] に移動します。
- Cloud Run API と Artifact Registry API を有効にします。
- 上部のナビゲーション バーにあるアイコンをクリックして、Cloud Shell を開きます。
次のコマンドを使用して、カスタムコードをダウンロードします。
git clone https://github.com/PaloAltoNetworks/google-cloud-cortex-chronicle.git次のコマンドを実行して、ディレクトリに移動します。
cd google-cloud-cortex-chronicle/viなどのエディタでenv.propertiesファイルを開きます。次の構成情報を提供してください。
REGION=us-central1 # Update according to your project region REPO_NAME=panw-chronicle IMAGE_NAME=sync_cortex_bucket GCP_PROJECT_ID=chrxxxxxxxxx # Update according to your project ID JOB_NAME=cloud-run-job-cortex-data-sync # The Cloud Job name ROJECT_NUMBER=80xxxxx9 # Update according to your project number # JOB ENV VARIABLES SRC_BUCKET=xdr-us-xxxxx-event-forwarding # Update with the Cortex XDR GCS bucket name DEST_BUCKET=cortex-xdr-events-secops # Update with the GCS name of the bucket you created SECRET_NAME=EVENT_FRWD_CRTX_KEY # Need to match the secret you created JOB_SCHEDULE_MINS=30deploy.shスクリプトに必要な権限を付与します。chmod 744 deploy.shdeploy.shスクリプトを実行します。./deploy.shスクリプトの出力から、使用されている Cloud Job サービス アカウントを特定します。
Cloud Job サービス アカウントに Secret Manager Secret Ancestor 権限を付与して、以前に作成した Secret(この例では EVENT_FRWD_CRTX_KEY)にアクセスできるようにします。
[Secret Manager] > [EVENT_FRWD_CRTX_KEY(シークレット)] > [権限] に移動します。
Google SecOps プラットフォームで、[設定] > [データ マネジメント] > [フィード] > [XDR イベント フィード名] > [フィードを有効にする] に移動します。
UDM マッピング テーブル
| ログフィールド | UDM マッピング | 論理 |
|---|---|---|
action_file_path |
target.file.full_path |
直接マッピングされます。 |
action_file_size |
target.file.size |
直接マッピングされ、符号なし整数に変換されます。 |
action_local_ip |
principal.ip |
直接マッピングされ、他の IP アドレスと統合される |
action_local_port |
principal.port |
直接マッピングされ、整数に変換されます。 |
action_module_path |
target.process.file.full_path |
直接マッピングされます。 |
action_network_connection_id |
network.session_id |
直接マッピングされます。 |
action_network_protocol |
network.ip_protocol |
protocol_number_src に名前が変更され、parse_ip_protocol.include を使用して解析され、network.ip_protocol にマッピングされます。 |
action_process_image_command_line |
target.process.command_line |
直接マッピングされます。 |
action_process_image_md5 |
target.process.file.md5 |
直接マッピングされます。 |
action_process_image_path |
target.process.file.full_path |
直接マッピングされます。 |
action_process_image_sha256 |
target.process.file.sha256 |
直接マッピングされます。 |
action_process_os_pid |
target.process.pid |
直接マッピングされ、文字列に変換されます。 |
action_process_user_sid |
target.user.windows_sid |
直接マッピングされます。 |
action_process_username |
target.user.userid、target.administrative_domain |
小文字に変換され、ドメインとユーザーを解析して、それに応じてマッピングされます。 |
action_registry_data |
target.registry.registry_value_data |
直接マッピングされます。 |
action_registry_key_name |
target.registry.registry_key |
直接マッピングされます。 |
action_registry_value_name |
target.registry.registry_value_name |
直接マッピングされます。 |
action_remote_ip |
target.ip |
直接マッピングされ、他の IP アドレスと統合される |
action_remote_port |
target.port |
直接マッピングされ、整数に変換されます。 |
action_total_download |
network.received_bytes |
直接マッピングされ、符号なし整数に変換されます。 |
action_total_upload |
network.sent_bytes |
直接マッピングされ、符号なし整数に変換されます。 |
agent_hostname |
principal.hostname、observer.hostname |
小文字に変換してマッピング |
agent_ip_addresses |
observer.ip |
JSON として解析され、個々の IP に分割されて統合されます。 |
agent_os_sub_type |
target.platform_version |
直接マッピングされます。 |
event_id |
metadata.product_log_id |
直接マッピングされます。 |
event_sub_type |
metadata.product_event_type |
文字列に変換され、metadata.event_type と metadata.product_event_type の条件付きマッピングに使用されます。 |
event_timestamp |
metadata.event_timestamp、timestamp |
文字列に変換され、UNIX_MS タイムスタンプとして解析され、マッピングされます。 |
event_type |
metadata.event_type |
文字列に変換され、metadata.event_type と metadata.product_event_type の条件付きマッピングに使用されます。 |
os_actor_process_command_line |
principal.process.command_line |
直接マッピングされます。 |
os_actor_process_image_md5 |
principal.process.file.md5 |
直接マッピングされます。 |
os_actor_process_image_path |
principal.process.file.full_path |
直接マッピングされます。 |
os_actor_process_image_sha256 |
principal.process.file.sha256 |
直接マッピングされます。 |
os_actor_process_instance_id |
principal.process.product_specific_process_id |
「PAN:」の接頭辞が付いてマッピングされます。 |
os_actor_process_os_pid |
principal.process.pid |
文字列に変換されてマッピングされます。 |
os_actor_primary_user_sid |
principal.user.windows_sid |
「S-」または「s-」で始まる場合はマッピングされます。 |
os_actor_primary_username |
principal.user.userid、principal.administrative_domain |
小文字に変換され、ドメインとユーザーを解析して、それに応じてマッピングされます。 |
_action |
security_result.action |
_security_result に統合されてからマッピング |
metadata.log_type |
metadata.log_type |
「PAN_CORTEX_XDR_EVENTS」にハードコードされています。 |
metadata.product_name |
metadata.product_name |
「Cortex XDR」にハードコードされます。 |
metadata.vendor_name |
metadata.vendor_name |
「PAN」にハードコードされています。 |
target.platform |
target.platform |
agent_os_sub_type に「Windows」が含まれている場合は、「WINDOWS」に設定されます。 |
action_user_session_id |
event.idm.read_only_udm.network.session_id |
変更履歴からマッピング |
action_username |
event.idm.read_only_udm.principal.user.user_display_name |
変更履歴からマッピング |
agent_ip_addresses |
event.idm.read_only_udm.principal.ip と event.idm.read_only_udm.principal.asset.ip |
変更履歴からマッピング |
agent_os_sub_type |
event.idm.read_only_udm.principal.platform_version |
変更履歴からマッピング |
agent_id |
event.idm.read_only_udm.principal.asset.asset_id と event.idm.read_only_udm.principal.asset_id |
変更履歴からマッピング |
agent_os_type |
event.idm.read_only_udm.principal.platform |
変更履歴からマッピング |
action_process_token |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
action_process_fds |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
action_process_termination_date |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
action_process_termination_code |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
action_network_stats_is_last |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
action_user_is_local_session |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
action_user_status |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
event_version |
event.idm.read_only_udm.metadata.product_version |
変更履歴からマッピング |
action_file_previous_file_path |
event.idm.read_only_udm.principal.file.full_path |
変更履歴からマッピング |
agent_interface_map.ipv4 |
event.idm.read_only_udm.observer.ip |
変更履歴からマッピング |
agent_interface_map.mac |
event.idm.read_only_udm.observer.mac |
変更履歴からマッピング |
action_file_last_writer_actor |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
action_file_device_type |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
action_file_previous_file_name |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
action_file_name |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
agent_id |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
agent_version |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
agent_os_type |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
os_actor_thread_thread_id |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
action_file_type |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
action_file_prev_type |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
os_actor_process_signature_status |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
os_actor_process_logon_id |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
agent_content_version |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
action_module_image_size |
event.idm.read_only_udm.target.file.size |
変更履歴からマッピング |
action_file_md5 |
event.idm.read_only_udm.target.file.md5 |
変更履歴からマッピング |
action_file_sha256 |
event.idm.read_only_udm.target.file.sha256 |
変更履歴からマッピング |
action_module_md5 |
target.process.file.md5 |
変更履歴からマッピング |
action_module_sha256 |
target.process.file.sha256 |
変更履歴からマッピング |
metadata.event_type |
GENERIC_EVENT. |
変更履歴からマッピング |
変更ログ
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。