ManageEngine ADManager Plus のログを収集する
このドキュメントでは、Bindplane エージェントを使用して ManageEngine ADManager Plus ログを Google Security Operations に取り込む方法について説明します。
ManageEngine ADManager Plus は、ユーザーの作成と変更、ロールベースのセキュリティ、詳細なレポートなど、AD 管理を簡素化するウェブベースのソリューションを提供します。ADManager Plus と Splunk および Syslog サーバーの統合により、組織は ADManager Plus で実行されたすべての Active Directory、Microsoft 365、Google Workspace 管理アクションのログを転送できます。
始める前に
次の前提条件を満たしていることを確認してください。
- Google SecOps インスタンス
- Windows Server 2016 以降、または
systemdを使用する Linux ホスト - Bindplane エージェントと ManageEngine ADManager Plus 間のネットワーク接続
- プロキシの背後で実行している場合は、Bindplane エージェントの要件に従ってファイアウォール ポートが開いていることを確認します
- ManageEngine ADManager Plus 管理コンソールへの特権アクセス
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] を選択し、[作成] をクリックします。鍵ファイルがパソコンにダウンロードされます。
- 鍵ファイルを Bindplane コレクタ ディレクトリ(Linux の場合は
/opt/observiq-otel-collector/ingestion-auth.json、Windows の場合はC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json)にingestion-auth.jsonとして保存するか、config.yamlのcreds_file_pathを保存先のパスと一致するように更新します。 - [IAM と管理] > [設定] に移動し、[プロジェクト番号] をコピーします。エクスポーターの構成に必要になります。
オプション 2: 取り込み認証ファイルをダウンロードする(レガシー)
- Google SecOps コンソールにログインします。
- [SIEM 設定] > [収集エージェント] に移動します。
- 取り込み認証ファイルをダウンロードします。
- Bindplane エージェントがインストールされるシステムにファイルを安全に保存します。
Google SecOps のお客様 ID を取得する
- Google SecOps コンソールにログインします。
- [SIEM 設定] > [プロファイル] に移動します。
[組織の詳細情報] セクションから [お客様 ID] をコピーして保存します。
Bindplane エージェントをインストールする
次の手順に沿って、Windows または Linux オペレーティング システムに Bindplane エージェントをインストールします。
Windows へのインストール
- 管理者として コマンド プロンプトまたは PowerShell を開きます。
次のコマンドを実行します。
msiexec /i "https://github.com/observIQ/bindplane-otel-collector/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-otel-collector/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: tcplog: listen_address: "0.0.0.0:514" exporters: chronicle/admanager_plus: 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: '<CREDS_FILE_PATH>' customer_id: '<CUSTOMER_ID>' endpoint: chronicle.googleapis.com log_type: ADMANAGER_PLUS raw_log_field: body ingestion_labels: log_source: admanager_plus service: pipelines: logs/admanager_to_chronicle: receivers: - tcplog exporters: - chronicle/admanager_plus各プレースホルダを次のように置き換えます。
レシーバーの構成:
- レシーバーは
tcplogを使用して、TCP ポート 514 で syslog データを受信します。 listen_address: ポート 514 のすべてのインターフェースでリッスンするには、0.0.0.0:514に設定します。
- レシーバーは
エクスポータの構成:
<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>: 前のステップのお客様 ID。location:<LOCATION>は、Google SecOps インスタンスのリージョン(us、europe、asia-southeast1など)に置き換えます。エクスポーターは、chronicle.googleapis.comの先頭にこの値を付加します。完全なリストについては、リージョン エンドポイントをご覧ください。project:<PROJECT_NUMBER>を [IAM と管理] > [設定] のプロジェクト番号に置き換えます。endpoint:chronicle.googleapis.comに設定したままにします。log_type: Chronicle に表示されるとおりにADMANAGER_PLUSに設定します。ingestion_labels: YAML 形式の省略可能なラベル。
以前の取り込み API エクスポータ
オプション 2 の取り込み認証ファイルを使用する場合は、
exportersブロックを次のように置き換えます。creds_file_pathを取り込み認証ファイルのパスに設定します。インスタンスが米国以外にある場合は、malachiteingestion-pa.googleapis.comをリージョン エンドポイント(europe-malachiteingestion-pa.googleapis.comなど)に置き換えます。exporters: chronicle/admanager_plus: compression: gzip creds_file_path: '<CREDS_FILE_PATH>' customer_id: '<CUSTOMER_ID>' endpoint: malachiteingestion-pa.googleapis.com log_type: ADMANAGER_PLUS raw_log_field: body ingestion_labels: log_source: admanager_plus
構成ファイルを保存する
編集が完了したら、ファイルを保存します。
- Linux:
Ctrl+O、Enter、Ctrl+Xの順に押します。 - Windows の場合: [ファイル] > [保存] をクリックします。
Bindplane エージェントを再起動して変更を適用する
Linux
Linux で Bindplane エージェントを再起動するには、次のコマンドを実行します。
sudo systemctl restart observiq-otel-collectorサービスが実行されていることを確認します。
sudo systemctl status observiq-otel-collectorログでエラーを確認します。
sudo journalctl -u observiq-otel-collector -f
Windows
Windows で Bindplane エージェントを再起動するには、次のいずれかのオプションを選択します。
管理者としてコマンド プロンプトまたは PowerShell を使用する。
net stop observiq-otel-collector && net start observiq-otel-collectorサービス コンソールを使用する。
Win+Rを押し、「services.msc」と入力して Enter キーを押します。- observIQ Distro for OpenTelemetry Collector を見つけます。
- 右クリックして [再起動] を選択します。
サービスが実行されていることを確認します。
sc query observiq-otel-collectorログでエラーを確認します。
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
ManageEngine ADManager Plus の syslog 転送を構成する
- ADManager Plus にログインします。
- [Admin] タブに移動します。
- [System Settings] で [Integrations] をクリックします。
[ログ転送] で、[Syslog] をクリックします。
次のフィールドを構成します。
- Syslog サーバー: Syslog サーバー名を入力します。Bindplane エージェント ホストの IP アドレスまたはホスト名を入力します。
- ポート: ポート番号を入力します。「
514」と入力します。 - プロトコル: ログの転送に適したプロトコル(TCP または UDP)を選択します。[TCP] を選択します。
- Syslog Standard: 目的の syslog メッセージ形式(RFC 3164、RFC 5424、RawLog)を選択します。[RFC 5424](推奨)を選択します。
- Data Format: データ形式を入力します。環境の必要に応じてデータ形式を構成します。
[保存] をクリックして、構成を保存します。
構成後、ADManager Plus は管理アクションのログを Bindplane エージェントに転送し始めます。Bindplane エージェントは、それらのログを Google SecOps に送信します。
UDM マッピング テーブル
| ログフィールド | UDM マッピング | ロジック |
|---|---|---|
| ipPhone | event.idm.read_only_udm.additional.fields | ipPhone != "" の場合、キー「ipPhone」と ipPhone の値を持つラベルとして統合されます。 |
| l | event.idm.read_only_udm.additional.fields | l != "" の場合、キー「l」と l の値を持つラベルとして統合されます。 |
| lockoutTime | event.idm.read_only_udm.additional.fields | lockoutTime != "" の場合、キー「lockoutTime」と lockoutTime の値を持つラベルとして統合されます。 |
| 移動元 | event.idm.read_only_udm.additional.fields | Move_From != "" の場合、キー「Move From」と Move_From の値を持つラベルとして統合されます。 |
| 移動先 | event.idm.read_only_udm.additional.fields | Move_To != "" の場合、キー「Move To」と Move_To の値を持つラベルとして統合されます |
| msg | event.idm.read_only_udm.additional.fields | msg != "" の場合、キー「member」と msg の値を持つラベルとして統合されます。 |
| sn | event.idm.read_only_udm.additional.fields | sn != "" の場合、キー「sn」と sn の値を持つラベルとしてマージされます。 |
| st | event.idm.read_only_udm.additional.fields | st != "" の場合、キー「st」と st の値を持つラベルとしてマージされます。 |
| テンプレート名 | event.idm.read_only_udm.additional.fields | Template_Name != "" の場合、キー「Template Name」と Template_Name の値を持つラベルとして統合されます。 |
| ステータス | event.idm.read_only_udm.metadata.description | ステータスが空でない場合は、ステータスから取得した値 |
| 時間 | event.idm.read_only_udm.metadata.event_timestamp | time != "" の場合、time 形式から timestamp 形式に変換されます。 |
| event.idm.read_only_udm.metadata.event_type | 派生: has_principal_user == 「true」の場合は「USER_UNCATEGORIZED」、has_principal == 「true」の場合は「STATUS_UPDATE」、それ以外の場合は「GENERIC_EVENT」 | |
| TechnicianName | event.idm.read_only_udm.metadata.product_event_type | TechnicianName != "" の場合、TechnicianName から取得された値 |
| event.idm.read_only_udm.metadata.product_name | 「ADMANAGER_PLUS」に設定します。 | |
| event.idm.read_only_udm.metadata.vendor_name | 「ADMANAGER_PLUS」に設定します。 | |
| ドメイン名 | event.idm.read_only_udm.principal.administrative_domain | Domain_Name != "" の場合、Domain_Name から値を取得します |
| hostname | event.idm.read_only_udm.principal.asset.hostname | hostname != "" の場合、hostname から取得された値 |
| event.idm.read_only_udm.principal.email | mail != "" の場合、mail から値を取得 | |
| hostname | event.idm.read_only_udm.principal.hostname | hostname != "" の場合、hostname から値を取得します |
| co | event.idm.read_only_udm.principal.location.city | co != "" の場合は co から取得された値 |
| タスク | event.idm.read_only_udm.principal.resource.name | Task != "" の場合、Task から取得された値 |
| wWWHomePage | event.idm.read_only_udm.principal.url | wWWHomePage != "" の場合、wWWHomePage から取得された値 |
| パスワードの種類 | event.idm.read_only_udm.principal.user.attribute.labels | Password_Type != "" の場合、キー「Password Type」と Password_Type の値を持つラベルとして統合されます。 |
| countryCode | event.idm.read_only_udm.principal.user.attribute.labels | countryCode != "" の場合、キー「countryCode」と countryCode の値を持つラベルとして統合されます。 |
| パスワード | event.idm.read_only_udm.principal.user.attribute.labels | パスワードが「」でない場合は、キー「password」とパスワードの値を持つラベルとして統合されます。 |
| postalCode | event.idm.read_only_udm.principal.user.attribute.labels | postalCode != "" の場合、キー「postalCode」と postalCode の値を持つラベルとして統合されます。 |
| primaryGroupID | event.idm.read_only_udm.principal.user.attribute.labels | primaryGroupID != "" の場合、キー「primaryGroupID」と primaryGroupID の値を持つラベルとして統合されます。 |
| userAccountControl | event.idm.read_only_udm.principal.user.attribute.labels | userAccountControl != "" の場合、キーが「userAccountControl」、値が userAccountControl のラベルとして統合されます。 |
| userPrincipalName | event.idm.read_only_udm.principal.user.attribute.labels | userPrincipalName != "" の場合、キー「userPrincipalName」と userPrincipalName の値を持つラベルとして統合されます。 |
| 会社 | event.idm.read_only_udm.principal.user.company_name | company != "" の場合、会社から取得した値 |
| department | event.idm.read_only_udm.principal.user.department | department != "" の場合は department と統合 |
| givenName | event.idm.read_only_udm.principal.user.first_name | givenName != "" の場合、givenName から取得された値 |
| physicalDeliveryOfficeName | event.idm.read_only_udm.principal.user.office_address.name | physicalDeliveryOfficeName != "" の場合、physicalDeliveryOfficeName から取得された値 |
| streetAddress | event.idm.read_only_udm.principal.user.personal_address.name | streetAddress != "" の場合、streetAddress から取得された値 |
| homePhone | event.idm.read_only_udm.principal.user.phone_numbers | homePhone != "" の場合、homePhone と統合されます。 |
| ユーザー名 | event.idm.read_only_udm.principal.user.user_display_name | User_Name != "" の場合は User_Name から値を取得し、それ以外の場合は Object_Name != "" の場合は Object_Name から値を取得します。 |
| sAMAccountName | event.idm.read_only_udm.principal.user.userid | sAMAccountName != "" の場合、sAMAccountName から取得された値 |
| ACTION | event.idm.read_only_udm.security_result.action_details | ACTION != "" の場合、ACTION から取得された値 |
| 説明 | event.idm.read_only_udm.security_result.description | description != "" の場合、description から取得された値 |
| コンテナ名 | event.idm.read_only_udm.security_result.detection_fields | container_Name grok から派生: dc_label_1 != "" の場合、キー「Container_Name_DC_value1」と dc_label_1 の値を持つラベルとしてマージされます。 |
| コンテナ名 | event.idm.read_only_udm.security_result.detection_fields | container_Name grok から派生: dc_label_2 != "" の場合、キー「Container_Name_DC_value2」と dc_label_2 の値を持つラベルとして統合 |
| コンテナ名 | event.idm.read_only_udm.security_result.detection_fields | container_Name grok から派生: ou_label_1 != "" の場合、キー「Container_Name_OU_value1」と ou_label_1 の値を持つラベルとしてマージされます。 |
| コンテナ名 | event.idm.read_only_udm.security_result.detection_fields | container_Name grok から派生: ou_label_2 != "" の場合、キー「Container_Name_OU_value2」と ou_label_2 の値を持つラベルとして統合 |
| コンテナ名 | event.idm.read_only_udm.security_result.detection_fields | container_Name grok から派生: ou_label_3 != "" の場合、キー「Container_Name_OU_value3」と ou_label_3 の値を持つラベルとしてマージされます。 |
| メイングループ | event.idm.read_only_udm.security_result.detection_fields | Primary_Group grok から派生: cn_label_1 != "" の場合、キー「Primary_Group_CN_value1」と cn_label_1 の値を持つラベルとしてマージされます。 |
| メイングループ | event.idm.read_only_udm.security_result.detection_fields | Primary_Group grok から派生: cn_label_2 != "" の場合、キー「Primary_Group_CN_value2」と cn_label_2 の値を持つラベルとしてマージされます。 |
| プライマリ グループ | event.idm.read_only_udm.security_result.detection_fields | Primary_Group grok から派生: primary_dc_label_1 != "" の場合、キー「Primary_Group_DC_value1」と primary_dc_label_1 の値を持つラベルとしてマージされます。 |
| メイングループ | event.idm.read_only_udm.security_result.detection_fields | Primary_Group grok から派生: primary_dc_label_2 != "" の場合、キー「Primary_Group_DC_value2」と primary_dc_label_2 の値を持つラベルとして統合 |
| accountExpires | event.idm.read_only_udm.security_result.detection_fields | accountExpires != "" の場合、キー「accountExpires」と accountExpires の値でラベルとして統合されます。 |
| manager | event.idm.read_only_udm.security_result.detection_fields | manager grok から派生: manager_cn_value1 != "" の場合、キー「manager_cn_value1」と manager_cn_value1 の値を持つラベルとしてマージされます。 |
| manager | event.idm.read_only_udm.security_result.detection_fields | マネージャー grok から派生: manager_dc_value1 != "" の場合、キー「manager_dc_value1」と manager_dc_value1 の値を持つラベルとして統合 |
| manager | event.idm.read_only_udm.security_result.detection_fields | マネージャー Grok から派生: manager_dc_value2 != "" の場合、キー「manager_dc_value2」と manager_dc_value2 の値を持つラベルとして統合 |
| manager | event.idm.read_only_udm.security_result.detection_fields | manager grok から派生: manager_ou_value1 != "" の場合、キー「manager_ou_value1」と manager_ou_value1 の値を持つラベルとしてマージされます。 |
| manager | event.idm.read_only_udm.security_result.detection_fields | マネージャー grok から派生: manager_ou_value2 != "" の場合、キー「manager_ou_value2」と manager_ou_value2 の値を持つラベルとしてマージされます。 |
| manager | event.idm.read_only_udm.security_result.detection_fields | manager grok から派生: manager_ou_value3 != "" の場合、キー「manager_ou_value3」と manager_ou_value3 の値を持つラベルとしてマージされます。 |
| pwdLastSet | event.idm.read_only_udm.security_result.detection_fields | pwdLastSet != "" の場合、キー「pwdLastSet」と pwdLastSet の値を持つラベルとしてマージされます。 |
| ModuleName | event.idm.read_only_udm.target.resource.name | ModuleName が「""」でない場合は、ModuleName から取得された値 |
Object_Name |
event.idm.read_only_udm.target.user.user_display_name |
変更履歴からマッピング |
syslog_priority |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
syslog_version |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
product_app_id |
event.idm.read_only_udm.additional.fields |
変更履歴からマッピング |
User_Name |
event.idm.read_only_udm.target.user.user_display_name |
変更履歴からマッピング |
User_Name |
event.idm.read_only_udm.target.user.userid |
変更履歴からマッピング |
streetAddress |
event.idm.ready_only_udm.principal.user.personal_address.name |
変更履歴からマッピング |
physicalDeliveryOfficeName |
event.idm.ready_only_udm.principal.user.office_address.name |
変更履歴からマッピング |
postalCode |
event.idm.ready_only_udm.principal.user.attribute.labels |
変更履歴からマッピング |
countryCode |
event.idm.ready_only_udm.principal.user.attribute.labels |
変更履歴からマッピング |
company |
event.idm.ready_only_udm.principal.user.company_name |
変更履歴からマッピング |
department |
event.idm.ready_only_udm.principal.user.department |
変更履歴からマッピング |
accountExpires |
event.idm.ready_only_udm.security_result.detection_fields |
変更履歴からマッピング |
ou_label_1 |
event.idm.ready_only_udm.security_result.detection_fields |
変更履歴からマッピング |
ou_label_2 |
event.idm.ready_only_udm.security_result.detection_fields |
変更履歴からマッピング |
ou_label_3 |
event.idm.ready_only_udm.security_result.detection_fields |
変更履歴からマッピング |
dc_label_1 |
event.idm.ready_only_udm.security_result.detection_fields |
変更履歴からマッピング |
dc_label_2 |
event.idm.ready_only_udm.security_result.detection_fields |
変更履歴からマッピング |
cn_label_1 |
event.idm.ready_only_udm.security_result.detection_fields |
変更履歴からマッピング |
cn_label_2 |
event.idm.ready_only_udm.security_result.detection_fields |
変更履歴からマッピング |
primary_dc_label_1 |
event.idm.ready_only_udm.security_result.detection_fields |
変更履歴からマッピング |
primary_dc_label_2 |
event.idm.ready_only_udm.security_result.detection_fields |
変更履歴からマッピング |
manager_cn_value1 |
event.idm.ready_only_udm.security_result.detection_fields |
変更履歴からマッピング |
, |
event.idm.ready_only_udm.security_result.detection_fields |
変更履歴からマッピング |
and |
event.idm.ready_only_udm.security_result.detection_fields |
変更履歴からマッピング |
givenName |
event.idm.ready_only_udm.user.first_name |
変更履歴からマッピング |
sn |
event.idm.ready_only_udm.additional.fields |
変更履歴からマッピング |
st |
event.idm.ready_only_udm.additional.fields |
変更履歴からマッピング |
l |
event.idm.ready_only_udm.additional.fields |
変更履歴からマッピング |
wWWHomePage |
event.idm.ready_only_udm.principal.url |
変更履歴からマッピング |
homePhone |
event.idm.ready_only_udm.principal.user.phone_numbers |
変更履歴からマッピング |
co |
event.idm.ready_only_udm.principal.location.city |
変更履歴からマッピング |
変更ログ
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。