Carbon Black App Control（旧称 CB Protection）のログを収集する

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

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

Google SecOps SIEM

このドキュメントでは、Bindplane を使用して Carbon Black App Control（以前は CB Protection と呼ばれていましたが、現在は Broadcom の一部）のログを Google Security Operations に取り込む方法について説明します。パーサーは CEF 形式と JSON 形式の両方をサポートしています。まず、入力を JSON として解析しようとします。解析に失敗すると、入力を CEF として扱い、テキスト置換を実行し、CEF フィールドを抽出して UDM にマッピングし、イベントタイプを GENERIC_EVENT に設定します。

Carbon Black App Control は、組織がサーバーや重要なシステムをロックダウンできるようにするアプリケーション制御およびホワイトリスト登録ソリューションです。信頼ベースのポリシーを適用し、ファイルの整合性の変更をモニタリングし、エンドポイント アクティビティをリアルタイムで可視化することで、不正なソフトウェアや悪意のあるソフトウェアの実行を防止します。

始める前に

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

• Google SecOps インスタンス。
• systemd を使用する Windows Server 2016 以降または Linux ホスト。
• プロキシの背後で実行している場合は、ファイアウォールのポートが開いていることを確認します。
• Carbon Black App Control Server バージョン 8.x 以降。
• Carbon Black App Control コンソールへの特権アクセス（管理者アカウント）。

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. 鍵ファイルを 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 の場合は /observiq-otel-collector/ ディレクトリに、Windows の場合はインストール ディレクトリにあります。
   • テキスト エディタ（nano、vi、メモ帳など）を使用してファイルを開きます。

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

   receivers:
     tcplog:
       # 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: CB_APP_CONTROL
       raw_log_field: body
       ingestion_labels:
   
   service:
     pipelines:
       logs/source0__chronicle_w_labels-0:
         receivers:
           - tcplog
         exporters:
           - chronicle/chronicle_w_labels
   

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

以前の取り込み 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: CB_APP_CONTROL
      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"
   

Carbon Black App Control の syslog 転送を構成する

1. 管理者アカウントで Carbon Black App Control コンソールにログインします。
2. 設定（歯車）アイコンをクリックし、[システム構成] をクリックします。
3. [System Configuration] ページで、[Events] タブをクリックします。
4. ページの下部にある [編集] ボタンをクリックします。
5. [External Event Logging] パネルで、[Syslog Enabled] チェックボックスをオンにします。
6. 次の構成情報を指定します。
   • Syslog アドレス: Bindplane エージェント ホストの IP アドレスまたは FQDN を入力します（例: 192.168.1.100）。
   • Syslog ポート: 514（または Bindplane で構成されたポート）を入力します。
   • Syslog Format: [Syslog Format] メニューから出力形式を選択します。
     • CEF（ArcSight）- Google SecOps の取り込みに推奨されます。
     • 拡張（RFC 5424） - v6.0.1 以降の新規インストールのデフォルト。
     • Basic（RFC 3164） - 6.0.1 より前のバージョンからのアップグレードのデフォルト。
     • LEEF（Q1 Labs）- QRadar との統合用。

7. [更新] をクリックし、確認ダイアログ ボックスで [はい] をクリックします。

   注: サポートされている syslog 形式とイベント マッピングの詳細については、Carbon Black App Control のドキュメントをご覧ください。

UDM マッピング テーブル

