收集 Cloudflare WAF 記錄

剖析器版本:6.0

支援的服務:

這個剖析器會從 Cloudflare 網頁應用程式防火牆 (WAF) JSON 記錄擷取欄位,並轉換及對應至 Unified Data Model (UDM)。這個剖析器會處理各種 Cloudflare 動作,並在將輸出內容結構化為 UDM 格式前,使用中繼資料和網路資訊充實資料。

事前準備

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

  • Google Security Operations 執行個體。
  • Google Cloud的特殊存取權。
  • Cloudflare Enterprise 方案。
  • Cloudflare 的特殊存取權。詳情請參閱 Cloudflare。

建立 Cloud Storage bucket

  1. 登入 Google Cloud 控制台
  2. 前往「Cloud Storage Buckets」頁面。

    前往「Buckets」

  3. 點選「建立」。

  4. 設定 bucket:

    • 「Name」(名稱):輸入符合 bucket 名稱規定的不重複名稱 (例如 cloudflare-waf)。
    • 選擇資料的儲存位置:選取位置。
    • 為資料選擇儲存空間級別:選取 bucket 的預設儲存空間級別,或選取「Autoclass」,讓系統自動管理儲存空間級別。
    • 選擇如何控管物件存取權:選擇「不」強制執行公開存取防護,並為 bucket 物件選取存取控管模式。
    • 儲存空間級別:依需求選擇 (例如「Standard」)。
  5. 點選「建立」。

將 bucket 權限授予 Cloudflare IAM 使用者

  1. 在 Google Cloud中,依序前往「Storage」>「瀏覽器」>「Bucket」>「權限」。
  2. 新增帳戶 logpush@cloudflare-data.iam.gserviceaccount.com ,並授予 Storage 物件管理員權限。

使用 Cloudflare UI 建立 WAF 記錄的 Logpush 工作

  1. 登入 Cloudflare。
  2. 依序前往「Analytics & Logs」>「Logpush」。
  3. 選取「Create a Logpush job」。
  4. 在「選取目的地」中,選擇「Google Cloud Storage」。
  5. 輸入下列目的地詳細資料:
    • Bucket:Cloud Storage bucket 名稱
    • 路徑:儲存容器中的 bucket 位置
    • 選取「將記錄檔整理到每日子資料夾」
  6. 按一下「繼續」。
  1. 選取要推送至儲存空間的「Security (WAF)」資料集。
  2. 設定記錄推送工作:
    • 輸入工作名稱。
    • 在「如果記錄相符」下方,您可以選取要從記錄中加入或移除的事件。詳情請參閱「篩選器」。只有部分資料集提供這個選項。
    • 在「Send the following」(傳送下列項目) 欄位中,您可以選擇將所有記錄推送至儲存目的地,或選擇要推送哪些記錄。
  3. 按一下「提交」。

設定動態饋給

如要設定動態饋給,請按照下列步驟操作:

  1. 依序前往「設定」>「資料管理」>「動態饋給」。如果使用的是 SIEM 專用平台,請依序前往「設定」>「動態饋給」。
  2. 按一下「新增動態饋給」。
  3. 在下一頁,點按「設定單一動態饋給」。
  4. 在「Feed name」(動態饋給名稱) 欄位中,輸入動態饋給名稱 (例如 Cloudflare WAF Logs)。
  5. 選取「Google Cloud Storage V2」做為「來源類型」。
  6. 選取「Cloudflare WAF」做為「記錄類型」。
  7. 按一下「Get Service Account」(取得服務帳戶)。
  8. 點選「下一步」。
  9. 指定下列輸入參數的值:

    • Storage Bucket URI:Cloud Storage 網址。
    • 來源刪除選項:根據偏好選取刪除選項。
  10. 點選「下一步」。

  11. 在「完成」畫面中檢查新的新聞動態消息設定,然後按一下「提交」。

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