Imperva FlexProtect のログを収集する

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

Google SecOps SIEM

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

このパーサーは、Key-Value 拡張機能を使用して、CEF（Common Event Format）の Imperva FlexProtect syslog 形式のログからフィールドを抽出します。grok または kv を使用して CEF メッセージを解析し、これらの値を統合データモデル（UDM）にマッピングします。また、イベントソースとタイプにデフォルトのメタデータ値を設定します。Imperva FlexProtect は、ハイブリッド クラウド環境全体で Imperva セキュリティ ソリューション（SecureSphere、Cloud WAF、Bot Protection）を柔軟にデプロイできます。

始める前に

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

• Google SecOps インスタンス
• Windows 2016 以降または systemd を使用する Linux ホスト
• プロキシの背後で実行している場合は、Bindplane エージェントの要件に従ってファイアウォール ポートが開いていることを確認してください。
• Imperva FlexProtect 管理コンソールまたは個々のプロダクト コンソールへの特権アクセス

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

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

• 新しいデプロイ: Chronicle API（オプション 1）を使用します。
• 以前のデプロイ: Ingestion API が 2027 年 7 月 20 日に廃止されるまで、取り込み認証ファイル（オプション 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. キーファイルを 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 と管理][>][設定] に移動し、[プロジェクト番号] をコピーします。エクスポート構成に必要になります。

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

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
   

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

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

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

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

1. 構成ファイルにアクセスします。

   • config.yaml ファイルを見つけます。通常、Linux の場合は /opt/observiq-otel-collector/ ディレクトリ、Windows の場合はインストール ディレクトリにあります。
   • テキスト エディタ（nano、vi、メモ帳など）を使用してファイルを開きます。

2. config.yaml ファイルを次のように編集します。

   receivers:
     udplog:
       # Replace the port and IP address as required
       listen_address: "0.0.0.0:514"
   
   exporters:
     chronicle/chronicle_w_labels:
       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
       # Adjust the path to the credentials file you downloaded in Step 1
       creds_file_path: '/path/to/ingestion-authentication-file.json'
       # Replace with your actual customer ID from Step 2
       customer_id: <CUSTOMER_ID>
       endpoint: chronicle.googleapis.com
       # Add optional ingestion labels for better organization
       log_type: 'IMPERVA_FLEXPROTECT'
       raw_log_field: body
       ingestion_labels:
   
   service:
     pipelines:
       logs/source0__chronicle_w_labels-0:
         receivers:
           - udplog
         exporters:
           - chronicle/chronicle_w_labels
   

   • 自社のインフラストラクチャでの必要性に応じて、ポートと IP アドレスを置き換えます。
   • <LOCATION> は、Google SecOps インスタンスのリージョン（us、europe、asia-southeast1 など）に置き換えます。エクスポーターは、この値で chronicle.googleapis.com に接頭辞を付けます。
   • <PROJECT_NUMBER> は、[IAM と管理] > [設定] のプロジェクト番号に置き換えます。
   • <CUSTOMER_ID> は、実際の顧客 ID に置き換えます。
   • ステップ 1 でサービス アカウント キーファイル（オプション 1）を保存したファイルパスに /path/to/ingestion-authentication-file.json を更新します。

レガシー Ingestion API エクスポーター

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

  exporters:
    chronicle/chronicle_w_labels:
      compression: gzip
      # Adjust the path to the credentials file you downloaded in Step 1
      creds_file_path: '/path/to/ingestion-authentication-file.json'
      # Replace with your actual customer ID from Step 2
      customer_id: <CUSTOMER_ID>
      endpoint: malachiteingestion-pa.googleapis.com
      # Add optional ingestion labels for better organization
      log_type: 'IMPERVA_FLEXPROTECT'
      raw_log_field: body
      ingestion_labels:
  

注: このエクスポーターは、Ingestion API が 2027 年 7 月 20 日に廃止されると動作を停止します。

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

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

   sudo systemctl restart observiq-otel-collector
   

