Imperva WAF Gateway 實戰課程

單元 13:CLI 與日常維運

講師導言

WAF Gateway 的日常維運大多在 MX 的圖形介面完成,命令列(CLI)主要用在初始化、排障、備份與升級。這一章先釐清 impcli、impcfg、impctl 三者的分工,再整理常用指令、備份、升級路徑、疑難排解,以及開案前要收集哪些資訊。 原則和 2014 年一樣:把設備當黑盒子,能用 impcfg 就用 impcfg,impctl 只在必要時或原廠指示下使用。

Goals 本章學習目標

一、三種 CLI 的分工

先記住這一條

impctl 只在必要時或原廠指示下使用。能用 impcfg 就用 impcfg;官方的 Safe impctl Commands 清單以外,先開案詢問原廠。

三種 CLI 的風險階梯:impcli 風險低,impcfg 風險中,impctl 風險高且只在必要時或原廠指示下使用 impcli:風險低 Imperva 專屬的受限 shell,登入後的預設環境 查詢、備份匯出、上傳診斷資料、打 patch impcfg:風險中 選單式設定工具,官方建議用它改工作模式 與網路設定、註冊 MX impctl:風險高 底層控制工具,impcfg 實際上也是呼叫它 官方註明僅限資深管理者 只在必要時或原廠指示下使用
工具是什麼什麼時候用風險
impcliImperva 專屬的受限 shell,SSH / console 登入後的預設環境一般查詢、備份匯出、上傳診斷資料、打 patch低;所有輸入都會被記錄
impcfg選單式設定工具網路介面、Gateway 工作模式、註冊 MX 等系統層設定中;官方建議以它改工作模式與網路設定
impctl底層控制工具,impcfg 實際上也是呼叫它啟停服務、重新註冊等;其餘只在原廠指示下高;官方註明僅限資深管理者

CLI 文件目前分四節:impcfg、impctl、impcli、Miscellaneous Commands(WAF Administration Guide)。

二、impcli 與 Sealed 模式

內建使用者

使用者說明
adminimpcli 預設使用者,預設密碼 admin,第一次登入必須改密碼
rootLinux 超級使用者;須在首次設定時改掉預設密碼才能使用;每 90 天須更換密碼;預設不能用 root 直接 SSH 登入
grub只用於開機載入程式密碼,不是 CLI 使用者;可在首次設定或用 impcfg 設定

impcli 常用指令(示意畫面)

SSH / console:gw01(10.0.30.11)
# 登入後的預設環境是 impcli(預設使用者 admin,第一次登入必須改密碼) impcli> help # 列出指令 impcli> df # 磁碟使用量(磁碟滿是常見停擺原因) impcli> ifconfig # 網路介面 impcli> ping 10.0.30.10 # 只驗證 ICMP 連通(GW → MX),不能驗證 TCP 埠 impcli> netstat # 看 TCP 8083 / 8085 連線是否建立 impcli> gwlog # 檢視 Gateway 元件記錄 impcli> gti-remote # 產生 get-tech-info 並上傳(URL 依原廠案件指示,語法待實機確認)
示意畫面:指令名稱依官方 Impcli Available Commands 表,提示符號與輸出以實機為準;各指令確切語法待實機確認。
指令用途Sealed 可用
help / history列出指令 / 指令歷史是
date、hostname、id系統時間、主機名、目前身分是
df磁碟使用量是
ifconfig、netstat、ping網路介面、連線狀態、連通測試是
impcfg / impctl進入設定選單 / 控制工具impcfg 在鎖定模式參數不同;impctl 可
export-local / export-remote匯出資料庫到本機 / 上傳到 URL是
import-local / import-remote從本機 / 遠端 URL 匯入資料庫是
gti-remote產生 get-tech-info 診斷包並上傳到 URL是
gwlog檢視 Gateway 元件記錄是
patch-remote從 URL 下載並安裝 patch是
lock切換到鎖定 profile是
admin切換為 root否

節錄自官方 Impcli Available Commands 表。其他 impcli 雜項指令包含:開關機、更換 MX 與 Gateway 間的通訊密碼、SSH authorized keys 管理(WAF Administration Guide > Miscellaneous Commands);各指令確切語法【待實機確認】。

Sealed 模式(封存模式)

把設備鎖成只能執行有限指令。

項目一般(default)模式Sealed 模式
admin 切 root可不可
Run a Shell Command 的 Followed Action可不可(第 12 章)
scp 等安全檔案傳輸可不支援
解除—unseal + 封存時設定的密碼