ログフィールド	UDM マッピング	ロジック
ABId	principal.asset.asset_id	JSON ログの ABId は、PRODUCT_SPECIFIC_ID:{ABId}-{Bit9Server} 形式のアセット ID の一部として使用されます。
Bit9Server	principal.asset.asset_id	プリンシパルのアセット ID の一部として使用され、ABId と組み合わされます。metadata.url_back_to_product フィールドの作成にも使用されます。
CommandLine	about.process.command_line	直接マッピングされます。
EventType	metadata.product_event_type	対応する EventTypeId を角かっこで囲んでマッピングします（例: [5] - Discovery）。
EventTypeId	metadata.product_event_type	EventType とともに使用して metadata.product_event_type に値を設定します。
EventSubType	metadata.description	metadata.description フィールドに追加されます。
EventSubTypeId	metadata.description	明示的にマッピングされていませんが、パーサーの内部ロジックに基づいて説明に貢献する可能性があります。
externalId	metadata.product_log_id	直接マッピングされます。
FileHash	about.file.sha256	直接マッピングされます。
FileName	additional.fields（キー FileName を含む）	追加フィールドとして追加されました。一部のイベントの metadata.description のファイル情報の一部としても使用されます。
FilePath	about.file.full_path	直接マッピングされます。
FileThreat	additional.fields（キー fileThreat を含む）	追加フィールドとして追加されました。
FileTrust	additional.fields（キー fileTrust を含む）	追加フィールドとして追加されました。
HostId	principal.asset.asset_id	metadata.url_back_to_product の商品に戻る URL を作成するために使用されます。
HostName	target.hostname	直接マッピングされます。
HostIP	target.ip	直接マッピングされます。
Message	metadata.description	直接マッピングされます。
PathName	about.file.full_path	直接マッピングされます。
Platform	target.platform	列挙値 WINDOWS にマッピングされます。
Policy	additional.fields（キー Policy を含む）	追加フィールドとして追加されました。
PolicyId	additional.fields（キー PolicyId を含む）	追加フィールドとして追加されました。
ProcessKey	additional.fields（キー ProcessKey を含む）	追加フィールドとして追加されました。
ProcessPath	about.process.command_line	直接マッピングされます。
ProcessPathName	about.process.command_line	直接マッピングされます。
ProcessThreat	additional.fields（キー ProcessThreat を含む）	追加フィールドとして追加されました。
ProcessTrust	additional.fields（キー ProcessTrust を含む）	追加フィールドとして追加されました。
RuleName	additional.fields（キー ruleName を含む）	追加フィールドとして追加されました。
Timestamp	metadata.event_timestamp	直接マッピングされます。
UserName	target.user.user_display_name	直接マッピングされます。
UserSid	principal.user.userid	直接マッピングされます。
agent.ephemeral_id	observer.labels（キー ephemeral_id を含む）	オブザーバー ラベルとして追加されます。
agent.name	principal.hostname、observer.hostname、observer.user.userid	複数のフィールドにマッピングされます。
agent.type	observer.application	直接マッピングされます。
agent.version	metadata.product_version	JSON ログに直接マッピングされます。CEF ログの場合、CEF メッセージから抽出されます。
cat	security_result.category_details	直接マッピングされます。
process	event.idm.read_only_udm.principal.file.full_path	変更履歴からマッピング
text	event.idm.read_only_udm.metadata.description	変更履歴からマッピング
type	event.idm.read_only_udm.security_result.category_details	変更履歴からマッピング
subtype	event.idm.read_only_udm.security_result.category_details	変更履歴からマッピング
hostname	event.idm.read_only_udm.principal.hostname と event.idm.read_only_udm.principal.asset.hostname	変更履歴からマッピング
username	event.idm.read_only_udm.target.user.userid	変更履歴からマッピング
date	event.idm.read_only_udm.metadata.collected_timestamp	変更履歴からマッピング
ip_address	event.idm.read_only_udm.principal.ip と event.idm.read_only_udm.principal.asset.ip	変更履歴からマッピング
file_path	event.idm.read_only_udm.target.file.full_path	変更履歴からマッピング
file_name	event.idm.read_only_udm.target.process.file.names	変更履歴からマッピング
file_hash	event.idm.read_only_udm.target.file.sha256	変更履歴からマッピング
policy	event.idm.read_only_udm.security_result.rule_name	変更履歴からマッピング
server_version	event.idm.read_only_udm.metadata.product_version	変更履歴からマッピング
file_trust	event.idm.read_only_udm.security_result.about.labels	変更履歴からマッピング
file_threat	event.idm.read_only_udm.security_result.about.labels	変更履歴からマッピング

変更ログ

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

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