Imperva WAF Gateway 實戰課程

單元 7:Site Tree 與 Web Service 設定

講師導言

Gateway 註冊上線後,它還不知道「要保護誰」。Site Tree 就是在告訴 WAF:哪些伺服器 IP、哪些埠、哪些 TLS 金鑰、哪些 host 屬於哪個應用。 政策要套在 Site Tree 的物件上才會生效,Dynamic Profiling 也以 Web Application 為單位學習,所以這一層切得好不好,直接決定第 8、9 章能不能調得動。 很多「明明設了政策卻沒反應」的問題,根源都在這一章。

Goals 本章學習目標

範例環境:Site HQ > SG-Shop > HTTPS-Shop > shop / member;對外網站 shop.example.com。

一、四個層級與各自的用途

用大樓來想

  • Site 像一棟大樓(機房、事業單位的分群),本身不做檢查。
  • Server Group 像一層樓的門禁:這層有哪些房間(伺服器 IP),第一道關卡在這裡。
  • Web Service 像這層的走廊與大門:哪個埠、用什麼鑰匙(TLS)進出。
  • Web Application 像房間裡的各個辦公室:哪個 host、哪條路徑,各有自己的規矩(Web Profile)。
Site Tree 四層結構:Site HQ 下有 Server Group SG-Shop,其下有 Web Service HTTPS-Shop,再下有兩個 Web Application:shop 與 member,每層標註在該層生效的政策 Site:HQ 純容器,沒有政策 Server Group:SG-Shop 伺服器 IP、Operation Mode Firewall、網路協定驗證、Stream Signature Web Service:HTTPS-Shop 埠、TLS 金鑰、錯誤頁、Reverse Proxy HTTP Protocol Validation / Signatures Service Correlated Validation / Custom App:shop 商品、搜尋 Web Profile 應用層政策 App:member 登入、個資 Web Profile 應用層政策
層級定義什麼在這層生效的政策(例)
Site組織上的分群(機房、事業單位)無,純容器
Server Group一組提供相同服務的伺服器 IP、運作模式Firewall、Network Protocol Validation、Stream Signature
Web Service埠、TLS、字元集、靜態檔清單、錯誤頁、Reverse ProxyHTTP Protocol Validation、HTTP Protocol Signatures、Web Service Correlated Validation、Web Service Custom
Web Application哪些 host / URL 屬於這個應用;一個 Application 對應一份 Web ProfileWeb Profile、Web Application Signatures、Web Application Custom、Bot Mitigation、Anti Scraping

官方描述的檢查順序

流量進來時,先在 Server Group 層(第一個封包就套 Firewall 等政策),再看 Service 層的協定(例如 HTTP Protocol Validation),最後在 Application 層檢查請求本身(參數型別、長度)。政策類型細節見第 9 章。

所有 Site Tree 操作都在 Main > Setup > Sites。變更後按 Save;若系統是 delayed activation mode(延遲生效模式),還要再執行 Activate 才會生效。

二、動手做:建立 Site 與 Server Group

https://10.0.30.10:8083
Imperva MX MainAdmin
Main > Setup > Sites
1Sites TreeNew(先點選 Site HQ,再按標題列的 New)
▾ Site HQ
Create Server Group
2名稱SG-Shop
3Create4Save
示意畫面:部分欄位名稱待實機確認(建立 Site 的按鈕位置、對話框欄位標籤),版面以實機為準。
  1. 1Main > Setup > Sites,建立 Site HQ(Sites Tree 標題列 New)【待實機確認:建立 Site 的按鈕位置,官方另有 Creating a New Site 頁】。點選 Site HQ,在 Sites Tree 標題列按 New,出現 Create Server Group 對話框。
  2. 2輸入名稱 SG-Shop。
  3. 3按 Create。
  4. 4再按 Save。

Server Group 的分頁

分頁內容
Definitions名稱、Operation Mode 等
Services and Ports這組伺服器上偵測到 / 定義的服務與埠
Servers受保護伺服器的 IP
Applied Policies已套用在這個 Server Group 的政策

Servers:要填哪些 IP

WAF 只檢查「目的 IP 在 Server Group 裡」的流量,IP 漏填等於沒保護。要填哪些,取決於 Gateway 相對 LB 的位置(第 5 章):

Gateway 位置看到的目的 IPSG-Shop Servers 要填
LB 前(外側)LB VIP10.0.10.20(若 NAT 前就檢查,填對外 VIP 203.0.113.20【推論:依實際拓樸】)
LB 後(LB 與 Web 之間)各節點實 IP10.0.10.21、10.0.10.22;擴容加 web03 時要記得補

伺服器 IP 欄位的實際輸入方式(單筆 / 範圍 / 自動探索)【待實機確認】。

Operation Mode

