Vectra Detect のログを収集する

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

このドキュメントでは、Bindplane エージェントを使用して Vectra Detect ログを Google Security Operations に取り込む方法について説明します。

Vectra Detect は、ホスト検出、キャンペーン イベント、監査イベント、ヘルス イベントの JSON 形式および CEF 形式の syslog メッセージを生成するネットワーク検出と対応（NDR）プラットフォームです。パーサーは、SYSLOG、JSON、CEF 形式からフィールドを抽出し、統合データモデル（UDM）にマッピングします。

始める前に

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

  • Google SecOps インスタンス
  • Windows Server 2016 以降、または systemd を使用する Linux ホスト
  • Bindplane エージェントと Vectra Detect アプライアンス間のネットワーク接続
  • プロキシの背後で実行している場合は、Bindplane エージェントの要件に従ってファイアウォール ポートが開いていることを確認します。
  • Vectra Detect UI への管理者権限

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

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

  • 新規デプロイ: Chronicle API を使用します（オプション 1）。
  • 以前のデプロイ: 2027 年 7 月 20 日に Ingestion API が廃止されるまで、取り込み認証ファイル（オプション 2）を引き続き使用します。
  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. 鍵ファイルを Bindplane コレクタ ディレクトリ（Linux の場合は /opt/observiq-otel-collector/ingestion-auth.json、Windows の場合は C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json）に ingestion-auth.json として保存するか、config.yaml の creds_file_path を保存先のパスと一致するように更新します。
  12. [IAM と管理] > [設定] に移動し、[プロジェクト番号] をコピーします。これはエクスポータの構成に必要です。

オプション 2: 取り込み認証ファイルをダウンロードする（レガシー）

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

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

  3. インストールが完了するまで待ちます。

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

    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)" install_unix.sh

  3. インストールが完了するまで待ちます。

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

    sudo systemctl status observiq-otel-collector

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

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

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

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

構成ファイルを探します。

  • Linux:

    sudo nano /opt/observiq-otel-collector/config.yaml

  • Windows:

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"

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

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

    receivers:
  udplog:
    listen_address: "0.0.0.0:514"

exporters:
  chronicle/vectra_detect:
    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: VECTRA_DETECT
    raw_log_field: body

service:
  pipelines:
    logs/vectra_detect_to_chronicle:
      receivers:
        - udplog
      exporters:
        - chronicle/vectra_detect

構成パラメータ

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

  • レシーバーの構成:

    • listen_address: リッスンする IP アドレスとポート:
      • 0.0.0.0: すべてのインターフェースでリッスンします（推奨）。
      • ポート 514 は標準の syslog ポートです（Linux で root が必要です。root 以外のユーザーは 1514 を使用します）。

  • エクスポータの構成:

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

以前の Ingestion API エクスポータ

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

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

構成ファイルを保存する

  • 編集が完了したら、ファイルを保存します。
    • Linux: Ctrl+O、Enter、Ctrl+X の順に押します。
    • Windows の場合: [ファイル] > [保存] をクリックします。

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

  • Linux で Bindplane エージェントを再起動するには、次のコマンドを実行します。

    sudo systemctl restart observiq-otel-collector

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

      sudo systemctl status observiq-otel-collector

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

      sudo journalctl -u observiq-otel-collector -f

  • Windows で Bindplane エージェントを再起動するには、次のいずれかのオプションを選択します。

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

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

    • サービス コンソール:

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

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

        sc query observiq-otel-collector

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

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