2. Windows で Bindplane エージェントを再起動するには、Services コンソールを使用するか、次のコマンドを入力します。

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

Imperva FlexProtect で Syslog 転送を構成する

SecureSphere コンポーネントの場合（オンプレミス/クラウド）

1. Imperva SecureSphere Management Console にログインします。
2. [構成] [>] [アクションセット] に移動します。
3. [追加] をクリックして新しいアクションセットを作成します。

4. [アクションを追加] をクリックし、次の構成情報を指定します。

   • 名前: わかりやすい名前を入力します（例: Google SecOps Syslog）。
   • アクションタイプ: [Syslog] を選択します。
   • ホスト: Bindplane エージェントの IP アドレスを入力します。
   • ポート: Bindplane エージェントのポート番号を入力します（デフォルトは 514）。
   • [Protocol]: [UDP] または [TCP] を選択します。
   • Syslog ログレベル: [DEBUG] を選択します。
   • Syslog Facility: [LOCAL0] を選択します。
   • 形式: [CEF]（Common Event Format）を選択します。

5. アクション構成を保存し、関連するセキュリティ ポリシーに適用します。

Cloud WAF/Incapsula コンポーネントの場合

1. Imperva Cloud Console にログインします。
2. [ログ] >[ログの設定] に移動します。
3. Syslog の宛先を構成します。
   • ホスト: Bindplane エージェントの IP アドレスを入力します。
   • ポート: Bindplane エージェントのポート番号を入力します（デフォルトは 514）。
   • [Protocol]: [UDP] または [TCP] を選択します。
   • 形式: [CEF] を選択します。

UDM マッピング テーブル

