ExtraHop Reveal(x) ログを収集する

パーサーのバージョン: 12.0

以下でサポートされています。

Google SecOps SIEM

このドキュメントでは、Bindplane を使用して ExtraHop Reveal(x) ログを Google Security Operations に取り込む方法について説明します。ExtraHop Reveal(x) は、ネットワーク トラフィックをリアルタイムで可視化するネットワーク検出および対応（NDR）プラットフォームです。これにより、組織はクラウド環境とオンプレミス環境全体で脅威の検出、インシデントの調査、セキュリティ イベントへの対応を行うことができます。

始める前に

次の前提条件を満たしていることを確認してください。

• Google SecOps インスタンス。
• Windows Server 2016 以降、または systemd を使用する Linux ホスト。
• プロキシの背後で実行している場合は、Bindplane エージェントの要件に従ってファイアウォール ポートが開いていることを確認します。
• ExtraHop Reveal(x) の管理設定への特権アクセス。

Bindplane エージェントの Google SecOps 認証情報を取得する

Bindplane エージェントを Google SecOps に対して認証するには、次のいずれかの方法を選択します。

• 新規デプロイ: Chronicle API を使用します（オプション 1）。
• 以前のデプロイ: 2027 年 7 月 20 日に Ingestion API が廃止されるまで、取り込み認証ファイル（オプション 2）を引き続き使用します。

オプション 1: Chronicle API のサービス アカウントを作成する（推奨）

1. Google Cloud コンソールにログインし、Google SecOps インスタンスにリンクされている Google Cloud プロジェクトを選択します。
2. [IAM と管理] > [サービス アカウント] に移動します。
3. [サービス アカウントを作成] をクリックします。
4. 次の構成情報を指定します。
   • サービス アカウント名: アカウントの名前を入力します（例: bindplane-ingest）。
   • サービス アカウントの説明: 説明を入力します（例: Bindplane agent log ingestion）。
5. [作成して続行] をクリックします。
6. [このサービス アカウントにプロジェクトへのアクセスを許可する] セクションで、[ロールを選択] をクリックし、[Chronicle 編集者] を選択します。
7. [続行] をクリックして [完了] をクリックします。
8. 作成したサービス アカウントをクリックし、[キー] タブに移動します。
9. [鍵を追加] > [新しい鍵を作成] の順にクリックします。
10. [JSON] を選択し、[作成] をクリックします。鍵ファイルがパソコンにダウンロードされます。
11. 鍵ファイルを ingestion-auth.json として Bindplane コレクタ ディレクトリ（Linux の場合は /opt/observiq-otel-collector/ingestion-auth.json、Windows の場合は C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json）に保存するか、config.yaml の creds_file_path を更新して、保存先のパスと一致させます。
12. [IAM と管理] > [設定] に移動し、[プロジェクト番号] をコピーします。これはエクスポータの構成に必要です。

注: JSON キーは認証情報です。Bindplane ホスト上のファイルへのアクセスを制限し、組織のポリシーに従って鍵をローテーションします。

オプション 2: 取り込み認証ファイルをダウンロードする（以前のバージョン）

1. Google SecOps コンソールにログインします。
2. [SIEM 設定] > [収集エージェント] に移動します。
3. 取り込み認証ファイルをダウンロードします。
4. Bindplane エージェントがインストールされるシステムにファイルを安全に保存します。

注: このファイルは、エージェントを以前の Ingestion API（malachiteingestion-pa.googleapis.com）に対して認証します。この API は、2027 年 7 月 20 日にサポート終了が予定されています。その日までにオプション 1 に移行する予定です。

Google SecOps のお客様 ID を取得する

1. Google SecOps コンソールにログインします。
2. [SIEM 設定] > [プロファイル] に移動します。
3. [組織の詳細情報] セクションから [お客様 ID] をコピーして保存します。

Bindplane エージェントをインストールする

