One Identity TPAM のログを収集する
このドキュメントでは、Bindplane を使用して One Identity TPAM ログを Google Security Operations に取り込む方法について説明します。
One Identity Privileged Access Manager(TPAM)は、エンタープライズ環境向けにパスワード マネージャーの一元管理、セッション モニタリング、特権アカウント ガバナンスを提供する、以前の特権アクセス管理ソリューションです。TPAM は、パスワードの取得、システム管理アクション、特権セッション アクティビティのアクティビティ ログを生成します。
始める前に
次の前提条件を満たしていることを確認してください。
- Google SecOps インスタンス
- Windows Server 2016 以降、または
systemdを使用する Linux ホスト - Bindplane エージェントと One Identity TPAM アプライアンス間のネットワーク接続
- プロキシの背後で実行している場合は、Bindplane エージェントの要件に従ってファイアウォール ポートが開いていることを確認します。
- One Identity TPAM ウェブ管理インターフェースへの特権アクセス
- TPAM アプライアンスが構成され、動作している
Bindplane エージェントの Google SecOps 認証情報を取得する
Bindplane エージェントを Google SecOps に対して認証するには、次のいずれかの方法を選択します。
- 新規デプロイ: Chronicle API を使用します(オプション 1)。
- 以前のデプロイ: 2027 年 7 月 20 日に Ingestion API が廃止されるまで、取り込み認証ファイル(オプション 2)を引き続き使用します。
オプション 1: Chronicle API のサービス アカウントを作成する(推奨)
- Google Cloud コンソールにログインし、Google SecOps インスタンスにリンクされている Google Cloud プロジェクトを選択します。
- [IAM と管理] > [サービス アカウント] に移動します。
- [サービス アカウントを作成] をクリックします。
- 次の構成情報を指定します。
- サービス アカウント名: アカウントの名前を入力します(例:
bindplane-ingest)。 - サービス アカウントの説明: 説明を入力します(例:
Bindplane agent log ingestion)。
- サービス アカウント名: アカウントの名前を入力します(例:
- [作成して続行] をクリックします。
- [このサービス アカウントにプロジェクトへのアクセスを許可する] セクションで、[ロールを選択] をクリックし、[Chronicle 編集者] を選択します。
- [続行] をクリックして [完了] をクリックします。
- 作成したサービス アカウントをクリックし、[キー] タブに移動します。
- [鍵を追加] > [新しい鍵を作成] の順にクリックします。
- [JSON] を選択し、[作成] をクリックします。鍵ファイルがパソコンにダウンロードされます。
- 鍵ファイルを
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を更新して、保存先のパスと一致させます。 - [IAM と管理] > [設定] に移動し、プロジェクト番号をコピーします。これはエクスポータの構成に必要です。
オプション 2: 取り込み認証ファイルをダウンロードする(レガシー)
- Google SecOps コンソールにログインします。
- [設定] > [データ管理] > [収集エージェント] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [収集エージェント] に移動します。
- 取り込み認証ファイルをダウンロードします。
- Bindplane エージェントがインストールされるシステムにファイルを安全に保存します。
Google SecOps のお客様 ID を取得する
- Google SecOps コンソールにログインします。
- [Settings] > [Administration] > [Profile] に移動します。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 /opt/observiq-otel-collector/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
構成ファイルを編集します。
config.yamlの内容全体を次の構成に置き換えます。receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/tpam: 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: 'YOUR_CUSTOMER_ID' endpoint: chronicle.googleapis.com log_type: ONEIDENTITY_TPAM raw_log_field: body ingestion_labels: source: tpam service: pipelines: logs/tpam_to_chronicle: receivers: - udplog exporters: - chronicle/tpam
構成パラメータ
各プレースホルダを次のように置き換えます。
レシーバーの構成:
listen_address: リッスンする IP アドレスとポート0.0.0.0:514は、ポート 514(標準の syslog ポート)のすべてのインターフェースでリッスンします。- Linux で root 以外のユーザーとして実行する場合は、
0.0.0.0:1514を使用します。 - TPAM は UDP syslog のみをサポートしているため、
udplogレシーバーが必要です。
エクスポータの構成:
creds_file_path: サービス アカウントの JSON キーファイルのフルパス(オプション 1):- Linux:
/opt/observiq-otel-collector/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
customer_id:YOUR_CUSTOMER_IDは、前の手順のお客様 ID に置き換えます。location:<LOCATION>は、Google SecOps インスタンスのリージョン(us、europe、asia-southeast1など)に置き換えます。エクスポーターは、chronicle.googleapis.comの前にこの値を付加します。完全なリストについては、リージョン エンドポイントをご覧ください。project:<PROJECT_NUMBER>を、[IAM と管理] > [設定] のプロジェクト番号に置き換えます。endpoint:chronicle.googleapis.comに設定したままにします。log_type:ONEIDENTITY_TPAMを指定する必要があります。ingestion_labels: フィルタリングと整理に使用するオプションのラベル
Linux(root ユーザー以外)の構成例
receivers: udplog: listen_address: "0.0.0.0:1514" exporters: chronicle/tpam: 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: 'a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6' endpoint: chronicle.googleapis.com log_type: ONEIDENTITY_TPAM raw_log_field: body ingestion_labels: env: production source: tpam service: pipelines: logs/tpam_to_chronicle: receivers: - udplog exporters: - chronicle/tpamWindows の構成例
receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/tpam: 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: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json' customer_id: 'a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6' endpoint: chronicle.googleapis.com log_type: ONEIDENTITY_TPAM raw_log_field: body ingestion_labels: env: production source: tpam service: pipelines: logs/tpam_to_chronicle: receivers: - udplog exporters: - chronicle/tpam
以前の Ingestion API エクスポータ
オプション 2 の取り込み認証ファイルを使用する場合は、
exportersブロックを次のように置き換えます。creds_file_pathを取り込み認証ファイルのパスに設定します。インスタンスが米国以外にある場合は、malachiteingestion-pa.googleapis.comをリージョン エンドポイント(例:europe-malachiteingestion-pa.googleapis.com)に置き換えます。exporters: chronicle/tpam: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: 'YOUR_CUSTOMER_ID' endpoint: malachiteingestion-pa.googleapis.com log_type: ONEIDENTITY_TPAM raw_log_field: body ingestion_labels: source: tpam
構成ファイルを保存する
- 編集が完了したら、ファイルを保存します。
- 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"
One Identity TPAM syslog 転送を構成する
syslog メッセージを Bindplane エージェントに転送するように TPAM を構成します。
- One Identity TPAM のウェブ管理インターフェースにログインします。
- /admin に移動します。
- 左側のナビゲーション メニューで、[System Status] > [SysLog Configuration] に移動します。
- [SysLog Configuration] ページで、次の構成の詳細を指定します。
- SysLog サーバー: Bindplane エージェント ホストの IP アドレスを入力します(例:
192.168.1.100)。 - ポート: Bindplane エージェントで構成されたポート番号(
514や1514など)を入力します。- デフォルトのポートは
514です。 - Linux で root 以外の Bindplane エージェントを使用する場合は、
1514以降を使用します。
- デフォルトのポートは
- プロトコル: TPAM は、syslog 送信に UDP のみをサポートしています。
- SysLog サーバー: Bindplane エージェント ホストの IP アドレスを入力します(例:
- [保存] または [適用] をクリックして、構成を保存します。
- [接続をテスト] をクリックして、Bindplane エージェントへの接続を確認します(利用可能な場合)。
- 有効 / 無効の切り替えが別にある場合は、syslog 転送を有効にします。
注: TPAM は、カスタムの独自形式(CEF に準拠していない)で syslog メッセージを送信します。この形式には、次の 2 つのログタイプが含まれます。
- アクティビティ レポート(tpam): パスワードの取得、システム オペレーション、特権アクセス アクティビティ
- Sys-Admin アクティビティ ログ(sysadmin): 管理操作と構成の変更
syslog メッセージの形式は次の構造になっています。
PAR[PID]: UserName/AdminName, Operation, ObjectType, Target/ObjectName, Role, Failed, OtherInfo
syslog 転送を確認する
- TPAM でテスト アクションを実行します(パスワードの取得やシステムの変更など)。
Bindplane エージェント ログを調べて、syslog メッセージが受信されていることを確認します。
- Linux:
sudo journalctl -u observiq-otel-collector -f | grep -i tpam- Windows:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log" | findstr /i "tpam"Google SecOps コンソールにログインし、[検索] インターフェースにログが表示されていることを確認します。
syslog 接続のトラブルシューティング
syslog メッセージが受信されない場合:
TPAM アプライアンスと Bindplane エージェント間のネットワーク接続を確認します。
ping <bindplane_agent_ip>UDP ポートが開いていて、Bindplane エージェントでリッスンしていることを確認します。
Linux:
sudo netstat -ulnp | grep 514Windows:
netstat -an | findstr :514
ファイアウォール ルールで、構成されたポートの UDP トラフィックが許可されていることを確認します。
- 送信元: TPAM アプライアンスの IP アドレス
- 宛先: Bindplane エージェントの IP アドレス
- プロトコル: UDP
- ポート: 514(または構成済みのポート)
TPAM syslog 構成が保存され、有効になっていることを確認します。
TPAM ウェブ インターフェースにログインする
/admin > [System Status] > [SysLog Configuration] に移動します。
IP アドレスとポートが正しいことを確認する
接続をテストする(可能な場合)
TPAM システムログで syslog 送信エラーを確認します。
- /admin > [システムステータス] > [システムログ] に移動します。
- syslog 関連のエラー メッセージを探す
その他のトラブルシューティング情報については、One Identity TPAM syslog のトラブルシューティング ガイドをご覧ください。
UDM マッピング テーブル
| ログフィールド | UDM マッピング | ロジック |
|---|---|---|
| cn1 | additional.fields | UDM モデルの正式なセクション内で適切に表現できない、ベンダー固有の追加のイベントデータ |
| cn1Label | additional.fields | |
| cs1 | additional.fields | |
| cs1Label | additional.fields | |
| cs2 | additional.fields | |
| cs2Label | additional.fields | |
| cs3 | additional.fields | |
| cs3Label | additional.fields | |
| cs4 | additional.fields | |
| cs4Label | additional.fields | |
| cs5 | additional.fields | |
| cs5Label | additional.fields | |
| cs6 | additional.fields | |
| cs6Label | additional.fields | |
| msg | metadata.description | イベントの説明 |
| metadata.event_type | metadata.event_type | イベントのタイプ(例: USER_LOGIN、NETWORK_CONNECTION) |
| eventid | metadata.product_event_type | サービス固有のイベントタイプ |
| logmsg | metadata.product_event_type | |
| version | metadata.product_version | プロダクトのバージョン |
| hostname | principal.asset.hostname | プリンシパルに関連付けられたアセットのホスト名 |
| groupName | principal.group.group_display_name | グループの表示名 |
| hostname | principal.hostname | プリンシパルのホスト名 |
| cs1 | principal.user.attribute.roles | ユーザーに関連付けられているロール |
| deviceCustomDate1 | security_result.detection_fields | 検出で使用されるフィールド |
| deviceCustomDate1Label | security_result.detection_fields | |
| reason | security_result.summary | セキュリティ結果の概要 |
| destinationDnsDomain | target.domain.name | ターゲット ドメインの名前 |
| cn1 | target.resource.product_object_id | ターゲット リソースのプロダクト固有のオブジェクト ID |
| requestUrl | target.url | ターゲットの URL |
| duser | target.user.user_display_name | 対象ユーザーの表示名 |
| duid | target.user.userid | 対象ユーザーのユーザー ID |
| logmessage | metadata.product_name | プロダクト名 |
| logtype | metadata.vendor_name | ベンダーの名前 |
timestamp |
event.idm.read_only_udm.metadata.event_timestamp |
変更履歴からマッピング |
cn2 |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
cn3 |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
cs2", "cs3", "cs4", "cs5", "cs6 |
additional.fields |
変更履歴からマッピング |
変更ログ
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。