ANSIBLE_AWX

このドキュメントでは、Bindplane を使用して Ansible AWX ログを Google Security Operations に取り込む方法について説明します。パーサーは、JSON 形式の Ansible AWX ログからフィールドを抽出します。JSON 解析を使用してログフィールドを抽出し、これらの値を統合データモデル（UDM）にマッピングします。また、イベントソースとタイプのデフォルトのメタデータ値も設定します。

始める前に

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

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

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

1. Google SecOps コンソールにログインします。
2. [SIEM 設定] > [コレクション エージェント] に移動します。
3. Ingestion Authentication File をダウンロードします。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 では C:Program FilesobservIQ OpenTelemetry Collector ディレクトリにあります。
   • テキスト エディタ（nano、vi、メモ帳など）を使用してファイルを開きます。

2. config.yaml ファイルを次のように編集します。

   receivers:
   udplog:
       # Using high port to avoid requiring root privileges
       listen_address: "0.0.0.0:514"
   
   exporters:
   chronicle/awx:
       endpoint: malachiteingestion-pa.googleapis.com
       creds_file_path: '/path/to/ingestion-authentication-file.json'
       customer_id: YOUR_CUSTOMER_ID
       log_type: 'ANSIBLE_AWX'
       raw_log_field: body
   
   service:
   pipelines:
       logs/awx:
       receivers:
           - udplog
       exporters:
           - chronicle/awx
   

   • 自社のインフラストラクチャでの必要性に応じて、ポートと IP アドレスを置き換えます。
   • YOUR_CUSTOMER_ID は、実際の顧客 ID に置き換えます。
   • /path/to/ingestion-authentication-file.json の値を、ステップ 1 で認証ファイルを保存したパスに更新します。

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

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

  sudo systemctl restart observiq-otel-collector
  

• Windows で Bindplane エージェントを再起動するには、Services コンソールを使用するか、次のコマンドを入力します。

  sc stop observiq-otel-collector && sc start observiq-otel-collector
  

Ansible AWX で外部ロギングを構成する

1. Ansible AWX 管理コンソールにログインします。
2. ナビゲーション バーの [設定] に移動します。
3. [システム] オプションから [ロギング設定] を選択します。
4. 次の構成の詳細を入力します。
   • ロギング アグリゲータ: Bindplane エージェントの IP アドレスを入力します。
   • ロギング アグリゲータ ポート: Bindplane エージェントのポート番号（例: 514）を入力します。
   • ロギング アグリゲータ タイプ: リストから [その他] を選択します。
   • Logging Aggregator Username: 空白のままにします（syslog には必要ありません）。
   • ロギング アグリゲータのパスワード/トークン: 空白のままにします（syslog には必要ありません）。
   • ロギング アグリゲータ プロトコル: [UDP] を選択します（syslog に推奨）。
   • ロギング アグリゲータ レベルのしきい値: [情報] または任意のログレベルを選択します。
   • 外部ロギングを有効にする: トグルを ON にします。
   • ログ アグリゲータにデータを送信するロガー: 関連するログタイプを選択します。
     • awx: 汎用サーバーログ
     • activity_stream: AWX オブジェクトの変更の記録
     • job_events: Ansible コールバック モジュールのデータ
     • system_tracking: システムのファクトと構成データ
   • Log System Tracking Facts Individually: オフに切り替えます（デフォルト）。
5. [Save] をクリックして設定を適用します。
6. 省略可: [テスト] をクリックして、Bindplane エージェントへの接続を確認します。

UDM マッピング テーブル

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