次の手順に沿って、Windows または Linux オペレーティング システムに Bindplane エージェントをインストールします。

Windows のインストール

1. 管理者としてコマンド プロンプトまたは PowerShell を開きます。

2. 次のコマンドを実行します。

   msiexec /i "[https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi](https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi)" /quiet
   

3. 次のコマンドを実行して、インストールの内容を確認します。

   sc query observiq-otel-collector
   

サービスが RUNNING と表示されます。

Linux へのインストール

1. root 権限または sudo 権限でターミナルを開きます。

2. 次のコマンドを実行します。

   sudo sh -c "$(curl -fsSlL [https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh](https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh))" install_unix.sh
   

3. 次のコマンドを実行して、インストールの内容を確認します。

   sudo systemctl status observiq-otel-collector
   

サービスが active (running) と表示されます。

その他のインストール リソース

その他のインストール オプションについては、Bindplane エージェントのインストール ガイドをご覧ください。

注: Chronicle API エクスポータの構成には、Bindplane コレクタ v1.106.0 以降が必要です。上記のコマンドを実行すると、最新リリースがインストールされます。既存のインストールを更新する場合は、構成を変更する前にコレクタをアップグレードします。

Syslog を取り込んで Google SecOps に送信するように Bindplane エージェントを構成する

構成ファイルを探す

• Linux: /opt/observiq-otel-collector/config.yaml
• Windows: C:\Program Files\observIQ OpenTelemetry Collector\config.yaml

構成ファイルを編集します。

• config.yaml の内容全体を次の構成に置き換えます。

  receivers:
    tcplog:
      listen_address: "0.0.0.0:514"
  
  exporters:
    chronicle/extrahop:
      protocol: https
      # Region of your instance, for example us, europe, asia-southeast1
      location: <LOCATION>
      # Project number of the Google Cloud project linked to the instance
      project: '<PROJECT_NUMBER>'
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<CUSTOMER_ID>'
      endpoint: chronicle.googleapis.com
      log_type: EXTRAHOP
      raw_log_field: body
      ingestion_labels:
  
  service:
    pipelines:
      logs/extrahop_to_chronicle:
        receivers:
          - tcplog
        exporters:
          - chronicle/extrahop
  

構成パラメータ

各プレースホルダを次のように置き換えます。

• <CUSTOMER_ID>: Google SecOps のお客様 ID。
• creds_file_path を、サービス アカウント キーファイル（オプション 1）が保存されたパスに更新します。
  • Linux: /opt/observiq-otel-collector/ingestion-auth.json
  • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
• <LOCATION> は、Google SecOps インスタンスのリージョン（us、europe、asia-southeast1 など）に置き換えます。エクスポーターは、chronicle.googleapis.com の先頭にこの値を付加します。完全なリストについては、リージョン エンドポイントをご覧ください。
• <PROJECT_NUMBER> は、[IAM と管理] > [設定] のプロジェクト番号に置き換えます。

以前の取り込み API エクスポータ

• オプション 2 の取り込み認証ファイルを使用する場合は、exporters ブロックを次のように置き換えます。creds_file_path を取り込み認証ファイルのパスに設定します。インスタンスが米国以外にある場合は、malachiteingestion-pa.googleapis.com をリージョン エンドポイント（europe-malachiteingestion-pa.googleapis.com など）に置き換えます。

  exporters:
    chronicle/extrahop:
      compression: gzip
      creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
      customer_id: '<CUSTOMER_ID>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: EXTRAHOP
      raw_log_field: body
      ingestion_labels:
  

注: このエクスポータは、2027 年 7 月 20 日に Ingestion API が廃止されると機能しなくなります。

Bindplane エージェントを再起動して変更を適用する

Linux で Bindplane エージェントを再起動するには:

1. 次のコマンドを実行します。

   sudo systemctl restart observiq-otel-collector
   

