Veridium ID ログを収集する

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

このドキュメントでは、Bindplane を使用して Veridium ID ログを Google Security Operations に取り込む方法について説明します。パーサーは、まず syslog メッセージからフィールドを抽出し、「log_identifier」に基づいて分類します。次に、条件ロジックとキーバリュー解析を使用して、抽出されたフィールドを統合データモデル(UDM)構造にマッピングし、ActionLog 形式と EventLog 形式の両方を処理します。

始める前に

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

  • Google SecOps インスタンス
  • Windows 2016 以降、または systemd を使用する Linux ホスト
  • プロキシの背後で実行している場合は、ファイアウォール ポートが開いていることを確認する
  • Veridium ID への特権アクセス

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
    

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
    

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

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

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

  1. 構成ファイルにアクセスします。
    • config.yaml ファイルを見つけます。通常、Linux では /etc/bindplane-agent/ ディレクトリに、Windows ではインストール ディレクトリにあります。
    • テキスト エディタ(nanovi、メモ帳など)を使用してファイルを開きます。
  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:
            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: 'VERIDIUM_ID'
            raw_log_field: body
            ingestion_labels:
    
    service:
        pipelines:
            logs/source0__chronicle_w_labels-0:
                receivers:
                    - udplog
                exporters:
                    - chronicle/chronicle_w_labels
    
    • 自社のインフラストラクチャでの必要性に応じて、ポートと IP アドレスを置き換えます。
    • <customer_id> は、実際の顧客 ID に置き換えます。
    • /path/to/ingestion-authentication-file.json の値を、Google SecOps の取り込み認証ファイルを取得するで認証ファイルを保存したパスに更新します。

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

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

    sudo systemctl restart bindplane-agent
    
  • Windows で Bindplane エージェントを再起動するには、Services コンソールを使用するか、次のコマンドを入力します。

    net stop BindPlaneAgent && net start BindPlaneAgent
    

Veridium ID の Syslog を構成する

  1. SSH または CLI を使用して Veridium ID ホストにログインします。
  2. VI を使用して /etc/rsyslog.conf ファイルまたは /etc/rsyslog.d/events.conf ファイルを編集します。

    vi /etc/rsyslog.conf
    
  3. 次の詳細情報を入力します。<bindplane-ip><bindplane-port> は実際の Bindplane エージェントの詳細に置き換えます。

    module(load="imfile" PollingInterval="10")
    input(type="imfile" File="/var/log/veridiumid/websecadmin/events.log" Tag="ver-adminevents" reopenOnTruncate="on")
    input(type="imfile" File="/var/log/veridiumid/tomcat/events.log" Tag="ver-events" reopenOnTruncate="on")
    
    if $programname == 'ver-events' then @@<bindplane-ip>:<bindplane-port>
    if $programname == 'ver-adminevents' then @@<bindplane-ip>:<bindplane-port>
    
  4. ファイルを保存して VI を終了します。

UDM マッピング テーブル

