Forescout eyeSight ログを収集する

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

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

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

Forescout eyeSight は、IT、IoT、OT、IoMT デバイス全体でエージェントレスのデバイス可視化、分類、コンプライアンス評価を提供するネットワーク アクセス制御(NAC)プラットフォームです。接続されているすべてのデバイスをリアルタイムで検出してプロファイリングするため、組織はエンドポイント エージェントを必要とせずにアクセス ポリシーを適用し、攻撃対象領域を縮小できます。

詳細については、Forescout NAC のドキュメントをご覧ください。

始める前に

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

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

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. 鍵ファイルを 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 と管理] > [設定] に移動し、プロジェクト番号をコピーします。これはエクスポータの構成に必要です。

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

  1. Google SecOps コンソールにログインします。
  2. [設定] > [データ管理] > [収集エージェント] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [収集エージェント] に移動します。
  3. 取り込み認証ファイルをダウンロードします。
  4. Bindplane エージェントがインストールされるシステムにファイルを安全に保存します。

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

  1. Google SecOps コンソールにログインします。
  2. [Settings] > [Administration] > [Profile] に移動します。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/forescout_nac:
        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: FORESCOUT_NAC
        raw_log_field: body
        ingestion_labels:
          env: production
    
    service:
      pipelines:
        logs/forescout_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/forescout_nac
    

構成パラメータ

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

  • レシーバーの構成:

    • 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/forescout_nac:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<CUSTOMER_ID>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: FORESCOUT_NAC
        raw_log_field: body
        ingestion_labels:
          env: production
    

構成ファイルを保存する

  • 編集が完了したら、ファイルを保存します。
    • 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"
      

Forescout eyeSight syslog 転送を構成する

  1. 管理者アカウントで Forescout コンソールにログインします。
  2. [ツール] > [オプション] に移動します。
  3. [Options] ツリーで、[Modules] > [Syslog](またはバージョンに応じて [Syslog Plugin])を開きます。
  4. [Add] をクリックして、新しい syslog ターゲットを作成します。
  5. 次の構成情報を指定します。
    • [名前]: わかりやすい名前を入力します(例: SecOps-Bindplane)。
    • サーバー アドレス: Bindplane エージェント ホストの IP アドレスを入力します(例: 192.168.1.100)。
    • ポート: 514(または Bindplane エージェントで構成されたポート)を入力します。
    • プロトコル: [UDP] を選択します。
    • 形式: 解析要件に応じて、[CEF](Common Event Format)または [Syslog(RFC 3164)] を選択します。
    • Facility: LOCAL0(または組織の syslog ポリシーに一致するファシリティ)を選択します。
    • 重大度: [Informational] または目的の最小重大度レベルを選択します。
  6. [Event Types] セクションで、転送するログカテゴリを選択します。
    • ホスト プロパティの変更: デバイスの分類とプロパティの更新。
    • ポリシー違反: コンプライアンス ポリシー違反と NAC 違反措置。
    • ネットワーク アクセス イベント: エンドポイントの接続イベントと切断イベント。
    • 認証イベント: 802.1X とユーザー認証のイベント。
    • アクションの結果: 修復アクションと対応アクションの結果。
  7. [OK] をクリックして、syslog ターゲット構成を保存します。
  8. [適用] をクリックして、変更を適用します。
  9. Bindplane エージェント ログをチェックして、syslog メッセージが受信されていることを確認します。

UDM マッピング テーブル

