Imperva WAF Gateway 實戰課程

單元 11:進階情境

講師導言

前面幾章把「站台怎麼掛上去、怎麼學、怎麼擋」都講完了。這一章收錄五個進階功能:用外部資料豐富比對條件的 Lookup Data Sets、追蹤登入者身分的 User Tracking、在記錄裡遮蔽敏感資料的 Data Masking、把弱點掃描結果轉成防護的 Web Scanner 整合,以及把 WAF Gateway 當成 API 流量感測器的 API Security Anywhere sensor。 它們都不是上線第一天必須開的功能,但碰到基本政策處理不了的情境時,就是你的備用武器。

Goals 本章學習目標

一、功能地圖:五個進階功能

進階功能地圖:Lookup Data Sets、User Tracking、Data Masking、Web Scanner 整合、API Security Anywhere sensor 各自解決的問題 1 Lookup Data Sets 政策要比對名單或外部屬性 2 User Tracking 告警看到「哪個帳號」,依帳號封鎖 3 Data Masking 記錄裡不留密碼、卡號 4 Web Scanner 整合 程式還沒修,先用 WAF 虛擬修補 5 API Security Anywhere Gateway 當 API 流量感測器 只支援 ABR、NGRP
功能解決什麼問題前提現況
Lookup Data Sets(查詢資料集)政策要比對「名單」或「外部屬性」(例如合作夥伴 IP、停權帳號)無,屬 Global Object(全域物件)仍存在,有預設資料集與 REST API
Web Application User Tracking(應用程式使用者追蹤)告警裡要看到「哪個帳號」而不只是 IP;依帳號封鎖網站有表單登入仍存在;Universal User Tracking (UUT) 已於 v14.2 移除
Data Masking(資料遮罩)告警與稽核記錄不能留下密碼、卡號等敏感資料無仍存在
Web Scanner 整合弱點已被掃到、程式還沒修,先用 WAF 擋(Virtual Patching,虛擬修補)支援的第三方掃描器報告仍存在
API Security Anywhere sensor需要 API 盤點、BOLA 等 API 專屬防護地端 Controller;Gateway 跑 NGRP 或 ABRv15.3 Patch 10 起;v15.4 起強化

二、Lookup Data Sets:讓政策去「查名單」

用門口的訪客名冊來想

警衛只看來客的臉,沒辦法知道他是不是合作夥伴。但手邊有一本名冊,拿來客的名字去查,就知道該不該放行。Lookup Data Set 就是那本名冊。

Lookup Data Set 是一張「鍵值 + 屬性」的表。政策比對時,用請求裡的某個值(例如來源 IP、帳號)去查表,取回屬性再判斷。它讓「只靠請求本身資訊做不到」的政策變得可行,舊簡報稱之為 Data Enrichment(資料豐富化)(舊簡報 p.69–70)。

建立來源

依官方 Creating a Lookup Data Set。

來源適用情境
Manually筆數少、變動少的名單(例如 5 個合作夥伴 IP)
From a CSV File由其他系統匯出的清單,定期重新匯入
From ThreatRadar威脅情資服務使用的資料集(見第 10 章)
From an External System直接連資料庫或外部系統抓資料
From ADC Template由 ADC 維護的範本(標準資料庫結構、LDAP 資訊)

預設資料集(節錄,WAF 相關)

名稱用途
IP Addresses of Known Anonymous Proxies已知匿名代理 IP;屬威脅情資的一部分,由 ADC 自動更新
User Roles - From Active Directory (no domain / with domain)從 LDAP 取使用者、部門、群組,讓告警與報表顯示易讀的使用者名稱;需先在 Query 頁指定 External System

其餘預設資料集(如 Default Database Account Mapping)屬資料庫稽核用途,WAF 用不到。

動手做:會員 API 停權帳號清單

目標:讓 member 應用程式的登入請求,若帳號在停權名單裡就觸發政策。

