Preempt Auth ログを収集する
このドキュメントでは、Bindplane エージェントを使用して Preempt Auth ログを Google Security Operations に取り込む方法について説明します。
Preempt Auth は、Active Directory 環境の詳細な認証ログを生成する認証イベント モニタリング ソリューションです。エンドポイント全体で、ログインの成功と失敗のイベント、LDAP 検索、サービス アクセス、認証タイプをキャプチャします。
始める前に
次の前提条件を満たしていることを確認してください。
- Google SecOps インスタンス
- Windows Server 2016 以降、または
systemdを使用する Linux ホスト - Bindplane エージェントと Preempt サーバー間のネットワーク接続
- プロキシの背後で実行している場合は、Bindplane エージェントの要件に従ってファイアウォール ポートが開いていることを確認します。
- 管理者権限を持つ Preempt Auth(CrowdStrike Identity Protection)への特権アクセス
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 /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/preempt_auth: compression: gzip creds_file_path: '<CREDS_FILE_PATH>' customer_id: '<CUSTOMER_ID>' endpoint: <REGION_ENDPOINT> log_type: PREEMPT_AUTH raw_log_field: body ingestion_labels: env: production service: pipelines: logs/preempt_auth_to_chronicle: receivers: - tcplog exporters: - chronicle/preempt_auth
構成パラメータ
各プレースホルダを次のように置き換えます。
レシーバーの構成:
tcplog: TCP を介して Syslog を受信します。Preempt デプロイが UDP 経由で転送する場合は、udplogを使用します。0.0.0.0:514: ポート 514 のすべてのインターフェースでリッスンします。必要に応じてポートを変更します(たとえば、非 root Linux の場合は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 のお客様 ID を取得するステップで取得したお客様 ID。<REGION_ENDPOINT>: リージョン エンドポイント 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"
Preempt Auth syslog 転送を構成する
- Preempt 管理コンソールにログインします。
- [設定] > [SIEM 統合] に移動します。
- 認証イベントの syslog 転送を有効にします。
- 次の構成情報を指定します。
- プロトコル: [TCP] を選択します(Bindplane エージェントのレシーバー構成と一致する必要があります)。
- Syslog サーバー アドレス: Bindplane エージェント ホストの IP アドレス(例:
192.168.1.100)を入力します。 - ポート:
514を入力します(Bindplane エージェント レシーバー ポートと一致する必要があります)。
- 転送する認証イベントのタイプを選択します。
- 認証成功イベント
- 認証失敗イベント
- LDAP 検索
- サービス アクセス イベント
- [保存] または [適用] をクリックします。
- Bindplane エージェントのログを調べて、ログが送信されていることを確認します。
UDM マッピング テーブル
| ログフィールド | UDM マッピング | ロジック |
|---|---|---|
| authenticationType | extensions.auth.type | authenticationType が SSO_LOGIN または LDAP_AUTHENTICATION と一致する場合は「SSO」、DOMAIN_LOGIN の場合は「MACHINE」、NTLM_AUTHENTICATION の場合は「AUTHTYPE_UNSPECIFIED」に設定します。 |
| extensions.auth.mechanism | 「MECHANISM_UNSPECIFIED」に設定 | |
| inter_ip | intermediary.hostname | inter_ip が有効な IP アドレスでない場合に設定 |
| inter_ip | intermediary.ip | inter_ip が有効な IP アドレスの場合に設定 |
| eventLabel | metadata.description | 値を直接コピーする |
| eventType | metadata.event_type | eventType が SUCCESSFUL_AUTHENTICATION または FAILED_AUTHENTICATION の場合は「USER_LOGIN」、SERVICE_ACCESS または LDAP_SEARCH で principal_host_set が true の場合は「SERVICE_UNSPECIFIED」に設定します。 |
| eventType | metadata.product_event_type | 値を直接コピーする |
| endpointDisplayName、ipAddress | principal.hostname | endpointDisplayName != ipAddress かつ endpointDisplayName != "" の場合に設定します。 |
| ipAddress、inter_ip | principal.ip | ipAddress != inter_ip の場合は ipAddress の値、それ以外の場合は inter_ip の値 |
| networkType | principal.resource.name | 値を直接コピーする |
| principal.resource.type | [ネットワークの種類] に設定 | |
| userDisplayName | principal.user.email_addresses | userDisplayName がメールアドレスの正規表現と一致するかどうかを設定します |
| userDisplayName | principal.user.user_display_name | 値を直接コピーする |
| userEntity.secondaryDisplayName、userDisplayName | principal.user.userid | userEntity.secondaryDisplayName が空でない場合はその値、空の場合は userDisplayName の値 |
| eventType | security_result.action | SUCCESSFUL_AUTHENTICATION の場合は「ALLOW」、FAILED_AUTHENTICATION の場合は「BLOCK」に設定されます。 |
| eventSeverity | security_result.severity_details | 値を直接コピーする |
| authenticationType | security_result.summary | 値を直接コピーする |
| targetEntity.primaryDisplayName、targetServiceIdentifier、eventType、targetEntity.type | target.application | targetEntity.type == 「CLOUD_SERVICE」の場合は targetEntity.primaryDisplayName の値。それ以外の場合は、targetServiceIdentifier != 「」で、以前に設定されていない場合は targetServiceIdentifier の値。eventType == 「LDAP_SEARCH」で、以前に設定されていない場合は「LDAP」 |
| targetEntity.primaryDisplayName、targetEntity.type | target.hostname | targetEntity.type == 「ENDPOINT」の場合に設定します |
| targetServiceType | target.resource.name | targetServiceType != "" かつ != "UNKNOWN" の場合に設定 |
| targetServiceType | target.resource.type | targetServiceType が「」でも「UNKNOWN」でもない場合は、「Service Type」に設定します。 |
| targetEntity.primaryDisplayName、targetEntity.type | target.user.user_display_name | targetEntity.type == "USER" の場合に設定 |
| targetEntity.secondaryDisplayName、targetEntity.type | target.user.userid | targetEntity.type == "USER" の場合に設定 |
| metadata.product_name | 「PREEMPT_AUTH」に設定 | |
| metadata.vendor_name | 「プリエンプト」に設定 |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。