syslog を送信するように Vectra Detect を構成する

  1. Vectra Detect UI にログインします。
  2. [Settings] > [Notification] に移動します。
  3. [Syslog] セクションに移動します。
  4. [編集] をクリックして、syslog 構成を追加または編集します。
    • 宛先: Bindplane エージェントの IP アドレスを入力します。
    • ポート: Bindplane エージェントのポート番号を入力します。
    • プロトコル: Bindplane の構成に応じて、[UDP] または [TCP] を選択します。
    • 形式: [JSON] を選択します。
    • ログタイプ: Google SecOps に送信するログを選択します。
    • [Include Enhanced Details] チェックボックスをオンにします。
  5. 省略可: 右側の追加スイッチを構成します。
    • トリアージされた検出を含める: オフにすると、トリアージされた検出が作成または更新されたときに syslog メッセージが送信されなくなります。
    • 情報カテゴリの検出を含める: オフにすると、情報カテゴリの検出が作成または更新されたときに syslog メッセージが送信されません。
    • ホスト/アカウントのスコアの減少を含める: オフにすると、脅威スコアと確実性スコアの両方が減少しているか、同じままの場合、syslog メッセージは送信されません。
  6. [保存] をクリックします。
  7. [テスト] をクリックして構成をテストします。

UDM マッピング テーブル

