Aruba Central のログを収集する

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

このドキュメントでは、Bindplane エージェントを使用して HPE Aruba Networking Central のログを Google SecOps に取り込む方法について説明します。パーサーは、Aruba Central Syslog 形式のログからフィールドを抽出します。Grok または kv を使用してログメッセージを解析し、これらの値を Unified Data Model(UDM)にマッピングします。イベントソースとタイプにデフォルトのメタデータ値を設定します。

始める前に

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

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

Bindplane エージェントの Google SecOps 認証情報を取得する

Bindplane エージェントを Google SecOps に対して認証するには、次のいずれかの方法を選択します。

  • 新しいデプロイ: Chronicle API(オプション 1)を使用します。
  • 以前のデプロイ: 2027 年 7 月 20 日に Ingestion API が廃止されるまで、取り込み認証ファイル(オプション 2)を引き続き使用します。
  1. Google Cloud コンソールにログインし、Google SecOps インスタンスにリンクされている Google Cloud プロジェクトを選択します。
  2. [IAM と管理]> [サービス アカウント] に移動します。
  3. [サービス アカウントを作成] をクリックします。
  4. 次の構成情報を指定します。
    • サービス アカウント名: アカウントの名前を入力します(例: bindplane-ingest)。
    • サービス アカウントの説明: 説明を入力します(例: Bindplane agent log ingestion)。
  5. [作成して続行] をクリックします。
  6. [このサービス アカウントにプロジェクトへのアクセスを許可する] セクションで、[ロールを選択] をクリックし、[Chronicle 編集者] を選択します。
  7. [**続行**] をクリックして [**完了**] をクリックします。
  8. 作成したサービス アカウントをクリックし、[キー] タブに移動します。
  9. [鍵を追加] > [新しい鍵を作成] の順にクリックします。
  10. [JSON] を選択し、[作成] をクリックします。キーファイルがパソコンにダウンロードされます。
  11. キーファイルを 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 を更新します。
  12. [IAM と管理][>][設定] に移動し、[プロジェクト番号] をコピーします。エクスポート構成に必要になります。

オプション 2: 取り込み認証ファイルをダウンロードする(レガシー)

  1. Google SecOps コンソールにログインします。
  2. [SIEM 設定] > [収集エージェント] に移動します。
  3. 取り込み認証ファイル をダウンロードします。
  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
    

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
    

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

その他のインストール オプションについては、こちらのインストール ガイドをご覧ください。

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

  1. 構成ファイルにアクセスします。

    • config.yaml ファイルを見つけます。通常、Linux では /opt/observiq-otel-collector/ ディレクトリに、Windows ではインストール ディレクトリにあります。
    • テキスト エディタ(nano、vi、メモ帳など)を使用してファイルを開きます。
  2. config.yaml ファイルを次のように編集します。

    receivers:
      udplog:
        # Replace the port and IP address as required
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/chronicle_w_labels:
        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
        # Adjust the path to the credentials file you downloaded in Step 1
        creds_file_path: '/path/to/ingestion-authentication-file.json'
        # Replace with your actual customer ID from Step 2
        customer_id: <customer_id>
        endpoint: chronicle.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'ARUBA_CENTRAL'
        raw_log_field: body
        ingestion_labels:
    
    service:
      pipelines:
        logs/source0__chronicle_w_labels-0:
          receivers:
            - udplog
          exporters:
            - chronicle/chronicle_w_labels
    
    • 自社のインフラストラクチャでの必要性に応じて、ポートと IP アドレスを置き換えます。
    • <LOCATION> は、Google SecOps インスタンスのリージョン(us、europe、asia-southeast1 など)に置き換えます。エクスポーターは、この値で chronicle.googleapis.com に接頭辞を付けます。
    • <PROJECT_NUMBER> は、[IAM と管理] > [設定] のプロジェクト番号に置き換えます。
    • <customer_id> は、実際のお客様 ID に置き換えます。
    • ステップ 1 でサービス アカウント キーファイル(オプション 1)を保存したファイルパスに /path/to/ingestion-authentication-file.json を更新します。