封存步驟:輸入 seal → y → 設定解封密碼兩次 → 重新連線生效。解封密碼規則:10–14 字元,至少一個數字、一個大寫字母、一個指定特殊字元(* + = # % ^ : / ~ . , [ ] _),不得有超過兩個相同字元連續。

警告

seal --strict 是永久封存,無法解除。除非資安政策明確要求,不要使用。

三、impcfg:選單式設定

impcfg 是選單式工具,改完先按 S(Save) 存檔,再按 A(Apply) 套用;沒有 Apply 的變更不會生效。官方的選單路徑寫法例如:Top > Manage SecureSphere Gateway > Change operation mode(注意選單仍沿用 SecureSphere 舊名)。

常見工作位置參考章節
首次設定(管理 IP、DNS、NTP、密碼)首次登入精靈第 6 章
變更 Gateway 工作模式(含轉 ABR)Top > Manage SecureSphere Gateway > Change operation mode第 4 章
網路介面、bridge 介面設定Manage SecureSphere Gateway 底下第 4、5 章
註冊到 MXManage SecureSphere Gateway 底下【待實機確認】第 6 章

好習慣:一次只改一件事

impcfg 變更流程:先截下首頁狀態,一次只改一件事,按 S 存檔、按 A 套用,確認 Gateway 在 MX 上恢復連線再做下一件 ① 先截下 impcfg 首頁狀態 ② 一次只改一件事 ③ S 存檔 ④ A 套用 ⑤ 確認 Gateway 在 MX 上恢復連線 並與步驟 ① 的狀態比對 確認沒問題,才做下一件事 只按 S 沒按 A,變更不會生效

變更前先截下 impcfg 首頁狀態(各元件狀態與標記),變更後比對;一次只改一件事,Apply 後確認 Gateway 在 MX 上恢復連線再做下一件。

四、impctl:只在必要時使用

使用原則

  • impctl 只在必要時或原廠指示下使用,官方註明僅限資深管理者。
  • 安全清單以外的 impctl 指令,先開案詢問原廠。
  • impctl teardown 屬破壞性操作,只在原廠指示下執行。

Safe impctl Commands:可以自行使用的範圍

指令用途
impctl show commands --verbose列出所有 impctl 指令與參數
impctl status顯示設備狀態
impctl server start / stop / restart啟動 / 停止 / 重啟 MX 服務
impctl gateway start / stop / restart啟動 / 停止 / 重啟 Gateway 服務
impctl gateway register / unregister將 Gateway 註冊到 / 自 MX 解除註冊
impctl gateway config --encryption=yes加密 Gateway 上的稽核檔(主要為資料庫稽核用途)
impctl hardening config --root-source-ip-exception=<IP>允許指定 IP 以 root SSH 登入

本教材另外會出現的兩個 impctl 指令

重要提醒:重啟會中斷服務

impctl gateway restart 會中斷 inline 流量。Fail Open 只在有實體 bypass 網卡的硬體上生效,虛擬機只支援 Fail Close(第 5 章);在 VM 上重啟 Gateway,單台或沒有 VRRP 冗餘時等於停機;有 VRRP 時要先確認已切到另一台。要排維護時段。

五、常用指令速查表

工作指令 / 位置工具備註
看設備狀態impctl statusimpctl(安全清單)排障第一步
看網路介面ifconfigimpcli—
測連線ping 10.0.30.10impcliGW → MX
看連線埠netstatimpcli確認 8083 / 8085 是否建立
看磁碟dfimpcli磁碟滿是常見停擺原因
看 Gateway 記錄gwlogimpcli—
改工作模式Top > Manage SecureSphere Gateway > Change operation modeimpcfgS 存、A 套用
重新註冊 GWimpctl gateway unregister → impctl gateway registerimpctl(安全清單)MX 上 Gateway 卡住時
重啟服務impctl gateway restart / impctl server restartimpctl(安全清單)會中斷服務
備份 MXfull_expimp.sh(root)或 export-local / export-remoteshell / impcli第六節
收診斷包gti-remoteimpcli開案用
打 patchpatch-remoteimpcli先備份
封存設備seal / unsealimpcli不要用 --strict

六、備份

MX 是設定的正本。Site Tree、政策、Web Profile 都存在 MX 資料庫,所以備份重點在 MX【推論】。

完整匯出(升級前必做)

官方 Backing Up the System。

SSH / console:mx01(10.0.30.10)
# 先以 CLI 使用者登入,再用 admin 指令切換成 root impcli> admin # 執行完整匯出 # full_expimp.sh Operation: 1 Password: ******** Export Type: 1 Export failed archived data? (default n): n Backup file name (default /var/tmp/SecureSphere_<date>.tgz): Confirm? Y ... full_expimp completed successfully on <date>
示意畫面:提示文字依官方文件步驟整理,英文提示字樣待實機確認。Password 為 system 使用者密碼;Export failed archived data 為是否匯出失敗的封存資料;Confirm 為最後確認。
  1. 1以 root 登入 MX(由 impcli 執行 admin 切換)。
  2. 2執行 full_expimp.sh。
  3. 3依提示輸入:Operation 選 1;Password 輸入首次設定時的 system 使用者密碼;Export Type 選 1。
  4. 4是否匯出失敗的封存資料(預設 n)。
  5. 5備份檔名:預設 /var/tmp/SecureSphere_<日期>.tgz;自訂時要寫完整路徑。
  6. 6輸入 Y 確認,等待完成。事件量大時會很久,可在另一個 shell 用 tail 看同目錄的記錄檔;成功時結尾會出現 full_expimp completed successfully on <date>。
  7. 7把備份檔複製到其他機器。
  8. 8另外複製報表目錄 /opt/SecureSphere/server/SecureSphere/jakarta-tomcat-secsph/webapps/SecureSphere/WEB-INF/reptemp。

其他方式

建議週期

每週一次例行匯出 + 每次重大變更與升級前加做;備份檔保留至少兩份、放在 WAF 以外的位置,並每季做一次匯入演練(在測試 MX)。

七、升級路徑

升到 v15.5

官方 Upgrade Path - Minimum Upgrade Version。

升級路徑:v14.7.x 先升到最新 v14.7 LTS patch 再升 v15.5;v14.0 到 v14.6 先升到 v14.7;更舊版本或 v15.0 到 v15.4 以官方 v15.5 Upgrade Guide 為準(待實機確認);v16.0 必須從 v15.5 LTS patch 起跳 目前版本是? 更舊 / v15.0–15.4 依官方 v15.5 Upgrade Guide 【待實機確認】 v14.0–v14.6 先升到 v14.7 (最新 LTS patch) v14.7.x 先裝最新 v14.7 LTS patch 最新 v14.7 LTS patch 7G 硬體要先確認在 14.7.0.50 以上 v15.5 v16.0:必須從 v15.5 LTS patch 起跳 只有 Controlled Availability Bridge / Sniffing 環境不要規劃
目前版本升級路徑
v14.7.x先升到最新 v14.7 LTS patch,再升 15.5
v14.0 – v14.6先升到 v14.7(最新 LTS patch),再升 15.5
更舊版本或 v15.0 – v15.4路徑以官方 v15.5 Upgrade Guide(Minimum Upgrade Version)為準【待實機確認】

升到 v16.0

  • 必須從任一 v15.5 LTS patch 起跳。
  • 改用新的 client-server 升級程序:Gateway 先升、MX 後升,需要另外部署「s7 server」。
  • OS 由 CentOS 7.9 改為 Oracle Linux 9.5。
  • v16.0 只有 Controlled Availability,只支援 NGRP / ABR、VRRP;不支援 Bridge、Sniffing、IMPVHA(GW)、MX-HA、SOM、雲端 VM;M100、M150 不能升 16.0。目前跑 Bridge 或 Sniffing 的環境不要規劃升 16.0。

升級前檢查

  1. 1讀目標版本 Release Notes 的「不再支援」項目(例如 KRP 已移除、Onebox 不支援、Hyper-V 不支援)。
  2. 2對照 EOS 表確認目標版本支援期(第 1 章)。
  3. 3完成第六節的完整匯出,VM 拍 snapshot。
  4. 4安排維護時段;VM 只有 Fail Close,升級期間 inline 流量會中斷。
  5. 5升級後:確認 Gateway 全部在 MX 上線、ADC 內容版本、政策套用、送 Syslog 正常。

八、疑難排解檢查表

先看症狀,再依「先查」欄位逐項確認。第十節的決策樹會帶你一題一題走。

症狀先查工具 / 參考
Gateway 在 MX 顯示斷線GW → MX TCP 8083(啟用 Trusted Connections 後為 8085)是否通;MX → GW 22 / 443netstat 看連線狀態(ping 只驗證 ICMP,不能驗證 TCP 埠);第 3 章埠表
Gateway 註冊不上時間是否同步(NTP)、MX 與 GW 間的通訊密碼是否一致date;impcli 雜項指令
有流量但沒告警Site Tree 的伺服器 IP / 埠是否對到實際流量;HTTPS 金鑰是否匯入第 7 章
HTTPS 無法解析Gateway 跑 Sniffing 或 Bridge,且流量用 TLS 1.3 或任何 ECDHE / DHE(PFS)cipher第 4 章
擋了但使用者看到逾時Sniffing 模式只能送 TCP reset,不能回錯誤頁第 4 章
ADC 內容更新失敗MX → www.imperva.com:443第 3、9 章
威脅情資 / ABP 無效MX / GW → *.impervacloud.com:443;ABP 另需 *.impervaabp.net、*.distil.ninja第 10 章
SIEM 收不到每台 GW → Syslog 埠;Protocol 與 SIEM 端一致第 12 章
MX 變慢、GUI 卡磁碟空間、告警量、報表排程df
連線數下降(舊機升級後)KRP 換成 NGRP 後,X6510/8510/10K 連線數下降第 4、5 章

九、開案前收集資訊

支援入口已改為 Thales Support Portal;2026-02-15 起不再直接以 email 寄送產品通知,要自行在入口訂閱。開案前備齊:

  1. 1版本:MX、Gateway(含 SOM)的版本與 patch 號(impctl status、GUI)。
  2. 2平台:硬體型號或虛擬型號、hypervisor / 雲端平台。
  3. 3部署:Gateway Group 的 Gateway Mode、Fail Mode、HA 方式,附簡單拓撲圖。
  4. 4時間軸:問題開始時間(註明時區)、最近一次變更(對照系統事件記錄,第 12 章)。
  5. 5證據:相關告警 / 違規 ID、錯誤訊息、截圖。
  6. 6診斷包:用 gti-remote 產生並上傳 get-tech-info(上傳 URL 依原廠案件指示)。
  7. 7已做過的排除:照第八節檢查過哪些項目、結果如何。

十、動手玩:疑難排解決策樹

選一個症狀,依序回答每一項檢查。找到可疑點就停下來處理;全部正常,就照第九節備齊資訊再開案。檢查項目與工具完全依第八節的檢查表。

1. 選擇症狀

2. 逐項檢查

指令安全查詢:這個指令我能自己下嗎?

impctl 只在必要時或原廠指示下使用。挑一個指令,看它屬於哪一類。

十一、常見踩坑

impcfg 改完沒按 A

只存檔沒套用,以為改了其實沒生效。

在 VM 上重啟 Gateway 沒排停機

VM 只有 Fail Close,重啟就是斷線。

用 seal --strict

永久封存無法解除,之後原廠要 root 協助也進不去。

root 密碼過期

root 每 90 天要換,緊急時才發現過期。把換密碼排入例行工作。

備份只放在 MX 本機

預設路徑 /var/tmp,MX 壞掉時備份一起不見。

跳版升級

v14.0–14.6 不能直接升 15.5,要先升到 v14.7(最新 LTS patch);更舊版本或 15.0–15.4 的路徑以官方 v15.5 Upgrade Guide 為準【待實機確認】。

十二、新舊對照

舊簡報 vs 現行版本

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

舊簡報說法現況依據
平台基於 Linux 2.6 / CentOS(舊簡報 p.47、p.152)v15.x 為 CentOS 7.9;v16.0 改 Oracle Linux 9.5v15.5、v16.0 Release Notes
用 impcfg 建立獨立 SSH 使用者,登入後輸入 admin 取得 root(舊簡報 p.152)登入環境為 impcli,預設使用者 admin(首次登入改密碼);admin 指令切 root;舊 secure 使用者已移除;Sealed 模式下不能切 rootimpcli、Sealed Mode(WAF Administration Guide)
impctl 僅在 Imperva support 指示下使用(舊簡報 p.152)原則不變;另有官方 Safe impctl Commands 清單可自行使用Safe impctl Commands
impcfg Top Screen 以 8.0 為例,含 Server、Gateway 同機(舊簡報 p.153)選單概念(S 存、A 套用)不變;MX 與 GW 同機(Onebox)自 v14.1 起不支援impcfg Functionality Map;v16.0 Upgrade Guide
收集資訊用 impctl support get-tech-info(舊簡報 p.154)impcli 提供 gti-remote 產生並上傳 get-tech-info;本機產生指令【待實機確認】Sealed Mode(impcli 指令表)
impctl db 一系列資料庫指令(舊簡報 p.154)備份改用 full_expimp.sh 或 impcli export-local / export-remoteBacking Up the System;Sealed Mode
支援入口與夥伴下載站(舊簡報 p.157–158)改為 Thales Support Portalv15.5 Release Notes

Quiz 隨堂測驗

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