ログフィールド UDM マッピング ロジック
action read_only_udm.security_result.action 監査イベントで [result] が「true」または「failure」の場合、「action」フィールドから取得された値。
category read_only_udm.security_result.category_details 「category」フィールドから取得された値。
certainty read_only_udm.security_result.confidence [certainty] が 0 ～ 35 の場合は、「LOW_CONFIDENCE」に設定します。[certainty] が 35 ～ 70 の場合は、「MEDIUM_CONFIDENCE」に設定します。[certainty] が 70 ～ 100 の場合は、「HIGH_CONFIDENCE」に設定します。
dd_bytes_rcvd read_only_udm.network.received_bytes 「dd_bytes_rcvd」フィールドから取得された値。
dd_bytes_sent read_only_udm.network.sent_bytes 「dd_bytes_sent」フィールドから取得された値。
dd_dst_dns read_only_udm.target.hostname 「dd_dst_dns」フィールドから取得された値。
dd_dst_dns read_only_udm.target.asset.hostname 「dd_dst_dns」フィールドから取得された値。
dd_dst_ip read_only_udm.target.asset.ip 「dd_dst_ip」フィールドから取得された値。
dd_dst_ip read_only_udm.target.ip 「dd_dst_ip」フィールドから取得された値。
dd_dst_port read_only_udm.target.port 「dd_dst_port」フィールドから取得された値。
detection_id read_only_udm.metadata.product_log_id 「detection_id」フィールドから取得された値。
detection_profile.name read_only_udm.security_result.detection_fields キーは「detection_profile name」、値は「detection_profile.name」フィールドから取得されます。
detection_profile.scoringDetections read_only_udm.security_result.detection_fields キーは「detectionprofile scoringDetections{index}」で、値は「detection_profile.scoringDetections」配列の各要素から取得されます。
detection_profile.vname read_only_udm.security_result.detection_fields キーは「detection_profile vname」で、値は「detection_profile.vname」フィールドから取得されます。
dest_ip read_only_udm.target.asset.ip Campaigns Events の「dest_ip」フィールドから取得された値。
dest_ip read_only_udm.target.ip キャンペーン イベントの「dest_ip」フィールドから取得された値。
dest_name read_only_udm.target.asset.hostname キャンペーン イベントの「dest_name」フィールドから取得された値。
dest_name read_only_udm.target.hostname キャンペーン イベントの「dest_name」フィールドから取得された値。
d_type read_only_udm.additional.fields キーは「d_type」で、値は「d_type」フィールドから取得されます。
d_type_vname read_only_udm.additional.fields キーは「d_type_vname」、値は「d_type_vname」フィールドから取得されます。
dvchost read_only_udm.observer.hostname 「dvchost」フィールドから取得された値。
dvchost read_only_udm.principal.asset.hostname HOST イベントで [host_name] が空の場合、「dvchost」フィールドから取得された値。
dvchost read_only_udm.principal.hostname HOST イベントで [host_name] が空の場合、「dvchost」フィールドから取得された値。
headend_addr read_only_udm.observer.ip 「headend_addr」フィールドから取得された値。
headend_addr read_only_udm.principal.asset.ip 検出イベントで [host_ip] が空の場合、「headend_addr」フィールドから取得された値。
headend_addr read_only_udm.principal.ip 検出イベントで [host_ip] が空の場合、「headend_addr」フィールドから取得された値。
href read_only_udm.target.url 「href」フィールドから取得された値。
host_id read_only_udm.target.asset_id HOST イベントの値は「VectraAI.DETECT:{host_id}」です。
host_ip read_only_udm.principal.asset.ip HOST イベントと Detections イベントの「host_ip」フィールドから取得された値。
host_ip read_only_udm.principal.ip HOST イベントと検出イベントの「host_ip」フィールドから取得された値。
host_name read_only_udm.principal.asset.hostname 「host_name」フィールドから取得された値。
host_name read_only_udm.principal.hostname 「host_name」フィールドから取得された値。
msg_data read_only_udm.security_result.summary 監査イベントとヘルスイベントの「msg_data」フィールドから取得された値。
quadrant read_only_udm.security_result.priority_details 「quadrant」フィールドから取得された値。
result read_only_udm.security_result.action [result] が「true」の場合は、「ALLOW」に設定します。[result] が「failure」の場合、監査イベントで「BLOCK」に設定されます。
result read_only_udm.security_result.detection_fields キーは「result」で、値は監査イベントとヘルスイベントの「result」フィールドから取得されます。
role read_only_udm.target.user.attribute.roles.name 監査イベントの「role」フィールドから取得された値。
severity read_only_udm.security_result.severity [threat] が 0 ～ 20 の場合は「INFORMATIONAL」に設定します。[threat] が 20 ～ 40 の場合は「LOW」に設定します。[脅威] が 40 ～ 60 の場合は、「MEDIUM」に設定します。[threat] が 60 ～ 80 の場合は「HIGH」に設定します。[threat] が 80 ～ 100 の場合は「CRITICAL」に設定します。
severity read_only_udm.security_result.severity_details 「severity」フィールドから取得された値。
source_ip read_only_udm.principal.asset.ip 監査イベントとヘルスイベントの「source_ip」フィールドから取得された値。
source_ip read_only_udm.principal.ip 監査イベントとヘルス イベントの「source_ip」フィールドから取得された値。
src read_only_udm.principal.asset.ip CEF イベントの「src」フィールドから取得された値。
src read_only_udm.principal.ip CEF イベントの「src」フィールドから取得された値。
src_ip read_only_udm.principal.asset.ip キャンペーン イベントの「src_ip」フィールドから取得された値。
src_ip read_only_udm.principal.ip キャンペーン イベントの「src_ip」フィールドから取得された値。
src_name read_only_udm.principal.asset.hostname [host_name] と [dvchost] が空の場合、「src_name」フィールドから値が取得されます。
src_name read_only_udm.principal.hostname [host_name] と [dvchost] が空の場合、「src_name」フィールドから値が取得されます。
threat read_only_udm.security_result.severity [threat] が 0 ～ 20 の場合は「INFORMATIONAL」に設定します。[脅威] が 20 ～ 40 の場合は、「LOW」に設定します。[threat] が 40 ～ 60 の場合は「MEDIUM」に設定します。[threat] が 60 ～ 80 の場合は「HIGH」に設定します。[threat] が 80 ～ 100 の場合は「CRITICAL」に設定します。
triaged read_only_udm.additional.fields キーは「triaged」で、値は「triaged」フィールドから取得されます。
type read_only_udm.metadata.product_event_type ヘルスイベントの「type」フィールドから取得された値。
user read_only_udm.target.user.userid 監査イベントの「user」フィールドから取得された値。
vectra_timestamp read_only_udm.metadata.event_timestamp 「vectra_timestamp」フィールドから取得された値。
version read_only_udm.metadata.product_version 「version」フィールドから取得された値。
read_only_udm.metadata.event_type [msg_data] に「log in」が含まれており、監査イベントで [user] が空でない場合は、「USER_LOGIN」に設定されます。
read_only_udm.metadata.event_type HOST イベントで「SCAN_HOST」に設定されます。
read_only_udm.metadata.event_type 検出イベントで [host_ip] が空でなく、[principal_present] が true、[target_present] が true の場合は、「NETWORK_HTTP」に設定します。
read_only_udm.metadata.event_type 検出イベントで [principal_present] が true の場合は、「STATUS_UPDATE」に設定します。
read_only_udm.metadata.event_type 検出イベントで [principal_present] が true で、[target_present] が true の場合、「NETWORK_CONNECTION」に設定されます。
read_only_udm.metadata.event_type [event_type] が「GENERIC_EVENT」、[principal_present] が true、[target_present] が true の場合は、「NETWORK_CONNECTION」に設定します。
read_only_udm.metadata.event_type [event_type] が「GENERIC_EVENT」で、[principal_present] が true の場合は、「STATUS_UPDATE」に設定します。
read_only_udm.metadata.log_type 「VECTRA_DETECT」に設定します。
read_only_udm.metadata.vendor_name 「Vectra.AI」に設定します。
read_only_udm.metadata.product_name 「DETECT」に設定します。
read_only_udm.network.application_protocol [dd_dst_port] が 80 の場合は「HTTP」に設定します。
read_only_udm.network.application_protocol [dd_dst_port] が 443 の場合は「HTTPS」に設定します。
read_only_udm.network.application_protocol 検出イベントで [principal_present] が true で [target_present] が true の場合は、「UNKNOWN_APPLICATION_PROTOCOL」に設定します。
read_only_udm.network.http.method 「METHOD_OTHER」に設定します。
read_only_udm.extensions.auth.type 監査イベントの [msg_data] に「log in」が含まれている場合は、「AUTHTYPE_UNSPECIFIED」に設定されます。
is_alert [triaged] が true の場合は「true」に設定します。
detection_id event.idm.read_only_udm.metadata.product_log_id 変更履歴からマッピング
id event.idm.read_only_udm.security_result.detection_fields 変更履歴からマッピング
entity_id event.idm.read_only_udm.security_result.detection_fields 変更履歴からマッピング
detail.event_id event.idm.read_only_udm.security_result.detection_fields 変更履歴からマッピング
detail.account_id event.idm.read_only_udm.security_result.detection_fields 変更履歴からマッピング
detail.dst_host.id event.idm.read_only_udm.security_result.detection_fields 変更履歴からマッピング
detail.dst_host.session_luid event.idm.read_only_udm.security_result.detection_fields 変更履歴からマッピング
detail.src_account.id event.idm.read_only_udm.security_result.detection_fields 変更履歴からマッピング
detection_type event.idm.read_only_udm.additional.fields 変更履歴からマッピング
entity_type event.idm.read_only_udm.additional.fields 変更履歴からマッピング
entity_uid event.idm.read_only_udm.additional.fields 変更履歴からマッピング
detail.event_name event.idm.read_only_udm.additional.fields 変更履歴からマッピング
detail.sensor.count event.idm.read_only_udm.additional.fields 変更履歴からマッピング
detail.count event.idm.read_only_udm.additional.fields 変更履歴からマッピング
detail.first_timestamp event.idm.read_only_udm.additional.fields 変更履歴からマッピング
detail.last_timestamp event.idm.read_only_udm.additional.fields 変更履歴からマッピング
detail.additional_details.client_name event.idm.read_only_udm.additional.fields 変更履歴からマッピング
detail.additional_details.cookie event.idm.read_only_udm.additional.fields 変更履歴からマッピング
detail.additional_details.encrypted event.idm.read_only_udm.additional.fields 変更履歴からマッピング
detail.additional_details.normal event.idm.read_only_udm.additional.fields 変更履歴からマッピング
phase1_bytes.sent event.idm.read_only_udm.additional.fields 変更履歴からマッピング
phase1_bytes.recv event.idm.read_only_udm.additional.fields 変更履歴からマッピング
phase2_bytes.sent event.idm.read_only_udm.additional.fields 変更履歴からマッピング
phase2_bytes.recv event.idm.read_only_udm.additional.fields 変更履歴からマッピング
breadth_contrib event.idm.read_only_udm.additional.fields 変更履歴からマッピング
entity_importance event.idm.read_only_udm.additional.fields 変更履歴からマッピング
importance event.idm.read_only_udm.additional.fields 変更履歴からマッピング
is_prioritized event.idm.read_only_udm.additional.fields 変更履歴からマッピング
urgency_score event.idm.read_only_udm.additional.fields 変更履歴からマッピング
velocity_contrib event.idm.read_only_udm.additional.fields 変更履歴からマッピング
attack_rating event.idm.read_only_udm.additional.fields 変更履歴からマッピング
active_detection_types event.idm.read_only_udm.additional.fields 変更履歴からマッピング
last_detection_type event.idm.read_only_udm.additional.fields 変更履歴からマッピング
last_detection_id event.idm.read_only_udm.additional.fields 変更履歴からマッピング
threat event.idm.read_only_udm.security_result.severity 変更履歴からマッピング
certainty event.idm.read_only_udm.security_result.confidence 変更履歴からマッピング
detection_href event.idm.read_only_udm.principal.url 変更履歴からマッピング
detail.src_host.ip event.idm.read_only_udm.principal.ip 変更履歴からマッピング
detail.src_host.name event.idm.read_only_udm.principal.hostname 変更履歴からマッピング
detail.dst_host.ip event.idm.read_only_udm.target.ip 変更履歴からマッピング
detail.dst_host.name event.idm.read_only_udm.target.hostname 変更履歴からマッピング
detail.src_account.name event.idm.read_only_udm.target.user.user_display_name 変更履歴からマッピング
detail.dst_account.id event.idm.read_only_udm.target.user.userid 変更履歴からマッピング
detail.dst_account.name event.idm.read_only_udm.target.user.user_display_name 変更履歴からマッピング
detail.sensor.name event.idm.read_only_udm.observer.hostname 変更履歴からマッピング
detail.dst_port event.idm.read_only_udm.target.port 変更履歴からマッピング
detail.additional_details.dst_ips event.idm.read_only_udm.target.port 変更履歴からマッピング
detail.bytes_received event.idm.read_only_udm.network.sent_bytes 変更履歴からマッピング
last_detection_url event.idm.read_only_udm.target.url 変更履歴からマッピング
detail.account_uid event.idm.read_only_udm.principal.user.email_addresses 変更履歴からマッピング
threat", "certainty", and "score_decreases additional.fields 変更履歴からマッピング
detection_profile.name", "detection_profile.vname", and "detection_profile.scoringDetections security_result.detection_fields 変更履歴からマッピング
msg.quadrant security_result.priority_details 変更履歴からマッピング
suser principal.user.email_addresses 変更履歴からマッピング
suser principal.user.userid 変更履歴からマッピング
message security_result.summary 変更履歴からマッピング
device_version metadata.product_version 変更履歴からマッピング
externalId metadata.product_log_id 変更履歴からマッピング
event_name" and "device_event_class_id metadata.product_event_type 変更履歴からマッピング
shost principal.hostname 変更履歴からマッピング
dhost target.hostname 変更履歴からマッピング
cs5 additional.fields 変更履歴からマッピング
cs4 metadata.target.url 変更履歴からマッピング
out network.sent_bytes 変更履歴からマッピング
dpt target.port 変更履歴からマッピング
proto network.ip_protocol 変更履歴からマッピング
href metadata.target.url 変更履歴からマッピング
account_uid additional.fields 変更履歴からマッピング

変更ログ

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

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