2. サービスが実行されていることを確認します。

   sudo systemctl status observiq-otel-collector
   

3. ログでエラーを確認します。

   sudo journalctl -u observiq-otel-collector -f
   

Windows で Bindplane エージェントを再起動するには:

1. 次のいずれかのオプションを選択します。

   • 管理者としてコマンド プロンプトまたは PowerShell を開きます。

   net stop observiq-otel-collector && net start observiq-otel-collector
   

   • サービス コンソール:
     1. Win+R キーを押し、「services.msc」と入力して Enter キーを押します。
     2. observIQ OpenTelemetry Collector を見つけます。
     3. 右クリックして [再起動] を選択します。

2. サービスが実行されていることを確認します。

   sc query observiq-otel-collector
   

3. ログでエラーを確認します。

   type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
   

ExtraHop Reveal(x) の syslog 転送を構成する

システム通知の syslog を構成する

1. ExtraHop の [Administration] 設定（https://<extrahop-hostname-or-IP-address>/admin）にログインします。
2. [ネットワーク設定] セクションで、[通知] をクリックします。
3. [Syslog] をクリックします。
4. 次の構成情報を指定します。
   • 宛先: Bindplane エージェント ホストの IP アドレスを入力します。
   • プロトコル: [TCP] を選択します。
   • ポート: Bindplane エージェントで構成されたポート番号を入力します（例: 514）。
5. [Test Settings]、[Save] の順にクリックします。

監査ログの syslog 転送を構成する

1. ExtraHop の [Administration] 設定で、[Status and Diagnostics] セクションに移動します。
2. [監査ログ] > [Syslog 設定を構成] をクリックします。
3. 次の構成情報を指定します。
   • 宛先: Bindplane エージェント ホストの IP アドレスを入力します。
   • プロトコル: [TCP] を選択します。
   • ポート: 「514」と入力します。
4. [Test Settings]、[Save] の順にクリックします。

省略可: RFC 準拠の syslog 形式を構成する

1. ExtraHop の [Administration] 設定で、[Running Config] > [Edit Config] をクリックします。

2. syslog_notification セクションに次のエントリを追加します。

   "rfc_compliant_format": "rfc5424"
   

3. [保存]、[変更を適用] の順にクリックします。

UDM マッピング テーブル

