uberAgent ログを収集する

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

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

uberAgent は、Windows と macOS 向けのエンドポイント セキュリティ分析とユーザー エクスペリエンス モニタリング プラットフォームです。監視対象のエンドポイントで、プロセス イベント、ログオン イベント、ネットワーク接続、アプリケーションの使用状況などのテレメトリー データを収集します。

始める前に

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

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

Google SecOps の取り込み認証ファイルを取得する

  1. Google SecOps コンソールにログインします。
  2. [SIEM 設定] > [コレクション エージェント] に移動します。

  3. Ingestion Authentication File をダウンロードします。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

    サービスが [アクティブ（実行中）] と表示されます。

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

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

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

構成ファイルを探す

  • Linux:

    sudo nano /etc/bindplane-agent/config.yaml

  • Windows:

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

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

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

    receivers:
    filelog:
        include:
            - 'C:\uberAgent\logs\*.log'
            - 'C:\uberAgent\logs\*.csv'
        start_at: beginning
        poll_interval: 5s

exporters:
    chronicle/uberagent:
        compression: gzip
        creds_file_path: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: UBERAGENT
        raw_log_field: body
        ingestion_labels:
            env: production

service:
    pipelines:
        logs/uberagent_to_chronicle:
            receivers:
                - filelog
            exporters:
                - chronicle/uberagent

構成パラメータ

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

  • レシーバーの構成:

    • include: uberAgent ログファイルへのパス:
      • Windows（ローカル）: C:\uberAgent\logs\*.log と C:\uberAgent\logs\*.csv
      • Windows（ファイル共有）: \\SERVER\Share\uberagent-logs\*.log
      • uberAgent ファイル出力構成に基づいてパスを調整する
    • start_at: 既存のログを読み取る場合は beginning、新しいエントリのみを読み取る場合は end に設定します。
    • poll_interval: 新しいログデータのチェック頻度（デフォルト: 5s）

  • エクスポータの構成:

    • uberagent: エクスポータのわかりやすい名前
    • creds_file_path: 取り込み認証ファイルのフルパス:
      • Linux: /etc/bindplane-agent/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • <customer_id>: 前の手順の顧客 ID
    • endpoint: リージョナル エンドポイント URL:
      • 米国: malachiteingestion-pa.googleapis.com
      • ヨーロッパ: europe-malachiteingestion-pa.googleapis.com
      • アジア: asia-southeast1-malachiteingestion-pa.googleapis.com
      • 完全なリストについては、リージョン エンドポイントをご覧ください。
    • UBERAGENT: Chronicle に表示されるログタイプ
    • ingestion_labels: YAML 形式の省略可能なラベル（例: env: production）

  • パイプラインの構成:

    • uberagent_to_chronicle: パイプラインのわかりやすい名前

構成ファイルを保存する

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

uberAgent ファイル出力を構成する

uberAgent は複数の出力バックエンドをサポートしています。Bindplane エージェントで収集するファイルとしてデータをエクスポートするには:

  1. エンドポイントまたはグループ ポリシーで uberAgent 構成ファイル（uberAgent.conf）を開きます。

  2. ファイルベースの出力レシーバを構成します。

    [Receiver]
Name = FileOutput
Type = File
Path = C:\uberAgent\logs\

  3. エクスポートする指標とソースタイプを構成します。

    • プロセス: プロセスの開始/停止イベント、リソース使用量。
    • ログオン: ユーザーのログオン/ログオフ イベント。
    • ネットワーク: ネットワーク接続イベント。
    • アプリケーション: アプリケーションの使用状況とエラー。

  4. 構成を保存して、uberAgent サービスを再起動します。

  5. 構成された出力ディレクトリにログファイルが作成されていることを確認します。

  6. Bindplane エージェントにログ ディレクトリとファイルに対する読み取り権限があることを確認します。

UDM マッピング テーブル

