收集 HashiCorp 稽核記錄

這個剖析器會處理 JSON、Syslog 或合併格式的 HashiCorp 稽核記錄。這項功能會擷取欄位、對標準和「執行器」類型的訊息執行 Grok 和 KV 剖析、處理 JSON 酬載，以及將擷取的資料對應至 UDM。剖析器也會處理錯誤，並捨棄格式錯誤的記錄。

事前準備

• 確認您有 Google Security Operations 執行個體。
• 確認您有 Windows 2016 以上版本，或是搭載 systemd 的 Linux 主機。
• 如果透過 Proxy 執行，請確認防火牆通訊埠已開啟。
• 確認您具備 HCP 的特殊權限。

取得 Google SecOps 擷取驗證檔案

1. 登入 Google SecOps 控制台。
2. 依序前往「SIEM 設定」>「收集代理程式」。
3. 下載擷取驗證檔案。

取得 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. 如需其他安裝選項，請參閱這份安裝指南。

設定 Bindplane 代理程式，擷取系統記錄檔並傳送至 Google SecOps

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 Clusters」。
3. 從已部署的叢集清單中選取 Vault 叢集。
4. 在「Cluster Overview」(叢集總覽) 中，找出並複製「Vault Address」(Vault 位址) (例如：https://vault-cluster-name.hashicorpcloud.com:8200)。
5. 前往「Access Details」部分，然後複製「Root Token」。

安裝 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>
   

將系統記錄檔路徑設定為外部系統記錄檔通訊端

1. 執行下列指令，啟用系統記錄並傳送至 Bindplane 代理程式：

   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 專業人員尋求答案。