ログフィールド	UDM マッピング	ロジック
act	security_result.action_details	未加工ログ値のマッピング。
cat	metadata.product_event_type	未加工ログ値のマッピング。
deviceExternalId	metadata.product_log_id	未加工ログ値のマッピング。
dhost	target.hostname	未加工ログ値のマッピング。
dpt	target.port	未加工ログ値のマッピング。
dst	target.ip	未加工ログ値のマッピング。
duser	target.user.userid	未加工ログ値のマッピング。
msg	metadata.description	未加工ログ値のマッピング。
proto	network.ip_protocol	未加工ログ値のマッピング。
severity	security_result.severity	CEF の重大度の値に基づいてマッピングされます。
shost	principal.hostname	未加工ログ値のマッピング。
spt	principal.port	未加工ログ値のマッピング。
src	principal.ip	未加工ログ値のマッピング。
suser	principal.user.userid	未加工ログ値のマッピング。
なし	metadata.log_type	EXTRAHOP に設定します。
なし	metadata.product_name	Reveal(x) に設定します。
なし	metadata.vendor_name	ExtraHop に設定します。
tar_ip	event.idm.read_only_udm.target.ip と event.idm.read_only_udm.target.asset.ip	変更履歴からマッピング
tar_port	event.idm.read_only_udm.target.port	変更履歴からマッピング
extrahop_detail	event.idm.read_only_udm.additional.fields	変更履歴からマッピング
alert_value	event.idm.read_only_udm.security_result.detection_fields	変更履歴からマッピング
jsonPayload.target.ip	event.idm.read_only_udm.target.ip と event.idm.read_only_udm.target.asset.ip	変更履歴からマッピング
jsonPayload.principal.mac	event.idm.read_only_udm.principal.mac と event.idm.read_only_udm.principal.asset.mac	変更履歴からマッピング
jsonPayload.target.mac	event.idm.read_only_udm.target.mac と event.idm.read_only_udm.target.asset.mac	変更履歴からマッピング
jsonPayload.principal.hostname	event.idm.read_only_udm.principal.hostname と event.idm.read_only_udm.principal.asset.hostname	変更履歴からマッピング
jsonPayload.target.hostname	event.idm.read_only_udm.target.hostname と event.idm.read_only_udm.target.asset.hostname	変更履歴からマッピング
jsonPayload.vulnerability.cvss_vector	event.idm.read_only_udm.security_result.about.asset.vulnerabilities.cvss_vector	変更履歴からマッピング
suspicious_domain	event.idm.read_only_udm.target.hostname と event.idm.read_only_udm.target.asset.hostname	変更履歴からマッピング
reference	event.idm.read_only_udm.security_result.about.url	変更履歴からマッピング
sid	event.idm.read_only_udm.security_result.rule_id	変更履歴からマッピング
id	event.idm.read_only_udm.metadata.product_log_id	変更履歴からマッピング
description	event.idm.read_only_udm.metadata.description	変更履歴からマッピング
type	event.idm.read_only_udm.metadata.product_event_type	変更履歴からマッピング
start_time	event.idm.read_only_udm.metadata.event_timestamp と event.idm.read_only_udm.security_result.first_discovered_time	変更履歴からマッピング
update_time	event.idm.read_only_udm.security_result.last_updated_time	変更履歴からマッピング
end_time	event.idm.read_only_udm.security_result.last_discovered_time	変更履歴からマッピング
title	event.idm.read_only_udm.security_result.summary	変更履歴からマッピング
risk_score	event.idm.read_only_udm.security_result.risk_score	変更履歴からマッピング
categories	event.idm.read_only_udm.security_result.category_details	変更履歴からマッピング
participant.endpoint	event.idm.read_only_udm.principal.asset.category	変更履歴からマッピング
participant.object_id	event.idm.read_only_udm.principal.asset.product_object_id	変更履歴からマッピング
participant.object_value	event.idm.read_only_udm.principal.ip と event.idm.read_only_udm.principal.asset.ip	変更履歴からマッピング
participant.hostname	event.idm.read_only_udm.principal.hostname と event.idm.read_only_udm.principal.asset.hostname	変更履歴からマッピング
participant.username	event.idm.read_only_udm.principal.user.userid	変更履歴からマッピング
participant.endpoint	event.idm.read_only_udm.target.asset.category	変更履歴からマッピング
participant.object_id	event.idm.read_only_udm.target.asset.product_object_id	変更履歴からマッピング
participant.object_value	event.idm.read_only_udm.target.ip と event.idm.read_only_udm.target.asset.ip	変更履歴からマッピング
participant.hostname	event.idm.read_only_udm.target.hostname と event.idm.read_only_udm.target.asset.hostname	変更履歴からマッピング
participant.username	event.idm.read_only_udm.target.user.userid	変更履歴からマッピング
mitre_tactics.id	event.idm.read_only_udm.security_result.attack_details.tactics.id	変更履歴からマッピング
mitre_tactics.name	event.idm.read_only_udm.security_result.attack_details.tactics.name	変更履歴からマッピング
mitre_techniques.id	event.idm.read_only_udm.security_result.attack_details.techniques.id	変更履歴からマッピング
mitre_techniques.name	event.idm.read_only_udm.security_result.attack_details.techniques.name	変更履歴からマッピング
create_time	event.idm.read_only_udm.additional.fields	変更履歴からマッピング
url	event.idm.read_only_udm.url_back_to_product	変更履歴からマッピング
time	event.idm.read_only_udm.metadata.event_timestamp	変更履歴からマッピング
security_result.severity	CRITICAL	変更履歴からマッピング
security_result.severity	ERROR	変更履歴からマッピング
security_result.severity	HIGH	変更履歴からマッピング
security_result.severity	MEDIUM	変更履歴からマッピング
security_result.severity	LOW	変更履歴からマッピング
security_result.severity	INFORMATIONAL	変更履歴からマッピング
jsonPayload.msg	metadata.description	変更履歴からマッピング
jsonPayload.srcdata	principal.ip	変更履歴からマッピング
jsonPayload.dstdata	target.ip	変更履歴からマッピング
jsonPayload.dhost	target.hostname	変更履歴からマッピング
jsonPayload.shost	principal.hostname	変更履歴からマッピング
insertId	additional.fields	変更履歴からマッピング
jsonPayload.cn2	security_result.risk_score	変更履歴からマッピング
jsonPayload.name	security_result.summary	変更履歴からマッピング
jsonPayload.rt	metadata.event_timestamp	変更履歴からマッピング
jsonPayload.start", "jsonPayload.end" and "logName	additional.fields	変更履歴からマッピング
resource.labels.method" and "resource.labels.service	target.resource.attribute.labels	変更履歴からマッピング
jsonPayload.cat" and "jsonPayload.cs5	security_result.detection_fields	変更履歴からマッピング
dst	target.asset.ip	変更履歴からマッピング
url	principal.url	変更履歴からマッピング
title", "id", "description_format", "victims.name", "victims.external", "offenders.name", "offenders.externaal", "victim_primary.name", victim_primary.external", "offender_primary.name", and "offender_primary.external	additional.fields	変更履歴からマッピング
dst.type	target.resource_type	変更履歴からマッピング
dst.hostname	target.hostname	変更履歴からマッピング
dst.ipaddr	target.ip	変更履歴からマッピング
dst.role	target_resource.attribute.roles	変更履歴からマッピング
dst.device.macaddr	target.mac	変更履歴からマッピング
src.type	principal.resource_type	変更履歴からマッピング
src.hostname	principal.hostname	変更履歴からマッピング
src.ipaddr	principal.ip	変更履歴からマッピング
src.role	principal_resource.attribute.roles	変更履歴からマッピング
src.device.macaddr	principal.mac	変更履歴からマッピング
api.ip", "api.status", "api.id", "api.start_time", "api.mod_time", "api.categories", "api.update_time", and "api.ticket_id	security_result.detection_fields	変更履歴からマッピング
victims.ipaddr	principal.ip	変更履歴からマッピング
offenders.ipaddr	target.ip	変更履歴からマッピング
victim_primary.ipaddr	principal.ip	変更履歴からマッピング
offender_primary.ipaddr	target.ip	変更履歴からマッピング
api.participants.role", "api.participants.object_id", "api.participants.object_type", and "api.participants.external	section_details.fields	変更履歴からマッピング
risk_score" and "api.risk_score	security_result.risk_score	変更履歴からマッピング
src.endpoint" and "src.device.oid	principal.resource.attribute.labels	変更履歴からマッピング
dst.endpoint" and "dst.device.oid	target.resource.attribute.labels	変更履歴からマッピング
dst.device.ipaddr	target.ip	変更履歴からマッピング
src.device.ipaddr	principal.ip	変更履歴からマッピング
categories_array" and "categories_id	additional.fields	変更履歴からマッピング
src	principal.asset.ip	変更履歴からマッピング
device_version	metadata.product_version	変更履歴からマッピング
signature	security_result.summary	変更履歴からマッピング
events.vulnerability.description	metadata.description	変更履歴からマッピング
detectionID	security_result.rule_labels	変更履歴からマッピング
event_type	STATUS_UPDATE	変更履歴からマッピング
prin_url	principal.url	変更履歴からマッピング

変更ログ

このパーサーの変更ログを表示する

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。