在 GitHub 中導入社群剖析器
Google Security Operations 運用 GitHub 上的開放原始碼存放區,讓社群、合作夥伴和客戶能協同開發及維護剖析器。社群成員可透過這個存放區,擴充及維護 Google SecOps 的可用剖析器。
目標
- 啟用社群貢獻功能:允許外部使用者、合作夥伴和客戶貢獻新的社群剖析器,以及更新現有剖析器。
- 促進採用:提供機制,讓使用者將社群剖析器導入自訂剖析器執行個體。
- 確保品質:維持嚴格的審查和測試架構,在發布前驗證所有貢獻內容的安全性和功能品質。
事前準備
- 確認您具備
chronicle.parsers.create權限,這是chronicle.adminIAM 角色的一部分。 - 如要為社群剖析器做出貢獻,請簽署貢獻者授權協議 (CLA)。詳情請參閱「簽署貢獻者授權協議」。
存放區結構
所有剖析器都位於 GitHub 存放區 Content Hub 區域的頂層 parsers/ 目錄中。每個記錄來源都有專屬的子目錄。
content-hub/
└── content/
└── parsers/
├── third_party/
│ ├── community/
│ │ ├── VENDOR1_PRODUCT1/cbn/
│ │ └── VENDOR2_PRODUCT2/cbn/
│ ├── partnerA/
│ │ └── VENDOR1_PRODUCT1/cbn/
│ └── partnerB/
│ └── VENDOR1_PRODUCT1/cbn/
...
資料夾命名慣例
third_party/community/parser 存放區中所有子目錄的資料夾命名慣例都有嚴格定義。這些標準可確保系統相容性、客戶發現度,以及符合 Google SecOps 內部慣例。
在 GitHub 建立社群剖析器
下一節將詳細說明如何建立及管理社群剖析器。
尋找及下載社群剖析器
- 前往所需的記錄類型資料夾。
- 查看
metadata.json檔案,確認是否有與剖析器支援的記錄來源相關的參照。 - 下載
parser.conf檔案,其中包含 CBN 語法的核心剖析器邏輯。
在 Google SecOps 中部署社群剖析器
下列步驟說明如何複製社群剖析器,並轉換為自己的自訂剖析器執行個體。部署完成後,剖析器會做為您維護的自訂剖析器運作。
- 在 Google SecOps 執行個體中,依序前往「設定」>「資料管理」>「剖析器」,然後在「建立剖析器」頁面的對應欄位中,上傳或貼上
下載的
parser.conf檔案內容。如果使用的是 SIEM 專用平台,請依序前往「設定」>「剖析器」。
驗證自訂剖析器
在 Google SecOps 執行個體中部署剖析器後,系統會自動觸發內建的自訂剖析器驗證,檢查是否有潛在的管道故障或正規化問題。如果驗證失敗,請修正剖析器邏輯,或修改剖析器副本,以符合特定用途。我們鼓勵您將修正或強化內容貢獻回社群存放區,積極參與開放原始碼社群。
如要進一步瞭解如何在 GitHub 中提供新的剖析器或更新現有剖析器,請參閱 GitHub 剖析器操作說明。
如果整合時遇到任何問題,請在 GitHub 建立案件。Google 支援不涵蓋社群剖析器。
還有其他問題嗎?向社群成員和 Google SecOps 專家尋求解答。