ログフィールド UDM マッピング ロジック
about about 統合済み
deviceNtDomain about.administrative_domain 名前変更 / マッピング
deviceExternalId about.asset.asset_id 直接マッピングされます。
device_product about.asset.asset_id 直接マッピングされます。
device_vendor about.asset.asset_id 直接マッピングされます。
fileHash about.file.full_path 直接マッピングされます。
filePath about.file.full_path 名前変更 / マッピング
_hash about.file.sha256 名前変更 / マッピング
fileHash about.file.sha256 名前変更 / マッピング
fsize about.file.size 名前変更 / マッピング
dvchost about.hostname 名前変更 / マッピング
ips about.ip 統合済み
dvcmac about.mac 統合済み
mac_address about.mac 統合済み
deviceTranslatedAddress about.nat_ip 統合済み
Emne about.process.command_line 直接マッピングされます。
Path about.process.command_line 直接マッピングされます。
Subject about.process.command_line 直接マッピングされます。
deviceProcessName about.process.command_line 名前変更 / マッピング
dvcpid about.process.pid 名前変更 / マッピング
permissions about.resource.attribute.permissions 統合済み
Assigned_hosts_label additional.fields 統合済み
Available_memory_label additional.fields 統合済み
Available_swap_label additional.fields 統合済み
Connected_clients_label additional.fields 統合済み
EM_connection_status_label additional.fields 統合済み
Engine_status_label additional.fields 統合済み
Installed_Plugins_label additional.fields 統合済み
Used_memory_label additional.fields 統合済み
Used_swap_label additional.fields 統合済み
additional_cfp1 additional.fields 統合済み
additional_cfp2 additional.fields 統合済み
additional_cfp3 additional.fields 統合済み
additional_cfp4 additional.fields 統合済み
additional_cn1 additional.fields 統合済み
additional_cn2 additional.fields 統合済み
additional_cn3 additional.fields 統合済み
additional_cs1 additional.fields 統合済み
additional_cs2 additional.fields 統合済み
additional_cs3 additional.fields 統合済み
additional_cs4 additional.fields 統合済み
additional_cs5 additional.fields 統合済み
additional_cs6 additional.fields 統合済み
additional_cs7 additional.fields 統合済み
additional_devicePayloadId additional.fields 統合済み
additional_eventId additional.fields 統合済み
additional_flexString1 additional.fields 統合済み
additional_fname additional.fields 統合済み
application_status_label additional.fields 統合済み
cpu_usage_label additional.fields 統合済み
cs5_label additional.fields 統合済み
type_label additional.fields 統合済み
intermediary intermediary 統合済み
iporhost intermediary.asset.hostname 直接マッピングされます。
middle_ip intermediary.asset.ip 統合済み
iporhost intermediary.hostname 直接マッピングされます。
middle_ip intermediary.ip 統合済み
pid intermediary.process.pid 直接マッピングされます。
desc metadata.description 直接マッピングされます。
event_type metadata.description 直接マッピングされます。
msg metadata.description 名前変更 / マッピング
device_event_class_id metadata.product_event_type 直接マッピングされます。
engineName metadata.product_event_type 直接マッピングされます。
event_name metadata.product_event_type 直接マッピングされます。
eventtype metadata.product_event_type 直接マッピングされます。
externalId metadata.product_log_id 直接マッピングされます。
device_product metadata.product_name 直接マッピングされます。
product metadata.product_name 直接マッピングされます。
device_version metadata.product_version 直接マッピングされます。
device_vendor metadata.vendor_name 名前変更 / マッピング
vendor_name metadata.vendor_name 直接マッピングされます。
app_protocol_output network.application_protocol 直接マッピングされます。
mail_from network.email.from 直接マッピングされます。
mail_subject network.email.subject 統合済み
mail_to network.email.to 統合済み
requestMethod network.http.method 名前変更 / マッピング
requestClientApplication network.http.user_agent 名前変更 / マッピング
ip_protocol_out network.ip_protocol 直接マッピングされます。
protocol network.ip_protocol 直接マッピングされます。
protocol1 network.ip_protocol 直接マッピングされます。
in network.received_bytes 名前変更 / マッピング
out network.sent_bytes 名前変更 / マッピング
session_id network.session_id 直接マッピングされます。
sntdom principal.administrative_domain 名前変更 / マッピング
sourceServiceName principal.application 名前変更 / マッピング
Host principal.asset.hostname 直接マッピングされます。
Hostname principal.asset.hostname 直接マッピングされます。
Source principal.asset.hostname 直接マッピングされます。
Source_1 principal.asset.hostname 直接マッピングされます。
host_ip principal.asset.ip 統合済み
source_ip principal.asset.ip 統合済み
src_ip principal.asset.ip 統合済み
Group_name principal.group.group_display_name 直接マッピングされます。
Gruppenavn principal.group.group_display_name 直接マッピングされます。
Device_name principal.hostname 直接マッピングされます。
Enhetsnavn principal.hostname 直接マッピングされます。
Host principal.hostname 直接マッピングされます。
Hostname principal.hostname 直接マッピングされます。
Source principal.hostname 直接マッピングされます。
Source_1 principal.hostname 直接マッピングされます。
shost principal.hostname 名前変更 / マッピング
host_ip principal.ip 統合済み
principal_ip principal.ip 統合済み
shost principal.ip 統合済み
source_ip principal.ip 統合済み
src_ip principal.ip 統合済み
MAC principal.mac 統合済み
mac principal.mac 統合済み
mac_addr principal.mac 統合済み
src_mac principal.mac 統合済み
sourceTranslatedAddress principal.nat_ip 統合済み
sourceTranslatedPort principal.nat_port 名前変更 / マッピング
source_port principal.port 名前変更 / マッピング
spt principal.port 名前変更 / マッピング
src_port principal.port 直接マッピングされます。
command principal.process.command_line 直接マッピングされます。
sproc principal.process.command_line 名前変更 / マッピング
spid principal.process.pid 名前変更 / マッピング
resource principal.resource.name 直接マッピングされます。
principal_role principal.user.attribute.roles 統合済み
suser principal.user.user_display_name 直接マッピングされます。
User principal.user.userid 直接マッピングされます。
suid principal.user.userid 名前変更 / マッピング
user_id principal.user.userid 直接マッピングされます。
user_name principal.user.userid 直接マッピングされます。
username principal.user.userid 直接マッピングされます。
sec_result security_result 統合済み
security_result security_result 統合済み
res_label security_result.about.resource.attribute.labels 統合済み
_action security_result.action 統合済み
sec_action security_result.action 統合済み
security_result_action security_result.action 統合済み
Action_Taken security_result.action_details 直接マッピングされます。
act security_result.action_details 直接マッピングされます。
cat security_result.category_details 統合済み
Category security_result.description 直接マッピングされます。
Reason security_result.description 直接マッピングされます。
Scan_Type security_result.description 直接マッピングされます。
Type security_result.description 直接マッピングされます。
act security_result.description 直接マッピングされます。
description security_result.description 直接マッピングされます。
details security_result.description 直接マッピングされます。
et_lower security_result.description 直接マッピングされます。
event_type security_result.description 直接マッピングされます。
kv_data security_result.description 直接マッピングされます。
msg_data_2 security_result.description 直接マッピングされます。
policy_details security_result.description 直接マッピングされます。
rnmsg security_result.description 直接マッピングされます。
infection_channel_label security_result.detection_fields 統合済み
operasjon_label security_result.detection_fields 統合済み
operation_label security_result.detection_fields 統合済み
permission_label security_result.detection_fields 統合済み
protocol_label security_result.detection_fields 統合済み
spyware_Grayware_Type_label security_result.detection_fields 統合済み
threat_probability_label security_result.detection_fields 統合済み
tillatelse_label security_result.detection_fields 統合済み
Rule security_result.rule_id 直接マッピングされます。
alart_id security_result.rule_id 直接マッピングされます。
device_event_class_id security_result.rule_id 直接マッピングされます。
Match security_result.rule_name 直接マッピングされます。
mwProfile security_result.rule_name 直接マッピングされます。
severity security_result.severity_details 直接マッピングされます。
Result security_result.summary 直接マッピングされます。
appcategory security_result.summary 直接マッピングされます。
event_name security_result.summary 直接マッピングされます。
event_type security_result.summary 直接マッピングされます。
log_description security_result.summary 直接マッピングされます。
reason security_result.summary 名前変更 / マッピング
Spyware security_result.threat_name 直接マッピングされます。
Unknown_Threat security_result.threat_name 直接マッピングされます。
Virus_Malware_Name security_result.threat_name 直接マッピングされます。
threat security_result.threat_name 直接マッピングされます。
oldFilePath src.file.full_path 名前変更 / マッピング
oldFileSize src.file.size 名前変更 / マッピング
old_permissions src.resource.attribute.permissions 統合済み
dntdom target.administrative_domain 名前変更 / マッピング
destinationServiceName target.application 名前変更 / マッピング
Destination target.asset.hostname 直接マッピングされます。
Target target.asset.hostname 直接マッピングされます。
Target_1 target.asset.hostname 直接マッピングされます。
computer_name target.asset.hostname 直接マッピングされます。
Destination target.asset.ip 統合済み
dest_ip target.asset.ip 統合済み
destination_ip target.asset.ip 統合済み
target_ip target.asset.ip 統合済み
Destination target.hostname 直接マッピングされます。
Target target.hostname 直接マッピングされます。
Target_1 target.hostname 直接マッピングされます。
computer_name target.hostname 直接マッピングされます。
temp_dhost target.hostname 直接マッピングされます。
Destination target.ip 統合済み
IPv6_Address target.ip 統合済み
dest_ip target.ip 統合済み
destination_ip target.ip 統合済み
dst_ip target.ip 統合済み
target_ip target.ip 統合済み
dest_mac target.mac 統合済み
mac_address target.mac 統合済み
destination_translated_address target.nat_ip 統合済み
destinationTranslatedPort target.nat_port 名前変更 / マッピング
dest_port target.port 直接マッピングされます。
dpt target.port 名前変更 / マッピング
port target.port 名前変更 / マッピング
dproc target.process.command_line 名前変更 / マッピング
File_name target.process.file.full_path 直接マッピングされます。
Infected_Resource target.process.file.full_path 直接マッピングされます。
Object target.process.file.full_path 直接マッピングされます。
Objekt target.process.file.full_path 直接マッピングされます。
dpid target.process.pid 名前変更 / マッピング
resource_Type_label target.resource.attribute.labels 統合済み
request target.url 直接マッピングされます。
target_role target.user.attribute.roles 統合済み
CustomerName target.user.user_display_name 直接マッピングされます。
temp_duser target.user.user_display_name 直接マッピングされます。
Bruker target.user.userid 直接マッピングされます。
User_value target.user.userid 直接マッピングされます。
temp_duid target.user.userid 直接マッピングされます。
username target.user.userid 直接マッピングされます。
なし about 定数: about
なし about.ip 定数: ips
なし about.mac 定数: mac_address
なし about.nat_ip 定数: deviceTranslatedAddress
なし about.resource.attribute.permissions 定数: permissions
なし additional.fields 定数: additional_eventId
なし extensions.auth.type 定数: MACHINE
なし intermediary 定数: intermediary
なし intermediary.asset.ip 定数: middle_ip
なし intermediary.ip 定数: middle_ip
なし metadata.event_type 定数: USER_LOGIN
なし metadata.product_name 定数: FORESCOUT NAC
なし metadata.vendor_name 定数: FORESCOUT
なし network.direction 定数: INBOUND
なし network.email.subject 定数: mail_subject
なし network.email.to 定数: mail_to
なし principal.asset.ip 定数: source_ip
なし principal.ip 定数: principal_ip
なし principal.mac 定数: mac
なし principal.nat_ip 定数: sourceTranslatedAddress
なし principal.user.attribute.roles 定数: principal_role
なし security_result 定数: security_result
なし security_result.about.resource.attribute.labels 定数: res_label
なし security_result.action 定数: _action
なし security_result.alert_state 定数: ALERTING
なし security_result.category_details 定数: cat
なし security_result.detection_fields 定数: operation_label
なし security_result.rule_name 定数: Virtual Firewall blocking
なし security_result.severity 定数: LOW
なし src.resource.attribute.permissions 定数: old_permissions
なし target.asset.ip 定数: target_ip
なし target.ip 定数: dst_ip
なし target.mac 定数: mac_address
なし target.nat_ip 定数: destination_translated_address
なし target.resource.attribute.labels 定数: resource_Type_label
なし target.user.attribute.roles 定数: target_role
facility event.idm.read_only_udm.additional.fields 変更履歴からマッピング
priority event.idm.read_only_udm.security_result.priority_details 変更履歴からマッピング
appname event.idm.read_only_udm.metadata.product_name 変更履歴からマッピング
hostname event.idm.read_only_udm.principal.hostname と event.idm.read_only_udm.principal.asset.hostname 変更履歴からマッピング
proc_id event.idm.read_only_udm.principal.process.pid 変更履歴からマッピング
resource_name event.idm.read_only_udm.target.resource.name 変更履歴からマッピング
CPU usage", "Available memory", "Used memory", "Available swap", "Used swap", "Application status", "Connected Clients", "EM connection status", "Assigned hosts", "Engine status" and "Installed plugins additional.fields 変更履歴からマッピング

変更ログ

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

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