ログフィールド UDM マッピング 論理
_caller.accountId principal.user.userid _caller.accountId フィールドから直接マッピングされます。
_caller.accountEmailAddressInfo principal.user.email_addresses _caller.accountEmailAddressInfo フィールドから直接マッピングされます。
_caller.accountExternalId principal.user.email_addresses _caller.accountExternalId フィールドから直接マッピングされます。
_caller.accountStatus principal.user.attribute.labels[account_status].value _caller.accountStatus フィールドから直接マッピングされます。
_caller.deviceId principal.asset.asset_id 「VERIDIUM_ID:」の接頭辞が付いており、_caller.deviceId フィールドからマッピングされます。
_caller.deviceDescription principal.asset.attribute.labels[device_description].value _caller.deviceDescription フィールドから直接マッピングされます。
_caller.deviceManufacturer principal.asset.attribute.labels[device_manufacturer].value _caller.deviceManufacturer フィールドから直接マッピングされます。
_caller.deviceName principal.asset.attribute.labels[device_name].value _caller.deviceName フィールドから直接マッピングされます。
_caller.deviceOs principal.asset.platform_software.platform _caller.deviceOs フィールドからマッピングされます。値が「iOS」の場合、「IOS」にマッピングされます。値が「Android」の場合、「ANDROID」にマッピングされます。値が「WIN」または「Windows」の場合、「WINDOWS」にマッピングされます。
_caller.deviceStatus principal.asset.attribute.labels[device_status].value _caller.deviceStatus フィールドから直接マッピングされます。
_caller.deviceType principal.asset.attribute.labels[device_type].value _caller.deviceType フィールドから直接マッピングされます。
actionDate additional.fields[action_date].value.string_value actionDate フィールドから直接マッピングされます。
actionName metadata.product_event_type actionName フィールドから直接マッピングされます。
accountEmail principal.user.email_addresses accountEmail フィールドから直接マッピングされます。
accountExternalId principal.user.email_addresses accountExternalId フィールドから直接マッピングされます。
accountId principal.user.userid accountId フィールドから直接マッピングされます。
authenticatorDeviceContext.deviceMake intermediary.asset.hardware.manufacturer authenticatorDeviceContext.deviceMake フィールドから直接マッピングされます。
authenticatorDeviceContext.ip intermediary.ip authenticatorDeviceContext.ip フィールドから直接マッピングされます。
authenticatorDeviceContext.location.city intermediary.asset.location.city authenticatorDeviceContext.location.coordinates.latitude フィールドから直接マッピングされます。
authenticatorDeviceContext.location.coordinates.latitude intermediary.asset.location.region_latitude authenticatorDeviceContext.location.coordinates.latitude フィールドから直接マッピングされます。
authenticatorDeviceContext.location.coordinates.longitude intermediary.asset.location.region_longitude authenticatorDeviceContext.location.coordinates.longitude フィールドから直接マッピングされます。
authenticatorDeviceContext.location.countryName intermediary.asset.location.country_or_region authenticatorDeviceContext.location.countryName フィールドから直接マッピングされます。
authenticatorDeviceContext.location.ip intermediary.ip authenticatorDeviceContext.location.ip フィールドから直接マッピングされます。
authenticationDeviceDescription intermediary.asset.attribute.labels[authentication_device_description].value authenticationDeviceDescription フィールドから直接マッピングされます。
authenticationDeviceName intermediary.asset.asset_id 「VERIDIUM_ID:」の接頭辞が付いており、authenticationDeviceName フィールドからマッピングされます。
authenticationDeviceOs intermediary.asset.platform_software.platform authenticationDeviceOs フィールドからマッピングされます。値が「iOS」の場合、「IOS」にマッピングされます。値が「Android」の場合、「ANDROID」にマッピングされます。値が「WIN」または「Windows」の場合、「WINDOWS」にマッピングされます。
authenticationDeviceOsVersion intermediary.asset.platform_software.platform_version authenticationDeviceOsVersion フィールドから直接マッピングされます。
authenticationDevicePhone intermediary.asset.attribute.labels[authentication_device_phone].value authenticationDevicePhone フィールドから直接マッピングされます。
authenticationDevicePhoneModel intermediary.asset.attribute.labels[authentication_device_phone_model].value authenticationDevicePhoneModel フィールドから直接マッピングされます。
authenticationDeviceRegistrationTime intermediary.asset.attribute.labels[authentication_device_registeration_time].value authenticationDeviceRegistrationTime フィールドから直接マッピングされます。
authenticationDeviceType intermediary.asset.attribute.labels[authentication_device_type].value authenticationDeviceType フィールドから直接マッピングされます。
authenticationResult extensions.auth.auth_details authenticationResult フィールドから直接マッピングされます。
context.deviceMake principal.asset.hardware.manufacturer context.deviceMake フィールドから直接マッピングされます。
context.ip principal.ip context.ip フィールドから直接マッピングされます。
context.location.countryName principal.location.country_or_region context.location.countryName フィールドから直接マッピングされます。
context.location.ip principal.ip context.location.ip フィールドから直接マッピングされます。
context.osVersion principal.asset.platform_software.platform_version context.osVersion フィールドから直接マッピングされます。
context.userAgentRaw network.http.user_agent context.userAgentRaw フィールドから直接マッピングされます。
exploiterDeviceContext.deviceMake src.asset.hardware.manufacturer exploiterDeviceContext.deviceMake フィールドから直接マッピングされます。
exploiterDeviceContext.ip src.ip exploiterDeviceContext.ip フィールドから直接マッピングされます。
exploiterDeviceContext.location.city src.asset.location.city exploiterDeviceContext.location.city フィールドから直接マッピングされます。
exploiterDeviceContext.location.coordinates.latitude src.asset.location.region_latitude exploiterDeviceContext.location.coordinates.latitude フィールドから直接マッピングされます。
exploiterDeviceContext.location.coordinates.longitude src.asset.location.region_longitude exploiterDeviceContext.location.coordinates.longitude フィールドから直接マッピングされます。
exploiterDeviceContext.location.countryName src.asset.location.country_or_region exploiterDeviceContext.location.countryName フィールドから直接マッピングされます。
exploiterDeviceContext.location.ip src.ip exploiterDeviceContext.location.ip フィールドから直接マッピングされます。
exploiterDeviceContext.osName src.asset.platform_software.platform exploiterDeviceContext.osName フィールドからマッピングされます。値が「WIN」または「Windows」の場合、「WINDOWS」にマッピングされます。値が「iOS」の場合、「IOS」にマッピングされます。値が「Android」の場合、「ANDROID」にマッピングされます。
exploiterDeviceContext.osVersion src.asset.platform_software.platform_version exploiterDeviceContext.osVersion フィールドから直接マッピングされます。
exploiterDeviceName src.asset.attribute.labels[exploiter_device_name].value exploiterDeviceName フィールドから直接マッピングされます。
hostname principal.hostname hostname フィールドから直接マッピングされます。
ipAddress principal.ip ipAddress フィールドから直接マッピングされます。
location principal.location.city location フィールドから直接マッピングされます。
location.city about.location.city location.city フィールドから直接マッピングされます。
location.coordinates.latitude about.location.region_latitude location.coordinates.latitude フィールドから直接マッピングされます。
location.coordinates.longitude about.location.region_longitude location.coordinates.longitude フィールドから直接マッピングされます。
location.countryName about.location.country_or_region location.countryName フィールドから直接マッピングされます。
location.ip about.ip location.ip フィールドから直接マッピングされます。
metadata.collected_timestamp metadata.collected_timestamp collected_time フィールドから直接マッピングされます。
metadata.event_timestamp metadata.event_timestamp event_time フィールドから直接マッピングされます。
metadata.event_type metadata.event_type 「USER_UNCATEGORIZED」に設定されます。
metadata.product_event_type metadata.product_event_type actionName フィールドから直接マッピングされます。
metadata.product_name metadata.product_name 「VERIDIUM_ID」に設定します。
namespace principal.namespace namespace フィールドから直接マッピングされます。
pid principal.process.pid pid フィールドから直接マッピングされます。
request.context.userAgentRaw network.http.user_agent request.context.userAgentRaw フィールドから直接マッピングされます。
request.sessionId network.session_id request.sessionId フィールドから直接マッピングされます。
requestMethod network.http.method requestMethod フィールドから直接マッピングされます。
requestURI network.http.referral_url requestURI フィールドから直接マッピングされます。
security_result.severity security_result.severity severity フィールドからマッピングされます。値が「INFO」の場合、「INFORMATIONAL」にマッピングされます。
principal.application application フィールドから直接マッピングされます。
principal.asset.hostname hostname フィールドから直接マッピングされます。

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