https://10.0.30.10:8083
Imperva MX MainAdmin
Main > Setup > Global Objects
2CategoryLookup Data Sets
2SourceFrom a CSV File
Data Set Nameblocked-accounts
3Key ColumnFirst column (account)
Attribute Column(select as needed)
3Import
示意畫面:官方文件僅寫到「選 From a CSV File、指定鍵值欄位與屬性欄位」,因此畫面上 Category、Source、Data Set Name、Key Column、Attribute Column、Import 等英文標籤待實機確認(依序為類別、資料來源、資料集名稱、鍵值欄位、屬性欄位、匯入),版面與按鈕位置以實機為準。
  1. 1由會員系統匯出停權帳號,存成 blocked-accounts.csv(第一欄為帳號)。
  2. 2進入 Main > Setup > Global Objects,選 Lookup Data Sets 類別,新增資料集並選 From a CSV File【待實機確認】。
  3. 3指定鍵值欄位與屬性欄位,匯入後檢查筆數。
  4. 4到 Main > Policies > Security,新增 Web Service Custom(或 Web Application Custom)政策,比對條件選擇 lookup 類條件,指定「帳號參數值存在於 blocked-accounts」【待實機確認】。
  5. 5套用到 Site Tree 的 SG-Shop > HTTPS-Shop > member,Action 先設為只告警,觀察一週後再改阻擋(處置設定見第 9 章)。

實務建議

  • 名單要有「擁有者」與更新週期。CSV 匯入是一次性的,來源系統更新後要重新匯入,否則政策會依過期資料判斷。
  • 資料集也能透過 REST API 維護(WAF API Reference Guide 有 Lookup Data Set 相關方法),適合讓會員系統在停權時自動推送(REST API 登入方式見第 12 章)。
  • 舊簡報寫上限為 1 百萬筆(舊簡報 p.69);現行版本的筆數上限未查到官方數字【待實機確認】。大型名單先在測試環境確認匯入時間與 MX 負載。

三、Web Application User Tracking:告警裡看得到「是誰」

WAF 預設只知道 IP 與 session。啟用 User Tracking 後,Gateway 會辨識「登入動作」:哪個 URL 是登入表單送出的位置(Action URL)、哪個欄位是帳號、登入成功或失敗。之後同一個 session 的違規告警就會帶上使用者名稱,並可對「使用者」做監控或封鎖(Action Interface 的 User Monitor、User Block,見第 12 章)。

系統判斷登入結果的依據

官方 Web Profile – Web Application User Tracking Report 的欄位,可看出系統記錄哪些資訊。

https://10.0.30.10:8083
Imperva MX MainAdmin
Web Profile – Web Application User Tracking Report
Login URL / Action URLAction URL Field 1 / Field 2Redirect URL ValueResponse Code ValueLogin ResultStatus
/member/loginemail / password/member/home302Succeededin protection
/member/loginemail / password/member/login200Failedin protection
示意畫面:欄位名稱依 Imperva 官方文件,列內容為依範例環境推演的示意值,版面以實機為準。
欄位意義
Login URL / Action URL登入頁 / 表單實際送出的 URL
Action URL Field 1 / Field 2使用者識別欄位,例如帳號、密碼欄位名稱
Redirect URL Value登入後被導向的 URL(成功與失敗通常不同)
Response Code Value登入後回應碼
Login Result / Default DecisionSucceeded、Failed、Can't Tell
Statuslearning、in protection、manual

從 Status 欄位可知,登入行為也是 Dynamic Profiling 學出來的(learning → in protection),也可以手動指定(manual)。學習機制見第 8 章。

範例環境的登入特徵

項目member 應用程式
登入頁https://shop.example.com/member/login
表單送出POST /member/login,欄位 email、password
成功302 導向 /member/home
失敗200,停留在 /member/login

設定步驟

  1. 1先讓 member 應用程式學習至少一段時間,確認 Web Profile 已出現 /member/login。
  2. 2在 Site Tree 選 member 應用程式,開啟 User Tracking 相關設定頁【待實機確認】。
  3. 3若系統沒有自動學到,手動指定 Action URL、帳號欄位(email),以及成功的判斷條件(導向 /member/home 或回應碼 302)【待實機確認】。
  4. 4以測試帳號各做一次成功與失敗登入,到 Web Profile – Web Application User Tracking 報表確認 Login Result 判斷正確。

注意

密碼欄位雖然會被識別,但一定要搭配下一節的 Data Masking,避免密碼值出現在告警明細。

四、Data Masking 與敏感資料字典

WAF 告警會記錄觸發違規的參數值。如果違規剛好發生在登入或結帳頁,記錄裡可能出現密碼、信用卡號、身分證字號。Data Masking 讓這些值在寫入 SecureSphere 記錄前就被換成星號。官方說明:遮罩後原始資料從記錄中刪除且無法取回,星號數等於被隱藏的位元組數。

