BeyondTrust Secure Remote Access（以前の BeyondTrust Privileged Remote Access）のログを収集する

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

このドキュメントでは、Bindplane を使用して BeyondTrust Secure Remote Access（旧称 BeyondTrust Privileged Remote Access）のログを Google Security Operations に取り込む方法について説明します。

BeyondTrust Secure Remote Access は、重要なシステムに接続するベンダー、請負業者、内部管理者の特権リモート アクセスを組織が制御、監視、監査できるようにする特権アクセス管理ソリューションです。認証情報の挿入、ジャストインタイム アクセス、セッションの記録が可能です。BeyondTrust Secure Remote Access は、セッション アクティビティ、認証イベント、管理アクションを syslog 経由でログに記録します。

始める前に

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

  • Google SecOps インスタンス。
  • Windows 2016 以降、または systemd を使用する Linux ホスト。
  • プロキシの背後で実行している場合は、Bindplane エージェントの要件に従ってファイアウォール ポートが開いていることを確認します。
  • BeyondTrust Secure Remote Access B Series Appliance インターフェース（/appliance）への管理者アクセス権。

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. [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 の場合は /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: <your_customer_id>
    endpoint: chronicle.googleapis.com
    # Add optional ingestion labels for better organization
    log_type: 'BEYONDTRUST_REMOTE_ACCESS'
    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 と管理>設定] のプロジェクト番号に置き換えます。
  • <your_customer_id> は、実際のお客様 ID に置き換えます。

  • /path/to/ingestion-authentication-file.json を、手順 1 でサービス アカウント キー ファイル（オプション 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: <your_customer_id>
    endpoint: malachiteingestion-pa.googleapis.com
    # Add optional ingestion labels for better organization
    log_type: 'BEYONDTRUST_REMOTE_ACCESS'
    raw_log_field: body
    ingestion_labels:

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"

BeyondTrust Secure Remote Access の syslog 転送を構成する

  1. BeyondTrust Secure Remote Access B Series Appliance インターフェース（/appliance）にログインします。
  2. [セキュリティ] > [アプライアンス管理] に移動します。
  3. [Syslog] セクションまで下にスクロールします。
  4. [リモート Syslog サーバー] フィールドに、Bindplane エージェント ホストのホスト名または IP アドレス（192.168.1.100 など）を入力します。
  5. イベント通知メッセージの [メッセージ形式] を選択します。
    • RFC 5424 - 構造化データを含む最新の syslog 標準（推奨）。
    • BSD（従来型） - 従来の BSD syslog 形式（RFC 3164）。
    • TLS 経由の Syslog - TCP ポート 6514 を使用して暗号化された Syslog。
  6. 必要に応じて、デフォルトのポートを変更します。
    • RFC 5424 形式と BSD 形式のデフォルトは UDP 514 です。
    • Syslog over TLS のデフォルトは TCP 6514 です。

  7. [保存] をクリックします。

syslog の配信を確認する

  1. syslog 転送を構成したら、テスト サポート セッションを開始するか、/login 管理インターフェースにログインします。

  2. Bindplane エージェント ホストで、ログが受信されていることを確認します。

    sudo journalctl -u observiq-otel-collector -f

詳細については、BeyondTrust Privileged Remote Access syslog のドキュメントをご覧ください。

UDM マッピング テーブル