https://10.0.30.10:8083
Main > Setup > Sites > SG-Shop
DefinitionsServices and PortsServersApplied Policies
1NameSG-Shop
2Operation ModeSimulation(Active / Simulation / Disabled)
3Save
示意畫面:欄位名稱依 Imperva 官方文件,版面、按鈕位置與配色以實機為準。
  1. 1Main > Setup > Sites,點選 SG-Shop,點 Definitions 分頁。
  2. 2在 Operation Mode 選擇 Active、Simulation 或 Disabled。
  3. 3按 Save(delayed activation 模式下需再 Activate)。
模式用途
Active依政策動作執行(含阻擋)
Simulation只告警不阻擋【推論:依名稱與官方「三種模式」描述;完整定義在 Server Group Definition Parameters 頁】,上線初期與學習期用
Disabled不處理此 Server Group 流量

三、動手做:建立 Web Service

https://10.0.30.10:8083
Main > Setup > Sites > SG-Shop > Create Service
1名稱HTTPS-Shop
2類型HTTP Service
3Create
Sites Tree(建立後)
▾ Site HQ
  ▾ SG-Shop
    ▾ HTTPS-Shop
      • 預設 HTTP application
示意畫面:欄位名稱依 Imperva 官方文件,版面、按鈕位置與配色以實機為準。
  1. 1Main > Setup > Sites,在 Sites Tree 點選 SG-Shop,標題列按 New,出現 Create Service 對話框。名稱輸入 HTTPS-Shop。
  2. 2下拉選單選 HTTP Service。
  3. 3按 Create。新 service 會連同一個預設 HTTP application 一起出現在 Sites Tree。

官方註明:同一個 Server Group 下可以建多個 service、各監看不同埠;同一個 service 也可以有多個埠。Web Service 的分頁有:Definitions、Operations、Reverse Proxy、Applications、Applied Policies。

Definitions 分頁欄位

欄位說明HTTPS-Shop 範例
Name必填HTTPS-Shop
HTTP Ports要解析的明文 HTTP 埠,預設 8080(若只走 HTTPS 可留 80 供轉址檢查)
Character Sets預設字元集,預設 Western European (Windows)中文站台建議改為 UTF-8【推論】
Static Files靜態檔清單,預設 Default Static File List預設即可
Encryption Support > TLS Key Name已安裝的 TLS 金鑰shop.example.com 的金鑰
Encryption Support > TLS PortsTLS 流量的埠,逗號分隔443
Plug-ins已安裝的外掛—
Error Page預設錯誤頁設定(見第五節)—

四、TLS:金鑰、TLS Settings 與 SNI

WAF 要檢查 HTTPS 內容,必須能解密。現行版本分三個地方設定:

設定位置說明
伺服器金鑰(憑證 + 私鑰)Web Service > Definitions > Encryption Support(Adding TLS Keys)被動 / Bridge 模式用私鑰解密;Reverse Proxy 用它終結 TLS
Cipher、ECC、TLS 協定版本Global Objects 的 TLS Settings(v14.4 起)全域物件,可被多個 service 引用
SNIservice 的 Reverse Proxy 頁(v14.3 起)同一 IP:443 承載多個憑證時使用
HSMnCipher card / netHSM;v15 起支援 Thales Luna Network HSM【16.0】CA 版不支援 Luna / nCipher HSM

匯入金鑰步驟

  1. 1Main > Setup > Sites > SG-Shop > HTTPS-Shop > Definitions。
  2. 2在 Encryption Support 區新增 TLS Key【待實機確認:按鈕名稱】。
  3. 3上傳 shop.example.com 的憑證與私鑰(支援格式:舊簡報列 PKCS、PEM,現行格式清單【待實機確認】)。
  4. 4在 TLS Ports 填 443,按 Save。

模式決定能不能解密

能否解密比較:Sniffing 與純 Bridge 只能解 TLS 1.2 靜態 RSA;TLS 1.3 或 ECDHE、DHE 只有 Reverse Proxy 與 ABR 支援 Sniffing、純 Bridge 只能解 TLS 1.2 的 TLS_RSA_* (靜態 RSA 金鑰交換) TLS 1.3、ECDHE / DHE:解不開 DHE 明確不支援 Sniffing Reverse Proxy(NGRP)、ABR 支援 TLS 1.3、ECDHE / DHE(PFS) 用 service 的金鑰終結 TLS 匯入私鑰也解不開時:先查 cipher,再查金鑰 告警會只剩網路層

實務意義

shop.example.com 若對外只開 TLS 1.3 / ECDHE,Gateway 用 Sniffing 時匯入了私鑰也解不開,告警會只剩網路層。要嘛改 NGRP / ABR,要嘛把解密交給 LB 後在 LB 與 Web 之間檢查明文(第 5 章)。

五、Error Page 與 Forwarded Connections

Error Page(Definitions 分頁 > Error Page)

