OpenLDAP のログを収集する

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

このドキュメントでは、Bindplane を使用して OpenLDAP ログを Google Security Operations に取り込む方法について説明します。

OpenLDAP は、アクセスログ、監査ログ、レプリケーション ログを生成するオープンソースの LDAP ディレクトリ サーバーです。パーサーは OpenLDAP ログエントリからフィールドを抽出し、統合データモデル（UDM）にマッピングして、ユーザー ID、認証イベント、LDAP オペレーション、セキュリティ結果をキャプチャします。

始める前に

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

  • Google SecOps インスタンス
  • Windows Server 2016 以降、または systemd を使用する Linux ホスト
  • Bindplane エージェントと OpenLDAP サーバー間のネットワーク接続
  • プロキシの背後で実行している場合は、Bindplane エージェントの要件に従ってファイアウォール ポートが開いていることを確認します。
  • root 権限または管理者権限を持つ OpenLDAP サーバーへの特権アクセス

Google SecOps の取り込み認証ファイルを取得する

  1. Google SecOps コンソールにログインします。
  2. [SIEM 設定] > [コレクション エージェント] に移動します。

  3. 取り込み認証ファイル をダウンロードします。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

  3. インストールが完了するまで待ちます。

  4. 次のコマンドを実行して、インストールの内容を確認します。

    sc query observiq-otel-collector

サービスは RUNNING と表示されます。

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

  3. インストールが完了するまで待ちます。

  4. 次のコマンドを実行して、インストールの内容を確認します。

    sudo systemctl status observiq-otel-collector

サービスは active (running) と表示されます。

その他のインストール リソース

その他のインストール オプションとトラブルシューティングについては、Bindplane エージェントのインストール ガイドをご覧ください。

syslog を取り込んで Google SecOps に送信するように Bindplane エージェントを構成する

構成ファイルを探します。

  • Linux:

    sudo systemctl status observiq-otel-collector

  • Windows:

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"

構成ファイルを編集します。

  • config.yaml の内容全体を次の構成に置き換えます。

    receivers:
    udplog:
        listen_address: "0.0.0.0:514"

exporters:
    chronicle/openldap:
        compression: gzip
        creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: OPENLDAP
        raw_log_field: body

service:
    pipelines:
        logs/openldap:
            receivers:
                - udplog
            exporters:
                - chronicle/openldap

構成パラメータ

各プレースホルダを次のように置き換えます。

  • レシーバーの構成:

    • udplog: プロトコルに基づく受信者のタイプ:
      • UDP Syslog の udplog
      • TCP Syslog の tcplog
      • RFC 3164/5424 syslog の syslog
    • 0.0.0.0: リッスンする IP アドレス:
      • 0.0.0.0: すべてのインターフェースでリッスンします（推奨）。
      • 1 つのインターフェースでリッスンする特定の IP アドレス
    • 514: リッスンするポート番号（514、1514、6514 など）

  • エクスポータの構成:

    • <customer_id>: 前のステップで取得したお客様 ID
    • malachiteingestion-pa.googleapis.com: リージョン エンドポイント URL:
      • 米国: malachiteingestion-pa.googleapis.com
      • ヨーロッパ: europe-malachiteingestion-pa.googleapis.com
      • アジア: asia-southeast1-malachiteingestion-pa.googleapis.com
      • 完全なリストについては、リージョン エンドポイントをご覧ください。
    • プラットフォームに応じて creds_file_path を調整します。
      • Linux: /etc/bindplane-agent/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json

構成ファイルを保存する

  • 編集後、ファイルを保存します。
    • Linux: Ctrl+O、Enter、Ctrl+X の順に押します。
    • Windows: [ファイル> 保存] をクリックします。

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"

OpenLDAP の syslog 転送を構成する

OpenLDAP（slapd）は、syslog 経由でログを記録するように構成できます。OpenLDAP ログを Bindplane エージェントに転送するように syslog デーモンを構成します。

  1. OpenLDAP が syslog にログを記録するように構成されていることを確認します。slapd.conf または cn=config で loglevel ディレクティブを確認します。

    loglevel stats conns

  2. OpenLDAP はデフォルトで local4 syslog 機能にログを記録します。これらのログを Bindplane エージェントに転送するように rsyslog を構成します。構成ファイルを作成します。

    sudo nano /etc/rsyslog.d/openldap-forward.conf

  3. 次の内容を追加します。

    local4.* @BINDPLANE_AGENT_IP:514

  4. rsyslog サービスを再起動します。

    sudo systemctl restart rsyslog