ログフィールド UDM マッピング ロジック
SessionRpLatencyMs2、SessionHRes、SessionVRes、SessionColorDepth、SessionClientPlatform、SessionClientVersion、SessionClientOsLanguage、SessionPublishedName、SessionPublishedAppsCtx、SessionAppStateCtx、SessionEncryptionCtx、SessionClientTypeCtx、SessionBrokerDnsVmw、SessionBrokerUrlVmw、SessionBrokerTunneledVmw、SessionBrokerTunnelUrlVmw、SessionBrokerRemoteIpVmw、SessionBrokerUserVmw、SessionBrokerDomainVmw、SessionClientTimezoneVmw、SessionClientIdVmw、SessionTypeVmw、SessionBrokerType、SessionFgAppId、SessionFgAppVersion、SessionFgProcessName、SessionFgProcessId、SessionFgBrowserType、SessionFgBrowserActiveTabHost、SessionFgWindowTitle、SessionClientHwIdCtx2、SessionRoundTripTimeMs、SessionFps、SessionTransportProtocols、SessionProcessCount、SessionIOMB、SessionCPUTimeMs、SessionConnectionState、SessionUser、SessionIOCount、SessionNetKBPS、SessionWorkingSetMB、SessionCPUUsagePercent、SessionIOPS、SessionClientName、SessionIOLatencyMs、PowerSupportsS3、IsBatteryPresent、PowerSupportsS1、PowerSupportsS2、PowerSupportsS5、CPUMaxMhz、BaseboardSerial、CtxMachineCatalogName、AdDomainDns、HwHypervisorVendor、OsBuild、HwBiosVersion、PowerSupportsS4、HwIsVirtualMachine、IsUpsPresent、PowerSupportsConnectedStandby、OsInstallDate、Sourcetype、uberagent_index_name、data_stream.namespace、data_stream.dataset、data_stream.type、data_stream.subset、CPUCoresLogical、AdOu、AdDomainNetBios、logstash_pipeline、AdSite、CtxFarmName、CPUSockets、OsSpName、OsName、OsType、OsUpdateBuildRevision、ComputerNameCanonical、ComputerNameDn、CtxDeliveryGroupName、tags、user_agent.original additional.fields リストされたフィールドから Key-Value ペアとして統合
metadata.event_type has_principal が true で has_target が false の場合は STATUS_UPDATE、両方が true の場合は NETWORK_CONNECTION、それ以外の場合は GENERIC_EVENT に設定します。
SessionGUID metadata.product_log_id 値を直接コピー
user_agent.original network.http.parsed_user_agent 解析されたユーザー エージェントに変換されました
user_agent.original network.http.user_agent 値を直接コピー
SessionTransportProtocols network.ip_protocol (?i)udp と一致する場合は UDP に、(?i)tcp と一致する場合は TCP に設定します。
SessionID network.session_id 値を直接コピー
SessionClientUserDomain principal.administrative_domain 値を直接コピー
CPUCoresPhysical、RAMSizeGB、CPUName、HwManufacturer、OsArchitecture、BIOSSerial、HwModel principal.asset.hardware ハードウェア オブジェクトに統合されました
SessionClientDomain、host principal.asset.hostname 空でない場合は SessionClientDomain の値、それ以外の場合はホスト
prin_ip、SessionClientIp、system_ip principal.asset.ip prin_ip が空でない場合は prin_ip の値、それ以外の場合は SessionClientIp、それ以外の場合は system_ip
SessionClientDomain、host principal.hostname 空でない場合は SessionClientDomain の値、それ以外の場合はホスト
prin_ip、SessionClientIp、system_ip principal.ip prin_ip が空でない場合は prin_ip の値、それ以外の場合は SessionClientIp、それ以外の場合は system_ip
SessionClientMac principal.mac SessionClientMac の値（- を : に置き換え、小文字に変換）
SessionClientPlatform principal.platform (?i)windows に一致する場合は WINDOWS に設定
SessionClientVersion principal.platform_version (?i)windows と一致する場合に値を設定
SessionUser、SessionClientUser principal.user.user_display_name 空でない場合は SessionUser の値、空の場合は SessionClientUser
SessionBrokerRemoteIpVmw target.ip 値を直接コピー
SessionBrokerUserVmw target.user.user_display_name 値を直接コピー
SessionClientIdVmw target.user.userid 値を直接コピー
metadata.product_name 「UBERAGENT」に設定
metadata.vendor_name 「UBERAGENT」に設定

変更履歴

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

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