收集 Cloudflare WAF 記錄
剖析器版本:6.0
支援的服務:
Google SecOps
SIEM
這個剖析器會從 Cloudflare 網頁應用程式防火牆 (WAF) JSON 記錄擷取欄位,並轉換及對應至 Unified Data Model (UDM)。這個剖析器會處理各種 Cloudflare 動作,並在將輸出內容結構化為 UDM 格式前,使用中繼資料和網路資訊充實資料。
事前準備
請確認您已完成下列事前準備:
- Google Security Operations 執行個體。
- Google Cloud的特殊存取權。
- Cloudflare Enterprise 方案。
- Cloudflare 的特殊存取權。詳情請參閱 Cloudflare。
建立 Cloud Storage bucket
- 登入 Google Cloud 控制台
前往「Cloud Storage Buckets」頁面。
點選「建立」。
設定 bucket:
- 「Name」(名稱):輸入符合 bucket 名稱規定的不重複名稱 (例如 cloudflare-waf)。
- 選擇資料的儲存位置:選取位置。
- 為資料選擇儲存空間級別:選取 bucket 的預設儲存空間級別,或選取「Autoclass」,讓系統自動管理儲存空間級別。
- 選擇如何控管物件存取權:選擇「不」強制執行公開存取防護,並為 bucket 物件選取存取控管模式。
- 儲存空間級別:依需求選擇 (例如「Standard」)。
點選「建立」。
將 bucket 權限授予 Cloudflare IAM 使用者
- 在 Google Cloud中,依序前往「Storage」>「瀏覽器」>「Bucket」>「權限」。
- 新增帳戶 logpush@cloudflare-data.iam.gserviceaccount.com ,並授予 Storage 物件管理員權限。
使用 Cloudflare UI 建立 WAF 記錄的 Logpush 工作
- 登入 Cloudflare。
- 依序前往「Analytics & Logs」>「Logpush」。
- 選取「Create a Logpush job」。
- 在「選取目的地」中,選擇「Google Cloud Storage」。
- 輸入下列目的地詳細資料:
- Bucket:Cloud Storage bucket 名稱
- 路徑:儲存容器中的 bucket 位置
- 選取「將記錄檔整理到每日子資料夾」
- 按一下「繼續」。
- 選取要推送至儲存空間的「Security (WAF)」資料集。
- 設定記錄推送工作:
- 輸入工作名稱。
- 在「如果記錄相符」下方,您可以選取要從記錄中加入或移除的事件。詳情請參閱「篩選器」。只有部分資料集提供這個選項。
- 在「Send the following」(傳送下列項目) 欄位中,您可以選擇將所有記錄推送至儲存目的地,或選擇要推送哪些記錄。
- 按一下「提交」。
設定動態饋給
如要設定動態饋給,請按照下列步驟操作:
- 依序前往「設定」>「資料管理」>「動態饋給」。如果使用的是 SIEM 專用平台,請依序前往「設定」>「動態饋給」。
- 按一下「新增動態饋給」。
- 在下一頁,點按「設定單一動態饋給」。
- 在「Feed name」(動態饋給名稱) 欄位中,輸入動態饋給名稱 (例如 Cloudflare WAF Logs)。
- 選取「Google Cloud Storage V2」做為「來源類型」。
- 選取「Cloudflare WAF」做為「記錄類型」。
- 按一下「Get Service Account」(取得服務帳戶)。
- 點選「下一步」。
指定下列輸入參數的值:
- Storage Bucket URI:Cloud Storage 網址。
- 來源刪除選項:根據偏好選取刪除選項。
點選「下一步」。
在「完成」畫面中檢查新的新聞動態消息設定,然後按一下「提交」。
UDM 對應表
| 記錄欄位 | UDM 對應 | 邏輯 |
|---|---|---|
Action |
security_result.action_details |
原始記錄中的 Action 值會直接指派給這個 UDM 欄位。 |
Action |
security_result.action |
這個欄位的值衍生自原始記錄中的 Action 欄位。如果 Action 為「allow」,UDM 欄位會設為 ALLOW。如果 Action 為「challengeSolved」、「jschallengeSolved」、「managedchallengenoninteractivesolved」或「managedchallengeinteractivesolved」,UDM 欄位會設為 ALLOW_WITH_MODIFICATION。如果 Action 為「drop」、「block」或「connectionclose」,UDM 欄位會設為 BLOCK。如果 Action 為「challengefailed」或「jschallengefailed」,UDM 欄位會設為 FAIL。否則會設為 UNKNOWN_ACTION。 |
ClientASN |
network.asn |
原始記錄中的 ClientASN 值會轉換為字串,然後直接指派給這個 UDM 欄位。 |
ClientASNDescription |
additional.fields.key |
索引鍵會靜態設為「ClientASNDescription」。 |
ClientASNDescription |
additional.fields.value.string_value |
原始記錄中的 ClientASNDescription 值會直接指派給這個 UDM 欄位。 |
ClientCountry |
principal.location.country_or_region |
原始記錄中的 ClientCountry 值會直接指派給這個 UDM 欄位。 |
ClientIP |
principal.ip |
原始記錄中的 ClientIP 值會直接指派給這個 UDM 欄位。 |
ClientRefererHost |
intermediary.hostname |
原始記錄中的 ClientRefererHost 值會直接指派給這個 UDM 欄位。 |
ClientRefererPath |
network.http.referral_url |
原始記錄中的 ClientRefererPath 值會直接指派給這個 UDM 欄位。 |
ClientRequestHost |
target.hostname |
原始記錄中的 ClientRequestHost 值會直接指派給這個 UDM 欄位。 |
ClientRequestMethod |
network.http.method |
原始記錄中的 ClientRequestMethod 值會直接指派給這個 UDM 欄位。 |
ClientRequestPath |
target.file.full_path |
原始記錄中的 ClientRequestPath 值會直接指派給這個 UDM 欄位。 |
ClientRequestProtocol |
network.application_protocol |
系統會使用 grok 擷取 ClientRequestProtocol 的通訊協定部分 (例如「HTTP/1.1」中的「HTTP」),轉換為大寫,並指派給這個 UDM 欄位。 |
ClientRequestUserAgent |
network.http.user_agent |
原始記錄中的 ClientRequestUserAgent 值會直接指派給這個 UDM 欄位。 |
Datetime |
metadata.event_timestamp |
原始記錄中的 Datetime 值會剖析為 RFC 3339 時間戳記,並指派給這個 UDM 欄位。 |
EdgeColoCode |
additional.fields.key |
金鑰會靜態設為「EdgeColoCode」。 |
EdgeColoCode |
additional.fields.value.string_value |
原始記錄中的 EdgeColoCode 值會直接指派給這個 UDM 欄位。 |
EdgeResponseStatus |
network.http.response_code |
原始記錄中的 EdgeResponseStatus 值會直接指派給這個 UDM 欄位,並轉換為整數。 |
Kind |
metadata.product_event_type |
原始記錄中的 Kind 值會直接指派給這個 UDM 欄位。 |
Metadata.filter |
target.resource.attribute.labels.value |
原始記錄中的 Metadata.filter 值會指派給 target.resource.attribute.labels 內標籤的 value 欄位。這個標籤的key會靜態設為「中繼資料篩選器」。 |
Metadata.type |
target.resource.attribute.labels.value |
原始記錄中的 Metadata.type 值會指派給 target.resource.attribute.labels 內標籤的 value 欄位。這個標籤的 key 會靜態設為「中繼資料類型」。這個欄位的值是根據 ClientIP、ClientRequestHost 和 app_protocol 的存在與否和值衍生而來。如要瞭解特定邏輯,請參閱剖析器程式碼。將靜態值設為「Cloudflare」。靜態設為「Cloudflare log Aggregator」。靜態值設為「CLOUDFLARE_WAF」。 |
RayID |
metadata.product_log_id |
原始記錄中的 RayID 值會直接指派給這個 UDM 欄位。 |
RuleID |
security_result.rule_id |
原始記錄中的 RuleID 值會直接指派給這個 UDM 欄位。 |
Source |
security_result.rule_name |
原始記錄中的 Source 值會直接指派給這個 UDM 欄位。 |
timestamp |
metadata.event_timestamp,events.timestamp |
原始記錄中的 timestamp 值會直接指派給這些 UDM 欄位。 |
變更記錄
還有其他問題嗎?向社群成員和 Google SecOps 專業人員尋求解答。