レガシー Ingestion API エクスポーター

  • オプション 2 の取り込み認証ファイルを使用する場合は、exporters ブロックを次のように置き換えます。creds_file_path を取り込み認証ファイルのパスに設定します。インスタンスが米国以外にある場合は、malachiteingestion-pa.googleapis.com を リージョン エンドポイント(europe-malachiteingestion-pa.googleapis.com など)に置き換えます。

    exporters:
      chronicle/chronicle_w_labels:
        compression: gzip
        # Adjust the path to the credentials file you downloaded in Step 1
        creds_file_path: '/path/to/ingestion-authentication-file.json'
        # Replace with your actual customer ID from Step 2
        customer_id: <customer_id>
        endpoint: malachiteingestion-pa.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'ARUBA_CENTRAL'
        raw_log_field: body
        ingestion_labels:
    

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

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

    sudo systemctl restart observiq-otel-collector
    
  2. Windows で Bindplane エージェントを再起動するには、Services コンソールを使用するか、次のコマンドを入力します。

    net stop observiq-otel-collector && net start observiq-otel-collector
    

Aruba Central で Syslog を構成する

  1. Aruba Central ウェブ UI にログインします。
  2. ダッシュボードで、構成するデバイス を含むグループ を見つけるか、グローバル設定の場合はフィルタを [すべてのデバイス] に設定します。
  3. 構成するデバイスまたはグループをクリックします。
  4. [構成] > [システム] > [ロギング] に移動します。
  5. [Syslog サーバー] セクションを見つけて、[+] ボタンをクリックします。
    • サーバー名: 一意でわかりやすい名前を入力します。
    • サーバー IP: Bindplane エージェントの IP アドレスを入力します。
    • サーバー ポート: Bindplane エージェントのポート番号を入力します。
    • **ロギング形式** : [Syslog] を選択します。
    • カテゴリとファシリティ: ログを送信するカテゴリとファシリティを選択します。
    • ロギングレベル: [情報] を選択します。
  6. [Save Settings] をクリックします。

UDM マッピング テーブル

ログフィールド UDM マッピング ロジック
additional_amm additional.fields 統合済み
additional_nid additional.fields 統合済み
additional_setting_id additional.fields 統合済み
additional_webhook additional.fields 統合済み
dev_type_label additional.fields 統合済み
operation_label additional.fields 統合済み
datetime metadata.event_timestamp RFC 3339 として解析
timestamp metadata.event_timestamp RFC 3339 として解析
event_type metadata.event_type 直接マッピングされます。
alert_type metadata.product_event_type 直接マッピングされます。
event_data metadata.product_event_type 直接マッピングされます。
id metadata.product_log_id 直接マッピングされます。
details.__base_url metadata.url_back_to_product 直接マッピングされます。
network_ssid network.session_id 直接マッピングされます。
app principal.application 直接マッピングされます。
cluster_hostname principal.asset.hostname 直接マッピングされます。
host principal.asset.hostname 直接マッピングされます。
princ_mac principal.asset.mac 統合済み
details.group_name principal.group.group_display_name 直接マッピングされます。
details.group principal.group.product_object_id 直接マッピングされます。
cluster_hostname principal.hostname 直接マッピングされます。
host principal.hostname 直接マッピングされます。
princ_mac principal.mac 統合済み
pid principal.process.pid 直接マッピングされます。
cid principal.user.product_object_id 直接マッピングされます。
details.user principal.user.userid 直接マッピングされます。
device_id principal.user.userid 直接マッピングされます。
labels security_result.about.labels 統合済み
description security_result.description 直接マッピングされます。
state_label security_result.detection_fields 統合済み
severity security_result.severity マッピングされた値(合計 5 つ、例: "LOG_INFO", "LOG_DEBUG" → LOW、LOG_WARN → MEDIUM、`LOG_...
details.config_change security_result.summary 直接マッピングされます。
target_mac target.asset.mac 統合済み
target_mac target.mac 統合済み
alert_type target.resource.type マッピング: DEVICE_CONFIG_CHANGE_DETECTED → DEVICE
target_userid target.user.userid 直接マッピングされます。
userid target.user.userid 直接マッピングされます。
なし metadata.product_name 定数: ARUBA_CENTRAL
なし metadata.vendor_name 定数: ARUBA CENTRAL
なし security_result.severity 定数: LOW
なし target.resource.type 定数: DEVICE
nid" , "setting_id" , "details.dev_type" , "webhook" and "operation additional.fields 変更履歴からマッピング
details.labels security_result.about.labels 変更履歴からマッピング

変更ログ

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

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