收集 Apache Tomcat 記錄

本文說明如何使用 Bindplane，將 Apache Tomcat 記錄擷取至 Google Security Operations。剖析器會從 JSON 格式的記錄中擷取欄位，並轉換為統合式資料模型 (UDM)。這個函式會初始化預設值、剖析 JSON 酬載、處理可能的 JSON 剖析錯誤，並將原始記錄中的各種欄位對應至相應的 UDM 欄位，包括中繼資料、主體、觀察者和安全性結果資訊，同時也會為環境內容新增自訂標籤。

事前準備

請確認您已完成下列事前準備事項：

• Google SecOps 執行個體
• Windows 2016 以上版本，或搭載 systemd 的 Linux 主機
• 如果透過 Proxy 執行，防火牆通訊埠已開啟
• Apache Tomcat 9.0.70 以上版本
• 具備「$CATALINA_BASE/conf」和「$CATALINA_BASE/logs」的寫入權限

取得 Google SecOps 擷取驗證檔案

1. 登入 Google SecOps 控制台。
2. 依序前往「SIEM 設定」>「收集代理程式」。
3. 下載擷取驗證檔案。將檔案安全地儲存在要安裝 Bindplane 的系統上。

取得 Google SecOps 客戶 ID

1. 登入 Google SecOps 控制台。
2. 依序前往「SIEM 設定」>「設定檔」。
3. 複製並儲存「機構詳細資料」專區中的客戶 ID。

在 Tomcat 伺服器上安裝 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. 開啟具有根層級或 sudo 權限的終端機。

2. 執行下列指令：

   sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
   

其他安裝資源

如需其他安裝選項，請參閱安裝指南。

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

1. 存取設定檔：
   • 找出 config.yaml 檔案。通常位於 Linux 的 /etc/bindplane-agent/ 目錄，或 Windows 的安裝目錄。
   • 使用文字編輯器 (例如 nano、vi 或記事本) 開啟檔案。

2. 按照下列方式編輯 config.yaml 檔案：

   receivers:
       filelog/tomcat:
       include: [ /path/to/tomcat/logs/access-log.*.json ]
       start_at: beginning
   
   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: 'TOMCAT'
           raw_log_field: body
           ingestion_labels:
   
   service:
       pipelines:
           logs/source0__chronicle_w_labels-0:
               receivers:
                   - filelog/tomcat
               exporters:
                   - chronicle/chronicle_w_labels
   

   • 更換 /path/to/tomcat/logs。
   • 將 <customer_id> 替換為實際的客戶 ID。
   • 將 /path/to/ingestion-authentication-file.json 更新為您在「取得 Google SecOps 擷取驗證檔案」部分儲存驗證檔案的路徑。

重新啟動 Bindplane 代理程式，以套用變更

• 如要在 Linux 中重新啟動 Bindplane 代理程式，請執行下列指令：

  sudo systemctl restart bindplane-agent
  

• 如要在 Windows 中重新啟動 Bindplane 代理程式，可以使用「服務」控制台，或輸入下列指令：

  net stop BindPlaneAgent && net start BindPlaneAgent
  

在 Tomcat 中設定 JSON 存取記錄

1. 開啟 $CATALINA_BASE/conf/server.xml 的 Tomcat 檔案。

2. 找出 <Host> 標記，並在其中加入以下內容：

   <Valve className="org.apache.catalina.valves.JsonAccessLogValve"
         directory="logs"
         prefix="access-log"
         suffix=".json"
         rotatable="true"
         maxDays="7"/>
   

3. 重新啟動 Tomcat 以套用變更：

   cd /path/to/tomcat
   bin/catalina.sh stop
   bin/catalina.sh start
   

4. 每天都會產生新的 JSON 記錄檔 (例如 logs/access-log.2025-07-02.json)。

UDM 對應表

還有其他問題嗎？向社群成員和 Google SecOps 專業人員尋求答案。