BeyondTrust Privileged Identity のログを収集する
パーサーのバージョン: 31.0
このドキュメントでは、Bindplane エージェントを使用して BeyondTrust Privileged Identity ログを Google Security Operations に取り込む方法について説明します。
BeyondTrust Privileged Identity は、セキュリティ イベント、認証、アカウント アクティビティの syslog メッセージを CEF 形式と非 CEF 形式で生成する特権アカウント管理ソリューションです。パーサーはフィールドを正規化し、統合データモデル(UDM)にマッピングします。
始める前に
次の前提条件を満たしていることを確認してください。
- Google SecOps インスタンス
- Windows Server 2016 以降、または
systemdを使用する Linux ホスト - Bindplane エージェントと BeyondTrust Privileged Identity インスタンス間のネットワーク接続
- プロキシの背後で実行している場合は、Bindplane エージェントの要件に従ってファイアウォール ポートが開いていることを確認します。
- BeyondTrust Privileged Identity のインスタンスへの特権アクセス
Google SecOps の取り込み認証ファイルを取得する
- Google SecOps コンソールにログインします。
- [SIEM 設定] > [収集エージェント] に移動します。
- 取り込み認証ファイルをダウンロードする
Bindplane エージェントがインストールされるシステムにファイルを安全に保存します。
Google SecOps のお客様 ID を取得する
- Google SecOps コンソールにログインします。
- [SIEM 設定] > [プロファイル] に移動します。
[組織の詳細情報] セクションから [お客様 ID] をコピーして保存します。
Bindplane エージェントをインストールする
次の手順に沿って、Windows または Linux オペレーティング システムに Bindplane エージェントをインストールします。
Windows のインストール
- 管理者として コマンド プロンプトまたは PowerShell を開きます。
次のコマンドを実行します。
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietインストールが完了するまで待ちます。
次のコマンドを実行して、インストールの内容を確認します。
sc query observiq-otel-collectorサービスは RUNNING と表示されます。
Linux のインストール
- root 権限または sudo 権限でターミナルを開きます。
次のコマンドを実行します。
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.shインストールが完了するまで待ちます。
次のコマンドを実行して、インストールの内容を確認します。
sudo systemctl status observiq-otel-collectorサービスは active (running) と表示されます。
その他のインストール リソース
その他のインストール オプションとトラブルシューティングについては、Bindplane エージェントのインストール ガイドをご覧ください。
Syslog を取り込んで Google SecOps に送信するように Bindplane エージェントを構成する
構成ファイルを探す
Linux:
sudo nano /etc/bindplane-agent/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
構成ファイルを編集します。
config.yamlの内容全体を次の構成に置き換えます。receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/beyondtrust_pi: compression: gzip creds_file_path: '/etc/bindplane-agent/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: BEYONDTRUST_PI raw_log_field: body service: pipelines: logs/beyondtrust_pi_to_chronicle: receivers: - udplog exporters: - chronicle/beyondtrust_pi
構成パラメータ
各プレースホルダを次のように置き換えます。
レシーバーの構成:
listen_address: リッスンする IP アドレスとポート:0.0.0.0: すべてのインターフェースでリッスンします(推奨)。- ポート
514は標準の syslog ポートです(Linux で root が必要です。root 以外のユーザーは1514を使用します)。
エクスポータの構成:
creds_file_path: 取り込み認証ファイルのフルパス:- Linux:
/etc/bindplane-agent/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
customer_id: Google SecOps コンソールからコピーしたお客様 IDendpoint: リージョン エンドポイント URL:- 米国:
malachiteingestion-pa.googleapis.com - ヨーロッパ:
europe-malachiteingestion-pa.googleapis.com - アジア:
asia-southeast1-malachiteingestion-pa.googleapis.com - 完全なリストについては、リージョン エンドポイントをご覧ください。
- 米国:
構成ファイルを保存する
- 編集後、ファイルを保存します。
- Linux:
Ctrl+O、Enter、Ctrl+Xの順に押します。 - Windows: [ファイル> 保存] をクリックします。
- Linux:
Bindplane エージェントを再起動して変更を適用する
Linux で Bindplane エージェントを再起動するには、次のコマンドを実行します。
sudo systemctl restart observiq-otel-collectorサービスが実行されていることを確認します。
sudo systemctl status observiq-otel-collectorログでエラーを確認します。
sudo journalctl -u observiq-otel-collector -f
Windows で Bindplane エージェントを再起動するには、次のいずれかのオプションを選択します。
管理者としてコマンド プロンプトまたは PowerShell を開きます。
net stop observiq-otel-collector && net start observiq-otel-collectorサービス コンソール:
Win+Rキーを押し、「services.msc」と入力して Enter キーを押します。- observIQ OpenTelemetry Collector を見つけます。
- 右クリックして [再起動] を選択します。
サービスが実行されていることを確認します。
sc query observiq-otel-collectorログでエラーを確認します。
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
BeyondTrust Privileged Identity で syslog を構成する
- BeyondTrust Privileged Appliance にログインします。
- [アプライアンス> セキュリティ> アプライアンス管理] に移動します。
- [Syslog] セクションに移動します。
- 次の構成情報を指定します。
- ホスト名: Bindplane エージェントの IP アドレスを入力します。
- ポート: デフォルトのポートは 514(UDP)に設定されています。
- 形式: [RFC 5424] を選択します。
- [保存] をクリックします。
UDM マッピング テーブル
| ログフィールド | UDM マッピング | ロジック |
|---|---|---|
| cs1 | additional.fields[0].key | 未加工ログのフィールド cs1Label から直接マッピングされます。 |
| cs1Label | additional.fields[0].value.string_value | 未加工ログのフィールド cs1 から直接マッピングされます。 |
| cs3 | additional.fields[1].value.string_value | 未加工ログのフィールド cs3Label から直接マッピングされます。 |
| cs3Label | additional.fields[1].key | 未加工ログのフィールド cs3 から直接マッピングされます。 |
| cs4 | additional.fields[2].value.string_value | 未加工ログのフィールド cs4Label から直接マッピングされます。 |
| cs4Label | additional.fields[2].key | 未加工ログのフィールド cs4 から直接マッピングされます。 |
| データ | metadata.description | CEF メッセージの場合、msg フィールド(data から抽出)は metadata.description にマッピングされます。CEF 以外のメッセージの場合、sMessage フィールド(または、特定のメッセージ形式に応じてその一部)が metadata.description にマッピングされます。 |
| dhost | target.hostname | 未加工ログのフィールド dhost から直接マッピングされます。 |
| dntdom | target.administrative_domain | 未加工ログのフィールド dntdom から直接マッピングされます。 |
| duser | target.user.user_display_name | 未加工ログのフィールド duser から直接マッピングされます。 |
| msg | metadata.description | CEF メッセージの未加工ログ フィールド msg から直接マッピングされます。 |
| rt | metadata.event_timestamp.seconds | エポック タイムスタンプは、CEF メッセージの rt フィールドから抽出されます。 |
| sEventType | metadata.product_event_type | CEF 以外のメッセージの未加工ログ フィールド sEventType から直接マッピングされます。 |
| shost | principal.ip | 未加工ログのフィールド shost から直接マッピングされます。 |
| sIpAddress | principal.ip | CEF 以外のメッセージの未加工ログ フィールド sIpAddress から直接マッピングされます。 |
| sLoginName | principal.user.userid | sLoginName フィールドから抽出され、正規表現を使用してドメインとユーザー ID が分離されます。 |
| sMessage | security_result.description | CEF 以外のメッセージの未加工ログの sMessage フィールドから直接マッピングされるか、その一部が抽出されて security_result.description に使用されます。 |
| sntdom | principal.administrative_domain | 未加工ログのフィールド sntdom から直接マッピングされます。 |
| sOriginatingAccount | principal.user.userid | sOriginatingAccount フィールドから抽出され、正規表現を使用してドメインとユーザー ID が分離されます。 |
| sOriginatingApplicationComponent | principal.application | sOriginatingApplicationName と組み合わせて principal.application に値を設定します。 |
| sOriginatingApplicationName | principal.application | sOriginatingApplicationComponent と組み合わせて principal.application に値を設定します。 |
| sOriginatingSystem | principal.hostname | CEF 以外のメッセージの未加工ログ フィールド sOriginatingSystem から直接マッピングされます。 |
| suser | principal.user.user_display_name | 未加工ログのフィールド suser から直接マッピングされます。dst、src、shost、suid などの他のフィールドの有無と値に基づいて、パーサー ロジックによって決定されます。有効な値は NETWORK_CONNECTION、STATUS_UPDATE、USER_UNCATEGORIZED、GENERIC_EVENT です。「BEYONDTRUST_PI」に設定されます。「BeyondTrust Remote Support」に設定します。CEF メッセージの CEF ヘッダーから抽出されます。「BeyondTrust」に設定されます。status、reason、sMessage の各フィールドに基づいて「ALLOW」または「BLOCK」に設定されます。LOW に設定します。 |
変更ログ
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。