Imperva WAF Gateway 實戰課程

單元 12:監控、稽核與整合

講師導言

WAF 上線之後,工程師每天面對的是告警,而不是政策設定畫面。這一章要搞清楚幾件事:告警(Alert)和違規(Violation)差在哪裡、報表怎麼用、怎麼用 Action Set 把事件送到 Syslog / Splunk / SIEM、怎麼把地端告警匯出到雲端 Attack Analytics,以及怎麼用 REST API 自動化。 一句話總結重點:告警要送得出去、看得懂、能追到是誰改了設定。

Goals 本章學習目標

一、Violation、Alert 與 Audit

用社區警衛室來想

每次有人違規,Gateway 都像巡邏警衛記下一張「違規單」;MX 像警衛室主管,把相似的違規單彙總成一則「告警」並累計次數。稽核記錄則像門禁刷卡紀錄,記下「誰來過」,不一定是壞人。

名詞意義實務上的差別
Violation(違規)單一請求觸發政策規則Gateway 端產生,一次違規一筆
Alert(告警)MX 把相似違規彙總後的事件有累計次數;MX 端的 ${Alert.dn} 是告警編號
Audit(稽核記錄)依稽核政策記錄的存取資料用於鑑識與合規,不一定是攻擊
違規與告警:Gateway 每次違規產生一筆,MX 彙總成告警;同一個 placeholder 從 Gateway 送出代表違規 ID,從 MX 送出代表告警編號 違規 1 違規 2 違規 3 Gateway 端:一次違規一筆(不做彙總) MX:彙總成一則告警 有累計次數(occurrences) 例如累計 3 次 同一個 placeholder:${Alert.dn} 從 Gateway 送出 = 違規 ID occurrences 永遠是 1 從 MX 送出 = 告警編號 occurrences 是累計次數 SIEM 關聯規則要把兩種 ID 分開處理

官方說明可以佐證這個區分:同一個 placeholder ${Alert.dn},從 MX 送出時代表告警編號,從 Gateway 送出時代表違規 ID;${Alert.aggregationInfo.occurrences} 在 MX 是累計次數,在 Gateway 永遠是 1,因為 Gateway 不做彙總。

看告警的建議流程

  1. 1在 MX 的告警檢視(Monitor 類頁籤)依嚴重度與 Server Group 篩選【待實機確認】。
  2. 2打開告警看違規明細:哪條政策、哪個 URL / 參數、請求內容、來源 IP、使用者(若有開 User Tracking,見第 11 章)。
  3. 3判斷是攻擊還是誤報:同一 URL、大量不同正常使用者觸發,多半是誤報,回到 Web Profile 或政策調整(見第 8、9 章);少數來源、payload 明顯是攻擊字串,確認處置是否為阻擋,必要時加 IP Block。
  4. 4調整後記錄原因,留給第八節的系統事件記錄追蹤。

二、報表

報表用途版本
告警/違規統計類報表週報、月報,看趨勢與熱點各版皆有
Web Profile – Web Application User Tracking檢查登入追蹤判斷是否正確(第 11 章)各版皆有
OWASP Top 10 報表依 OWASP Top 10 分類呈現告警v15.4 起,標示為 Controlled Availability
System Security Reference 合規報表系統安全設定的合規檢查v15.5 起

三、Action Set 與 Action Interface

政策命中後要「做什麼」由 Action Set 決定;Action Set 裡的每一個動作叫 Action Interface。Action Interface 依情境出現(context sensitive),例如安全事件類的 Action Set 才會出現 Gateway 送 Syslog 的選項。

常用 Action Interface

節錄自官方 Configuring Action Interface Parameters。

Action Interface由誰送出重點參數與行為
Send an E-mailMXSMTP Server Address/Port(常見 587)、Authentication Type(NO_AUTH、TLS、SSL)、To/CC、Email Format
Run a Shell CommandMX以 mxserver 使用者權限執行;可用來送 SNMP trap(例如 Gateway 斷線時)。Sealed 模式下不可用(第 13 章)
IP / User / Session Monitor—在 Duration 期間持續記錄該 IP、使用者或 HTTP session 的所有活動
IP Block / User Block / HTTP Session BlockGatewayDuration(秒)、Trusted IPs(只有 IP Block 有);發現違規的 Gateway 立即封鎖,再經 MX 通知其他 Gateway
Server System Log > Log to System Log (syslog)MXSyslog Host(預設埠 514,其他埠寫成 host:port)、Log Level、Message、Facility
Server System Log(CEF 類)MX以 CEF 格式送安全事件、系統事件給 ArcSight 類 SIEM
Gateway System Security LogGatewayProtocol(UDP/TCP)、Primary/Secondary Host 與 Port、Log Level、Message、Facility;每筆違規送一次
SNMP TrapMXSNMP 位址、埠等
Archive to SCP Location / Archive to Amazon S3MX只用於封存工作

Gateway System Security Log 可選格式