UDM マッピング テーブル

ログフィールド UDM マッピング ロジック
op、fd、ou、cn、dc、dc1、base1、base2、base3、scope_data、valueData、method、filter、tag_data、err、attrData、ou_2、ou_1、syslog_message、immutable_user_id、resource additional.fields これらのフィールドから作成されたラベルと統合されました
extensions.auth.type 「AUTHTYPE_UNSPECIFIED」に設定
caller_ip、proxy1_ip、proxy2_ip intermediary intermediary、proxy_1、proxy_2 からマージされました
msg1、inner_message metadata.description msg1 または inner_message からの値
metadata.event_type 最初は「GENERIC_EVENT」に設定され、プリンシパル IP が存在する場合は「STATUS_UPDATE」、ユーザーが存在する場合は「USER_UNCATEGORIZED」、タイムスタンプまたは inner_ts が存在する場合は「USER_LOGIN」に設定されます。
ldap_action metadata.product_event_type ldap_action の値を小文字に変換した値
ldap_conn metadata.product_log_id 「conn=」を削除した後の ldap_conn の値
user_agent network.http.user_agent 値が直接コピーされる
session_id network.session_id 値を直接コピーする
principal_ip、prin_ip、caller_ip、r_ip_or_host、proxy_client_ip、src_ip、client_ip principal.asset.ip principal_ip（- を . に置き換えた後）、prin_ip、caller_ip、r_ip_or_host（IP の場合）、proxy_client_ip、src_ip、client_ip から統合
r_ip_or_host、src_host principal.hostname ホスト名の場合は r_ip_or_host の値、それ以外の場合は src_host
principal_ip、prin_ip、caller_ip、r_ip_or_host、proxy_client_ip、src_ip、client_ip principal.ip principal_ip（- を . に置き換えた後）、prin_ip、caller_ip、r_ip_or_host（IP の場合）、proxy_client_ip、src_ip、client_ip から統合
country principal.location.country_or_region 値を直接コピーする
prin_port、port、src_port principal.port prin_port、port、src_port の値（整数に変換済み）
syslog_process principal.process.file.full_path 値を直接コピーする
syslog_pid principal.process.pid 値を直接コピーする
org_name principal.user.company_name 値を直接コピーする
user、cn、uid principal.user.userid ユーザー、cn、または uid の値
security_result security_result 直接統合
action、sec_action security_result.action アクション（エラーコードに基づく）または sec_action（login_status に基づく）の値
resource、immutable_user_id security_result.detection_fields リソースのラベルと immutable_user_id と統合
inner_descrption、security_description security_result.description inner_descrption または security_description の値
tuser、username、userid target.user.userid tuser、username、userid の値
metadata.product_name 「OpenLDAP」に設定
metadata.vendor_name 「OpenLDAP」に設定します。
eventType event.idm.read_only_udm.metadata.product_event_type 変更履歴からマッピング
cn event.idm.read_only_udm.additional.fields 変更履歴からマッピング
sequenceId event.idm.read_only_udm.additional.fields 変更履歴からマッピング
dc_2 event.idm.read_only_udm.additional.fields 変更履歴からマッピング
dc_3 event.idm.read_only_udm.additional.fields 変更履歴からマッピング
dc event.idm.read_only_udm.additional.fields 変更履歴からマッピング
dc_1 event.idm.read_only_udm.additional.fields 変更履歴からマッピング
user event.idm.read_only_udm.principal.user.userid 変更履歴からマッピング
path event.idm.read_only_udm.principal.process.file.full_path 変更履歴からマッピング
ip1 principal.ip 変更履歴からマッピング
base", "err", "attr", "tag", "scope", and "valueData additional.fields 変更履歴からマッピング
security_result.action ALLOW 変更履歴からマッピング
security_result.action BLOCK 変更履歴からマッピング

変更ログ

このパーサーの変更ログを表示する

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