ログフィールド UDM マッピング ロジック
_field additional.fields 統合済み
additional_device_product additional.fields 統合済み
additional_device_vendor additional.fields 統合済み
additional_dst_priv additional.fields 統合済み
additional_event_name additional.fields 統合済み
additional_external_key_label additional.fields 統合済み
additional_jumpGroupId additional.fields 統合済み
additional_jumpGroupName additional.fields 統合済み
additional_jumpGroupType additional.fields 統合済み
additional_jumpointId additional.fields 統合済み
additional_jumpointName additional.fields 統合済み
additional_segment_number additional.fields 統合済み
additional_site_id additional.fields 統合済み
additional_total_segments additional.fields 統合済み
appliance_identifier_label additional.fields 統合済み
appliance_label additional.fields 統合済み
eventid_label additional.fields 統合済み
eventsubject_label additional.fields 統合済み
eventtype_label additional.fields 統合済み
format_version_label additional.fields 統合済み
nvps_actiontype_label additional.fields 統合済み
nvps_authenticationtype_label additional.fields 統合済み
nvps_createdate_label additional.fields 統合済み
nvps_eventseverity_label additional.fields 統合済み
nvps_subjectdescription_label additional.fields 統合済み
product_label additional.fields 統合済み
eventName extensions.auth.auth_details 直接マッピングされます。
mechanism extensions.auth.mechanism 統合済み
target extensions.auth.type マッピング: "rep_client", "web/login" → MACHINE、"rep_client", "web/login" → SSO、`rep_c...
intermediary_hostname intermediary.asset.hostname 直接マッピングされます。
intermediary_ip intermediary.asset.ip 統合済み
intermediary_hostname intermediary.hostname 直接マッピングされます。
intermediary_ip intermediary.ip 統合済み
msg metadata.description 直接マッピングされます。
datetime metadata.event_timestamp RFC 3339 として解析
eventdate metadata.event_timestamp MMM dd yyyy HH:mm:ss として解析
timestamp metadata.event_timestamp ISO8601 として解析
timestampvalue metadata.event_timestamp yyyy-MM-ddTHH:mm:ssZZ として解析
when metadata.event_timestamp UNIX として解析済み
device_vendor metadata.event_type マッピング: Bomgar → GENERIC_EVENT
eventName metadata.event_type マッピング: (?i)login → USER_LOGIN、(?i)logout → USER_LOGOUT
has_principal metadata.event_type マッピング: true → NETWORK_CONNECTION、true → STATUS_UPDATE
category metadata.product_event_type 直接マッピングされます。
event_name metadata.product_event_type 直接マッピングされます。
id metadata.product_event_type 直接マッピングされます。
nvps_auditid metadata.product_log_id 直接マッピングされます。
product_log_id metadata.product_log_id 直接マッピングされます。
device_version metadata.product_version 直接マッピングされます。
version metadata.product_version 直接マッピングされます。
sessionId network.session_id 直接マッピングされます。
agentid observer.application 直接マッピングされます。
product_event_type principal.asset.hostname 直接マッピングされます。
nvps_ipaddress principal.asset.ip 統合済み
sourceip principal.asset.ip 統合済み
product_event_type principal.hostname 直接マッピングされます。
nvps_ipaddress principal.ip 統合済み
sourceip principal.ip 統合済み
srcHost principal.ip 統合済み
who_ip principal.ip 統合済み
process_id principal.process.pid 直接マッピングされます。
srcUser principal.user.user_display_name 直接マッピングされます。
user_display_name principal.user.user_display_name 直接マッピングされます。
srcUid principal.user.userid 直接マッピングされます。
user principal.user.userid 直接マッピングされます。
userid principal.user.userid 直接マッピングされます。
who principal.user.userid 直接マッピングされます。
security_action security_result.action 統合済み
status security_result.action_details 直接マッピングされます。
reason security_result.description 直接マッピングされます。
severity security_result.severity マッピングされた値（合計 5 個、例: 0 → UNKNOWN_SEVERITY、1 → LOW、2 → MEDIUM）
eventName security_result.summary 直接マッピングされます。
eventname security_result.summary 直接マッピングされます。
nvps_systemname target.application 直接マッピングされます。
target target.application 直接マッピングされます。
filePath target.file.full_path 直接マッピングされます。
fsize target.file.size 直接マッピングされます。
deviceHost target.hostname 直接マッピングされます。
site target.hostname 直接マッピングされます。
dstHost target.ip 統合済み
nvps_username_label target.resource.attribute.labels 統合済み
nvps_appuserid target.user.product_object_id 直接マッピングされます。
dstUser target.user.user_display_name 直接マッピングされます。
dstUid target.user.userid 直接マッピングされます。
なし extensions.auth.type 定数: MACHINE
なし metadata.event_type 定数: USER_LOGIN
なし metadata.product_name 定数: BeyondTrust Secure Remote Access
なし metadata.vendor_name 定数: BeyondTrust
なし security_result.severity 定数: UNKNOWN_SEVERITY

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