選項行為
Use Default Error Page違規被阻擋時顯示預設錯誤頁
Redirect以 302 代表受保護伺服器轉址到指定 URL
Page用 HTML 加預定義 placeholder 自訂內容
HTTP Response Code錯誤頁回應的狀態碼
Web Error Page Policies依違規類型送不同錯誤頁

Sniffing 模式只能對伺服器端送 TCP reset,用戶端看不到錯誤頁(第 4 章);錯誤頁設定只在 inline 模式有意義。建議在錯誤頁放「事件編號」placeholder,讓客服能把使用者回報對應到 MX 告警【待實機確認:placeholder 名稱】。

Forwarded Connections

流量若經過 LB 或 proxy 做了 SNAT,WAF 看到的來源 IP 會全部是 LB 的 IP,信譽過濾(第 10 章)與依 IP 的告警全部失準。Forwarded Connections 用來告訴 WAF「從哪些 proxy 來的連線,真實用戶端 IP 要從哪個 header(如 X-Forwarded-For)取」【推論:依舊簡報與一般用途;現行欄位名稱與所在分頁【待實機確認】】。

六、Web Application:host 對應與拆分

建立 Application

  1. 1Main > Setup > Sites,展開 SG-Shop > HTTPS-Shop。標題列按 New,出現 Create Application 對話框。
  2. 2輸入 member,按 Create,再按 Save。

Host/URL 對應

在 service 的 Applications 分頁設定 Host/URL to Application Mapping,決定哪個 host(以及哪些 URL 路徑)歸哪個 application,並有優先順序【待實機確認:欄位名稱與比對順序規則】。

https://10.0.30.10:8083
Main > Setup > Sites > SG-Shop > HTTPS-Shop
DefinitionsOperationsReverse ProxyApplicationsApplied Policies
Host/URL to Application Mapping
優先序HostURL 前綴Application
1shop.example.com/member/member
2shop.example.com(全部)shop
—其他—預設 application
示意畫面:部分欄位名稱待實機確認(對應表欄位與比對順序規則),版面以實機為準。

為什麼要拆

一個 Application 對應一份 Web Profile。member(登入、個資、改密碼)與 shop(商品瀏覽、搜尋)的參數型態與敏感度完全不同,混在一起學會讓 profile 變得過寬(搜尋框允許任意字串,連帶讓登入欄位也放寬)。原則:

七、動手玩:請求落點判斷

輸入一個請求的目的 IP、埠、host 與路徑,看看它會落到哪個 Server Group、Web Service、Web Application,以及在每一層會被哪類政策檢查。也可以切換 Gateway 位置、Operation Mode 與 TLS 條件,觀察 Servers 漏填或解不開 TLS 的後果。

環境設定

這個請求

比對過程

教學用簡化:「埠不在 HTTPS-Shop 內就不歸這個 service」與 host 對應的比對順序,屬推論或待實機確認。Reverse Proxy 依 RP 規則對應,本模擬以 inline 透通模式示意。

八、常見踩坑

政策不會往下繼承

官方明講,政策套在 Server Group 之後才新建的 child service 不會自動繼承該政策;新增 service / application 後要回各政策的 Apply To 分頁補勾。

LB 後擴容忘記加 IP

Servers 沒列的實 IP 流量直接不受保護,且不會有告警提醒。

忘了 Activate

delayed activation 模式下只按 Save 不會生效,常被誤判成「政策沒作用」。

匯了金鑰還是看不到 HTTPS 內容

多半是 TLS 1.3 / ECDHE 遇上 Sniffing 或 Bridge;先查 cipher 再查金鑰。

SNAT 後來源 IP 全一樣

沒設 Forwarded Connections,信譽與依 IP 的政策全部失準。

字元集用預設 Western European

中文參數可能被誤判為異常編碼【推論】。

九、新舊對照

舊版說法與現況

舊說法現況
Site > Server Group > Service > Application層級不變;GUI 名稱為 Web Service、Web Application,建立時選 HTTP Service
在 Service 匯入 SSL 公鑰憑證與私鑰金鑰仍在 service 的 Encryption Support;cipher / ECC / 協定版本 v14.4 起移到 Global Objects > TLS Settings;SNI v14.3 起在 Reverse Proxy 頁
未提 TLS 版本與 cipherSniffing / Bridge 只解 TLS 1.2 靜態 RSA;TLS 1.3 / PFS 需 NGRP 或 ABR
每個 Service 自動建立 Default Application仍成立:建立 service 時會一併建立預設 HTTP application
Error Page:Default、Redirect、HTML同樣三種,另有 HTTP Response Code 與 Web Error Page Policies;Redirect 明確為 302
Reverse Proxy 子模式含 kernel 層KRP 已於 v14.1 移除,改 NGRP(第 4 章)

Quiz 隨堂測驗

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