Data Masking 只影響 WAF 記錄:請求原樣送往伺服器,寫入記錄前敏感值被換成星號 使用者送出登入請求 password=Abc12345 WAF Gateway 依遮罩設定處理「要寫進記錄的值」 原樣 先遮罩 伺服器 收到的內容 完全不變 WAF 記錄 password=******** 無法取回

兩種做法

官方 Configuring Sensitive Data Protection。

做法比對依據範例
Sensitive Data Dictionaries(敏感資料字典)值的樣式(pattern)信用卡號、美國社會安全碼等預設樣式;也可自訂
Masking Data in Elements(依元素遮罩)參數/元素名稱password、cvv 不管內容是什麼都遮

字典可以被政策引用,也可以直接掛在 service 上;字典以 Sensitive Data Dictionary Groups 管理,依元素遮罩則用 Data Masking List 管理。

範例環境建議清單

類型項目理由
依元素遮罩password、new_password、cvv、otp欄位名固定,用名稱比對最準
字典信用卡號(預設)卡號可能出現在任何參數
自訂字典台灣身分證字號樣式(1 碼英文 + 9 碼數字)預設字典以美國格式為主,需自訂【推論】

要分清楚的三件事

五、Web Scanner 整合與 Virtual Patching

弱點掃描找到 SQL injection 之後,程式修補、測試、上線常要數週。這段期間,WAF 可以依掃描報告產生針對性政策先擋住,這就是 Virtual Patching(虛擬修補)。

官方流程三步驟

步驟動作說明
1Run a Scan and Prepare Results用支援的第三方掃描器掃描,匯出結果檔
2Create a Scanner Integration Policy匯入掃描結果,建立整合政策
3Run Web Scanner Assessment Job執行評估工作,對掃到的弱點產生防護

範例:/member/orders?id= 有 SQL injection

對 shop.example.com 掃描後發現 /member/orders?id= 有 SQL injection。

  1. 1掃描範圍限定 https://shop.example.com/member/,並在掃描期間把掃描來源 IP 設為 Learning Exception,避免掃描流量污染 Web Profile(見第 8 章)。
  2. 2建立 Scanner Integration Policy,匯入結果檔,套用對象指定 SG-Shop > HTTPS-Shop > member。
  3. 3執行 Web Scanner Assessment Job,檢查產生的防護政策與對應弱點。
  4. 4開發修好之後重新掃描、重新匯入,確認該弱點已不在清單。

注意事項

  • 套用對象要對到正確的 Site Tree 節點,否則產生的政策掛錯地方等於沒有防護(舊簡報 p.88 的「Apply To」提醒仍適用【推論】)。
  • 舊簡報列出的掃描器清單(舊簡報 p.84)多家廠商已併購或改名;現行文件仍保留 WhiteHat Sentinel 章節,完整支援清單與報告格式【待實機確認】。
  • Virtual Patching 是爭取時間,不是修補。追蹤表上要同時記錄「WAF 已防護」與「程式預計修補日」。

六、API Security Anywhere sensor

WAF 擅長擋「攻擊」;API 安全產品擅長「理解 API」(盤點有哪些 endpoint、哪些欄位含敏感資料、是否存在 BOLA 這類授權缺陷)。API Security Anywhere 的做法是讓 WAF Gateway 當感測器(sensor),把非惡意流量(request 與 response)複製給地端的 Controller 分析。

架構重點

官方 Integration with API Security Anywhere。

元件說明
API Security Anywhere Controller以 Kubernetes 為基礎,可裝成獨立 VM 或放在 Kubernetes 叢集;建在 WAF 旁邊
WAF Gateway(sensor)轉送非惡意的 request + response;每個 Gateway Group 一組 sensor 設定
MX設定政策,填入 Controller 與 sensor 資訊
管理介面Cloud Management Console 管 Controller/sensor;API Management Console(雲端或自管)管 API 盤點

連線建立順序

API Security Anywhere 連線建立順序:MX 設定政策、向 Controller 取 token、把 token 發給 Gateway、Gateway 以 gRPC 連到 Controller ① 管理者在 MX 設定政策 填入 Controller 與 sensor 資訊 ② MX 連到 Controller 取得 token ③ MX 把 token 發給所屬 Gateway gw01、gw02 拿到連線憑據 ④ Gateway 以 gRPC(HTTP/2) 連到 Controller,開始送流量 安全模式需在 Controller 與 WAF 兩端 額外設定 ingress controller 或負載平衡器

