Cloudian HyperStore のログを収集する

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

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

パーサーは、grok パターンを使用して Cloudian HyperStore syslog メッセージからフィールド(タイムスタンプ、IP アドレス、ユーザー名、説明など)を抽出します。抽出されたフィールドを統合データモデル(UDM)にマッピングし、特定されたアクティビティに基づいて適切なイベントタイプを設定します。

始める前に

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

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

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

  1. Google SecOps コンソールにログインします。
  2. [SIEM 設定] > [収集エージェント] に移動します。
  3. Ingestion Authentication File をダウンロードします。
  4. 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 nano /etc/bindplane-agent/config.yaml
    
  • Windows:

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

構成ファイルを編集する

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

    receivers:
        udplog:
            listen_address: "0.0.0.0:514"
    
    exporters:
        chronicle/cloudian_hyperstore:
            compression: gzip
            creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
            customer_id: '<customer_id>'
            endpoint: malachiteingestion-pa.googleapis.com
            log_type: CLOUDIAN_HYPERSTORE
            raw_log_field: body
    
    service:
        pipelines:
            logs/cloudian_hyperstore_to_chronicle:
                receivers:
                    - udplog
                exporters:
                    - chronicle/cloudian_hyperstore
    

構成パラメータ

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

  • レシーバーの構成:

    • 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
    • customer_id: Google SecOps コンソールからコピーしたお客様 ID
    • endpoint: リージョン エンドポイント URL:
      • 米国: malachiteingestion-pa.googleapis.com
      • ヨーロッパ: europe-malachiteingestion-pa.googleapis.com
      • アジア: asia-southeast1-malachiteingestion-pa.googleapis.com
      • 完全なリストについては、リージョン エンドポイントをご覧ください。

構成ファイルを保存する

  • 編集後、ファイルを保存します。
    • Linux: Ctrl+OEnterCtrl+X を押します。
    • Windows: [File > Save] をクリックします。

Bindplane エージェントを再起動して変更を適用する

  • Linux で Bindplane エージェントを再起動するには、次のコマンドを実行します。

    sudo systemctl restart observiq-otel-collector
    
    1. サービスが実行されていることを確認します。

      sudo systemctl status observiq-otel-collector
      
    2. ログでエラーを確認します。

      sudo journalctl -u observiq-otel-collector -f
      
  • Windows で Bindplane エージェントを再起動するには、次のいずれかのオプションを選択します。

    • 管理者としてコマンド プロンプトまたは PowerShell を開きます。

      net stop observiq-otel-collector && net start observiq-otel-collector
      
    • サービス コンソール:

      1. Win+R を押して services.msc と入力し、Enter キーを押します。
      2. [observIQ OpenTelemetry Collector] を探します。
      3. 右クリックして [再起動] を選択します。
      4. サービスが実行されていることを確認します。

        sc query observiq-otel-collector
        
      5. ログでエラーを確認します。

        type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
        

Cloudian HyperStore syslog を構成する

  1. CLI を使用して HyperStore Config Controller ノードにログインします。
  2. 次の hsctl コマンドを実行します。

    hsctl config set logging.syslog.remote.enabled=true
    hsctl config set logging.syslog.remote.host=<BINDPLANE_IP>
    hsctl config set logging.syslog.remote.protocol=<UDP_OR_TCP>
    hsctl config set logging.syslog.remote.port=<BINDPLANE_PORT>
    hsctl config apply ALL
    hsctl service restart s3 iam hyperstore firewall --nodes=ALL
    hsctl config set monitoring.agent.logging.level=INFO
    hsctl config apply monitoring
    
    • <BINDPLANE_IP> は、Bindplane エージェントの IP アドレスに置き換えます。
    • <UDP_OR_TCP> は、Bindplane エージェントで構成されたプロトコルに置き換えます。
    • <BINDPLANE_PORT> は、Bindplane エージェントのポート番号に置き換えます。

UDM マッピング テーブル

ログフィールド UDM マッピング 論理
description metadata.description 直接マッピングされます。
datetime metadata.event_timestamp RFC3339 として解析されます。
method network.http.method 名前変更/マッピング
url network.http.referral_url 直接マッピングされます。
status_code network.http.response_code 名前変更/マッピング
session_id network.session_id 直接マッピングされます。
application principal.application 直接マッピングされます。
hostname principal.hostname 直接マッピングされます。
source_ip principal.ip 統合済み
request_id principal.process.pid 直接マッピングされます。
target_ip target.ip 統合済み
port target.port 名前変更/マッピング
file_path target.process.file.full_path 直接マッピングされます。
user target.user.user_display_name 直接マッピングされます。
なし extensions.auth.type 定数: AUTHTYPE_UNSPECIFIED
なし metadata.event_type 定数: NETWORK_CONNECTION
なし metadata.product_name 定数: Cloudian Hyperstore
なし metadata.vendor_name 定数: Cloudian

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