兩個容易忽略的細節

  • 封鎖時間不精確:Block 動作是立即的,但解除是 Gateway 每 60 秒檢查一次。設 15 秒封鎖,實際可能封到 60 秒。
  • Secondary 連線用 TCP:要設第二台 SIEM 收集器做備援時,官方要求 Protocol 用 TCP。

四、送到 Syslog / Splunk

先決定:由 MX 送,還是由 Gateway 送?

比較MX 送(Server System Log)Gateway 送(Gateway System Security Log)
單位告警(有彙總)每筆違規
數量少多,需評估 SIEM 授權量
防火牆MX → Syslog每台 Gateway → Syslog
適合值班告警、工單SIEM 關聯分析、鑑識
Syslog 送出路徑:MX 送彙總告警,每台 Gateway 各自送每筆違規,防火牆要允許每一條路徑到 Splunk 的 TCP 514 mx01 10.0.30.10 gw01 10.0.30.11 gw02 10.0.30.12 彙總告警 (少) 每筆違規 (多) 每筆違規 (多) Splunk 10.0.30.50 TCP 514 改由 Gateway 送之後,防火牆要為 每台 Gateway 各開一條

Splunk 整合

官方以 Syslog 送出 Splunk 用的 placeholder 訊息;MX 提供預先定義的 Splunk Action Set。官方建議把預設訊息字串當範本,複製成自己的 Action Set 再修改,不要直接改預設那一份。官方同一頁一處寫 JSON 只用於稽核事件,另一處又列出安全事件的 JSON (Extended) Action Interface,兩者說法不一致,選用 JSON 前請在實機確認【待實機確認】。

設定步驟:Gateway 以 CEF Extended 送到 Splunk 10.0.30.50 TCP 514

https://10.0.30.10:8083
Imperva MX MainAdmin
Main > Policies > Action Sets > AS-Splunk-GW
3Action Set NameAS-Splunk-GW
Action Interface
4Action InterfaceGateway Log - Security Event - System Log (syslog) - CEF Format (Extended)
ProtocolTCP
Primary Host10.0.30.50
Primary Port514
Syslog Log LevelInfo
Message(以預設 Splunk 訊息為範本,不要手打 placeholder)
Facility(依公司規範)
5Save
示意畫面:部分欄位名稱待實機確認(Action Set Name 即 Action Set 的名稱;Main 工作區名稱與 Action Sets 的確切位置以實機為準),版面與按鈕位置以實機為準。
  1. 1確認防火牆允許 gw01(10.0.30.11)、gw02(10.0.30.12)→ 10.0.30.50 TCP 514;若同時由 MX 送,也要開 mx01(10.0.30.10)→ 10.0.30.50。
  2. 2Splunk 端建立接收 TCP 514 的資料輸入,並規劃 index 與 sourcetype(Splunk 端設定不在本教材範圍)。
  3. 3在 MX 進入 Main > Policies > Action Sets,新增安全事件類的 Action Set,命名 AS-Splunk-GW(Policies > Action Sets 的位置見官方 AWS 備份說明;Main 工作區名稱【待實機確認】)。
  4. 4加入 Action Interface「Gateway Log - Security Event - System Log (syslog) - CEF Format (Extended)」,展開設定:Protocol TCP;Primary Host 10.0.30.50、Primary Port 514;Syslog Log Level Info;Message 以預設 Splunk 訊息為範本,不要手打 placeholder;Facility 依公司規範。
  5. 5右上角 Save。
  6. 6到各安全政策(第 9 章)的 Followed Action 選擇 AS-Splunk-GW。
  7. 7用測試請求觸發一條低風險政策,在 Splunk 搜尋確認收到,並核對違規 ID 能對回 MX。

placeholder 驗證

Gateway 端的 Action Interface 加入 placeholder 時,系統會檢查 Gateway 能否取得該欄位,不能取得就不允許儲存。看到存檔失敗,先檢查是否用了只有 MX 才有的 placeholder。

五、動手玩:Syslog 訊息組合器

選擇由 MX 還是 Gateway 送,勾選要放進訊息的 placeholder,看看預覽訊息、實際取得的值,以及防火牆要開哪些路徑。可用的 placeholder 是本章前面提到的兩個;訊息範本與數值皆為教學範例,真正的預設 Splunk 訊息請以 MX 上的範本為準。

由誰送出?

選擇 placeholder

傳送設定

預覽

訊息範本(Message)


                    

送出的訊息(範例值代入後)


                    

六、Attack Analytics 匯出

Attack Analytics 是 Imperva 雲端服務,把大量告警依共同特徵分群成「資安事件(incident)」,也能和 Cloud WAF 的事件一起分析(見第 14 章)。

Attack Analytics 匯出的連線:Gateway 上傳告警到雲端,MX 向雲端做授權驗證,雲端把告警分群成資安事件 Gateway 上傳告警 MX 授權驗證 HTTPS 443 HTTPS 443 Imperva 雲端 Attack Analytics 依共同特徵分群成資安事件 兩邊都要能連網際網路; 購買後至少等 30 分鐘再檢查 MX

前提