ログフィールド	UDM マッピング	論理
act	read_only_udm.security_result.action_details	act フィールドから直接マッピングされます。
app	read_only_udm.network.application_protocol	app フィールドから直接マッピングされます。
ccode	read_only_udm.principal.location.country_or_region	ccode フィールドから直接マッピングされます。
cicode	read_only_udm.principal.location.city	cicode フィールドから直接マッピングされます。
cn1	read_only_udm.network.http.response_code	整数に変換した後、cn1 フィールドから直接マッピングされます。
cs1	read_only_udm.additional.fields.value.string_value	cs1 フィールドから直接マッピングされます。
cs2	read_only_udm.additional.fields.value.string_value	cs2 フィールドから直接マッピングされます。
cs3	read_only_udm.additional.fields.value.string_value	cs3 フィールドから直接マッピングされます。
cs4	read_only_udm.additional.fields.value.string_value	cs4 フィールドから直接マッピングされます。
cs5	read_only_udm.additional.fields.value.string_value	cs5 フィールドから直接マッピングされます。
cs6	read_only_udm.additional.fields.value.string_value	cs6 フィールドから直接マッピングされます。
cs7	read_only_udm.additional.fields.value.string_value	cs7 フィールドから直接マッピングされます。
cs8	read_only_udm.additional.fields.value.string_value	cs8 フィールドから直接マッピングされます。
cs9	read_only_udm.additional.fields.value.string_value	cs9 フィールドから直接マッピングされます。
cpt	read_only_udm.principal.port	整数に変換した後、cpt フィールドから直接マッピングされます。
顧客	read_only_udm.principal.user.user_display_name	Customer フィールドから直接マッピングされます。
deviceExternalId	read_only_udm.about.asset.asset_id	値は、「Incapsula.SIEMintegration:」と deviceExternalId フィールドを連結して導出されます。
deviceFacility	read_only_udm.principal.location.city	deviceFacility フィールドから直接マッピングされます。
dproc	read_only_udm.target.process.command_line	dproc フィールドから直接マッピングされます。
end	read_only_udm.security_result.detection_fields.value	end フィールドから直接マッピングされます。
fileId	read_only_udm.network.session_id	fileId フィールドから直接マッピングされます。
filePermission	read_only_udm.about.resource.attribute.permissions.name	filePermission フィールドから直接マッピングされます。
in	read_only_udm.network.received_bytes	in フィールドから直接マッピングされます。
qstr	read_only_udm.security_result.detection_fields.value	qstr フィールドから直接マッピングされます。
リクエスト	read_only_udm.target.url	request フィールドから直接マッピングされます。
requestClientApplication	read_only_udm.network.http.user_agent	requestClientApplication フィールドから直接マッピングされます。
requestMethod	read_only_udm.network.http.method	requestMethod フィールドから直接マッピングされます。
siteid	read_only_udm.security_result.detection_fields.value	siteid フィールドから直接マッピングされます。
sip	read_only_udm.target.ip	sip フィールドから直接マッピングされます。
sourceServiceName	read_only_udm.principal.application	sourceServiceName フィールドから直接マッピングされます。
spt	read_only_udm.target.port	整数に変換した後、spt フィールドから直接マッピングされます。
src	read_only_udm.principal.ip	src フィールドから直接マッピングされます。
start	read_only_udm.security_result.detection_fields.value	start フィールドから直接マッピングされます。
suid	read_only_udm.principal.user.userid	suid フィールドから直接マッピングされます。
ver	read_only_udm.network.tls.version	ver フィールドから直接マッピングされます。
	read_only_udm.about.asset.asset_id	値は、「Incapsula.SIEMintegration:」と deviceExternalId フィールドを連結して導出されます。
	read_only_udm.additional.fields.key	値は、フィールドのラベルに基づいてパーサーのロジックによって決定されます。例: - cs1Label は「Cap Support」にマッピングされます。 - cs2Label は「Javascript Support」にマッピングされます。 - cs3Label は「CO Support」にマッピングされます。 - cs4Label は「VID」にマッピングされます。 - cs5Label は「clappsig」にマッピングされます。 - cs6Label は「clapp」にマッピングされます。 - cs7Label は「latitude」にマッピングされます。 - cs8Label は「longitude」にマッピングされます。 - cs9Label は「Rule name」にマッピングされます。
	read_only_udm.metadata.event_timestamp.nanos	collection_time.nanos フィールドから直接マッピングされます。
	read_only_udm.metadata.event_timestamp.seconds	collection_time.seconds フィールドから直接マッピングされます。
	read_only_udm.metadata.event_type	値は、src フィールドと sip フィールドの有無に基づいて決定されます。 - 両方が存在する場合は、「NETWORK_HTTP」に設定されます。 - src のみが存在する場合は、「USER_UNCATEGORIZED」に設定されます。 - それ以外の場合は、「GENERIC_EVENT」に設定されます。
	read_only_udm.metadata.product_event_type	値は、「[」と、インデックス 4 の CEF ヘッダー フィールドの数値、「] - 」と、インデックス 4 の CEF ヘッダー フィールドのテキスト説明を連結して導出されます。
	read_only_udm.metadata.product_name	値は静的に「SIEMintegration」に設定されます。
	read_only_udm.metadata.product_version	値は静的に「1」に設定されます。
	read_only_udm.metadata.vendor_name	値は静的に「Incapsula」に設定されます。
	read_only_udm.security_result.detection_fields.key	値は、処理される対応するフィールドに基づいて、「siteid」、「event_start_time」、「event_end_time」、「qstr」のいずれかに静的に設定されます。
	read_only_udm.security_result.severity	値は静的に「LOW」に設定されます。
	read_only_udm.target.port	整数に変換した後、spt フィールドから直接マッピングされます。
qstr	security_results.detection_fields	変更履歴からマッピング
siteid	security_results.detection_fields	変更履歴からマッピング
device_facility	principal.location.city	変更履歴からマッピング
start	security_result.detection_fields.event_start_time	変更履歴からマッピング
cs8Label	additional_cs8.key	変更履歴からマッピング
cs8	additional_cs8.value.string_value	変更履歴からマッピング
cs9Label	additional_cs9.key	変更履歴からマッピング
cs9	additional_cs9.value.string_value	変更履歴からマッピング
end	security_result.detection_fields.event_end_time	変更履歴からマッピング

変更ログ

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

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