連線分預設的安全模式與 insecure 模式;安全模式需要在 Controller 與 WAF 兩端額外設定 ingress controller 或負載平衡器。

限制與預設值

  • 只支援 ABR、NGRP 兩種工作模式;Bridge、Sniffing 的 Gateway Group 不能當 sensor(模式說明見第 4 章)。
  • 每個 Server Group 與 Gateway Group 只能有一個政策。
  • Gateway 預設最多送 1000 RPS 或 200 Mbps 給 Controller,可用 Gateway 進階設定調整。
  • Gateway CPU 達預設 90% 時暫停 API 流量轉送,降到 85% 才恢復,以確保 WAF 本業優先。
  • v15.4 起可依 application 粒度設定轉送、預設只送 API 流量,並可接收 Controller 回傳的 BOLA 阻擋決策。

範例環境規劃:api.example.com(203.0.113.21 → 10.0.10.31)若要納入,GG-Shop 必須跑 NGRP 或 ABR;Controller 放在管理網段旁的獨立網段,gw01、gw02 要能連到 Controller 的接收埠(埠號依 Controller 部署方式,【待實機確認】)。

七、動手玩:Lookup 比對與 Data Masking 演示

下面兩個小工具都是教學示意:帳號、名單與測試字串都是範例值,不是真實資料。

演示 A:Lookup Data Set 比對

會員系統目前的停權帳號:alice(停權中)、carol(新停權);bob 之前被停權、現在已解除。政策條件是「帳號參數值存在於 blocked-accounts」。

演示 B:Data Masking

改一改下面的請求參數值,再勾選遮罩設定,看看「寫進 WAF 記錄」的內容有什麼不同。遮罩只影響記錄,送往伺服器的內容不變。

請求參數(可編輯)

遮罩設定

送往伺服器的內容(不變)


                    

寫入 WAF 記錄的內容


                    

演示 B 為教學示意:字典比對的細節(例如信用卡號以 Luhn 檢查、遮到哪一段)以實機行為為準。

八、常見踩坑

Lookup 名單過期

CSV 匯入後就沒人更新,停權已解除的會員還是被擋。名單要排程或用 API 同步。

User Tracking 判斷錯誤

網站登入失敗也回 302(例如導回登入頁加參數),系統把失敗當成功。上線前一定要用測試帳號驗證成功與失敗各一次。

只開 User Tracking、沒開遮罩

密碼欄位值出現在告警明細,稽核反而變成洩漏點。

誤以為 Data Masking 會改流量

它只遮 WAF 的記錄;要阻擋回應中的敏感資料外洩,要靠政策,而且要 inline 模式。

掃描流量污染 Profile

弱點掃描期間沒設 Learning Exception,Web Profile 學到大量攻擊性參數值。

Bridge 模式想接 API Security Anywhere

sensor 只支援 ABR、NGRP,要先規劃模式轉換(見第 4 章)。

九、新舊對照

舊簡報 vs 現行版本

下表左欄是舊簡報的說法,右欄是現行文件查到的現況。

舊簡報說法現況
Web Tagging & Data Enrichment 是一個使用案例,含 Configure Web Tagging(舊簡報 p.68–73)Lookup Data Sets 仍在;「Web Tagging」查無獨立功能名,現行只見 custom policy 的 tag 比對
Lookup Data Set 上限 1 百萬筆(舊簡報 p.69)現行上限未查到【待實機確認】
Universal User Tracking 是競爭優勢之一(舊簡報 p.101–102)UUT 已於 v14.2 移除,保留 Web Application User Tracking(依據:v16.0 Upgrade Guide)
Data Masking 預設字典:信用卡(Luhn)、美國 SSN、Custom(舊簡報 p.140)仍存在,改以 Sensitive Data Dictionary Groups 與 Masking Data in Elements 兩種方式管理(依據:Configuring Sensitive Data Protection)
支援 IBM AppScan、HP WebInspect、NTObjectives、Cenzic、WhiteHat(舊簡報 p.84)流程仍是匯入結果 → Integration Policy → Assessment Job;支援清單需重查(依據:Integrating Web Scanners Task Overview)【待實機確認】
(無)新增 API Security Anywhere sensor(ABR/NGRP)(依據:Integration with API Security Anywhere)

Quiz 隨堂測驗

請點選您認為正確的選項,系統將會顯示解析。