官方 Attack Analytics 頁。

  1. 1MX 與 Gateway 都要能連網際網路。對應連線:Gateway → ses-uploader.service.imperva.com:443(上傳告警)、MX → entitlement / auth.service.imperva.com:443(授權驗證)(埠表見第 3 章)。
  2. 2已購買 Attack Analytics;購買後至少等 30 分鐘再檢查 MX,並重新整理 SecureSphere 主畫面。

操作

https://10.0.30.10:8083
Imperva MX MainAdmin
Admin > System Definitions > Cloud Settings > General Settings
2Attack Analytics(切換開關)
示意畫面:欄位名稱依 Imperva 官方文件,版面、按鈕位置與配色以實機為準。
  1. 1在 Main 工作區選 Attack Analytics,會開啟 my.imperva.com 上的 Attack Analytics 頁面。
  2. 2開關位置:Admin 工作區 > System Definitions > Cloud Settings > General Settings,切換 Attack Analytics。
  3. 3在 Attack Analytics 端的設定開啟「Export On-Premises WAF alerts」(依 Attack Analytics 文件)。

規劃提醒

告警會送到雲端,內容包含請求資訊。先跟法遵確認資料出境與保存規範;敏感欄位先用第 11 章的 Data Masking 遮罩。

七、REST API

登入流程

官方 Authentication、Login 頁。

  1. 1以 Basic Authentication 呼叫 Login,取得 session cookie(JSESSIONID)。
  2. 2之後每個請求在 Cookie header 帶上 session。
  3. 3Session 閒置 30 分鐘逾時,或呼叫 Logout 結束。
動作MethodURL
LoginPOSThttps://{host:port}/SecureSphere/api/v1/auth/session
LogoutDELETE同上,header 帶 Cookie: {sessionId}

範例:管理者電腦 10.0.30.100 對 mx01

# Login: credentials are read from environment variables, not typed on the command line
curl -sk -X POST https://10.0.30.10:8083/SecureSphere/api/v1/auth/session \
     -u "$MX_API_USER:$MX_API_PASS"
# Response body: {"session-id": "JSESSIONID=0123456789ABCDEF..."}

# Subsequent call (endpoint path below is illustrative)
curl -sk https://10.0.30.10:8083/SecureSphere/api/v1/conf/sites \
     -H "Cookie: JSESSIONID=0123456789ABCDEF..."

# Logout
curl -sk -X DELETE https://10.0.30.10:8083/SecureSphere/api/v1/auth/session \
     -H "Cookie: JSESSIONID=0123456789ABCDEF..."

上例的登入、登出路徑出自官方文件;查詢 Sites 的路徑僅示意,實際 endpoint 請查 WAF API Reference Guide【待實機確認】。-k 只在 MX 仍用自簽憑證的實驗環境使用,正式環境應匯入 MX 憑證的 CA。

登入失敗代碼(節錄)

IMP Code意義
IMP-10063未登入或帳密錯誤
IMP-12300憑證(密碼)已過期
IMP-12301使用者已停用
IMP-12302與驗證伺服器通訊失敗
IMP-12303帳號被鎖
IMP-12304 / IMP-12305此使用者 / 系統的 session 數已達上限

實務建議

API 用專屬帳號、最小權限;腳本結束一定呼叫 Logout,否則容易撞到 IMP-12304 的 session 上限。

八、系統事件記錄

九、常見踩坑

只開 MX → Syslog 的防火牆

改用 Gateway System Security Log 後,訊息是從每台 Gateway 送出,防火牆沒開就整批收不到。

Gateway 送每筆違規,SIEM 授權量暴增

先估算違規量,或改由 MX 送彙總告警。

placeholder 存不了檔

在 Gateway 類 Action Interface 用了 Gateway 取不到的欄位。

把 ${Alert.dn} 當成同一種 ID

MX 送出的是告警編號,Gateway 送出的是違規 ID,SIEM 關聯規則要分開處理。

API session 用完不登出

累積到 session 上限,自動化腳本開始收到 401。

Attack Analytics 沒資料

Gateway 不能連 ses-uploader.service.imperva.com:443,或購買後未等授權生效。

十、新舊對照

舊簡報 vs 現行版本

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

舊簡報說法現況依據
共用平台提供 Management、Analytics、Reporting、Alerting(舊簡報 p.14),未談 SIEM 整合Action Interface 支援 Syslog、CEF / CEF Extended、JSON Extended、Splunk placeholder;Gateway 可直接送 SyslogConfiguring Action Interface Parameters、Splunk Placeholders
(無)地端告警可匯出到雲端 Attack Analytics,與 Cloud WAF 一起分析Attack Analytics(WAF User Guide)
(無)MX REST API:Basic Auth 取得 JSESSIONID,閒置 30 分鐘逾時WAF API Reference Guide – Authentication
(無)OWASP Top 10 報表(15.4 CA)、System Security Reference 報表(15.5)、系統事件「誰改了什麼」(15.0)v15.5 Release Notes

Quiz 隨堂測驗

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