HashiCorp 監査ログを収集する

このパーサーは、JSON、Syslog、または結合形式の HashiCorp 監査ログを処理します。フィールドを抽出し、標準タイプと「ランナー」タイプの両方のメッセージに対して Grok と KV の解析を行い、JSON ペイロードを処理して、抽出されたデータを UDM にマッピングします。パーサーには、エラー処理と形式が不正なログの削除も含まれています。

始める前に

• Google Security Operations インスタンスがあることを確認します。
• Windows 2016 以降または systemd を使用する Linux ホストがあることを確認します。
• プロキシの背後で実行している場合は、ファイアウォール ポートが開いていることを確認します。
• HCP に対する特権アクセス権があることを確認します。

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

1. Google SecOps コンソールにログインします。
2. [SIEM Settings] > [Collection Agents] に移動します。
3. Ingestion Authentication File をダウンロードします。

Google SecOps のお客様 ID を取得する

1. Google SecOps コンソールにログインします。
2. [SIEM 設定] > [プロファイル] に移動します。
3. [組織の詳細情報] セクションから [お客様 ID] をコピーして保存します。

Bindplane エージェントをインストールする

1. Windows へのインストールの場合は、次のスクリプトを実行します。
   msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
2. Linux へのインストールの場合は、次のスクリプトを実行します。
   sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
3. その他のインストール オプションについては、インストール ガイドをご覧ください。

Syslog を取り込んで Google SecOps に送信するように Bindplane Agent を構成する

1. Bindplane エージェントがインストールされているマシンにアクセスします。

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

   receivers:
       udplog:
           # Replace the below port <54525> and IP <0.0.0.0> with your specific values
           listen_address: "0.0.0.0:54525" 
   
   exporters:
       chronicle/chronicle_w_labels:
           compression: gzip
           # Adjust the creds location below according the placement of the credentials file you downloaded
           creds: '{ json file for creds }'
           # Replace <customer_id> below with your actual ID that you copied
           customer_id: <customer_id>
           endpoint: malachiteingestion-pa.googleapis.com
           # You can apply ingestion labels below as preferred
           ingestion_labels:
           log_type: SYSLOG
           namespace: auditd
           raw_log_field: body
   service:
       pipelines:
           logs/source0__chronicle_w_labels-0:
               receivers:
                   - udplog
               exporters:
                   - chronicle/chronicle_w_labels
   

3. Bindplane エージェントを再起動して変更を適用します。

   sudo systemctl restart bindplane
   

HCP Vault の Syslog を有効にする

1. HCP ポータルにログインします。
2. [Vault クラスタ] に移動します。
3. デプロイされたクラスタのリストから Vault クラスタを選択します。
4. [クラスタの概要] で、[Vault アドレス]（https://vault-cluster-name.hashicorpcloud.com:8200 など）を見つけてコピーします。
5. [アクセス詳細] セクションに移動し、ルートトークンをコピーします。

Vault CLI をインストールする

• Linux の場合:

  curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
  echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
  sudo apt update && sudo apt install vault
  

• macOS の場合（Homebrew を使用）:

  brew tap hashicorp/tap
  brew install hashicorp/tap/vault
  

• Windows の場合:

  Download the executable file.
  Extract it and add the Vault binary to your system's PATH.
  

• 次のコマンドを実行して、Vault CLI のインストールを確認します。

  vault --version
  

CLI を使用して HCP Vault を構成し、監査ログを Bindplane に送信する

1. ターミナルまたはコマンド プロンプトを開きます。

2. 環境変数を使用して Vault サーバーのアドレスを設定します。

   export VAULT_ADDR="https://vault-cluster-name.hashicorpcloud.com:8200"
   

3. ルートトークンを使用して Vault にログインします。

   vault login <root-token>
   

外部 Syslog ソケットへの Syslog パスを構成する

1. 次のコマンドを実行して syslog を有効にし、Bindplane Agent に送信します。

   vault audit enable socket address="udp://<bindplane-ip>:<bindplane-port>" socket_type="udp" tag="vault"
   

2. 新しい構成を確認します。

   vault audit list
   

3. 出力には、新しいソケット構成が表示されます。

4. 省略可: Terraform を使用して設定を自動化します。

   • Terraform 構成ファイル（audit.tf）を作成します。

   resource "vault_audit" "syslog" {
     type        = "syslog"
     description = "Syslog audit logs"
     options = {
       tag      = "vault"
       facility = "LOCAL0"
     }
   }
   
   resource "vault_audit" "socket" {
     type        = "socket"
     description = "Remote syslog socket"
     options = {
       address     = "udp://<syslog-server-ip>:514"
       socket_type = "udp"
       tag         = "vault"
     }
   }
   

   • 構成を適用します。

   terraform init
   terraform apply
   

ログが受信されない場合のトラブルシューティング

• syslog サーバーに到達可能であることを確認します。

  ping <syslog-server-ip>
  

UDM マッピング テーブル

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