Edge Security Acceleration：自訂頁面

建立自訂攔截頁面

1. 登入ESA控制台，在左側導覽列選擇全域配置 > 自訂頁面。

2. 在自訂頁面，選擇攔截頁面頁簽，單擊建立攔截頁面。

3. 輸入頁面名稱，選擇頁面類型，編寫頁面源碼，單擊確定。

   參數	說明
   頁面名稱	支援字母、數字、底線_。最多 30 個字元。
   備忘	最多 100 個字元。
   頁面類型	頁面格式類型。取值： text/html application/json
   頁面源碼	自訂頁面的源碼，代碼不超過 2 KB。代碼中可使用 {{REQUEST_ID}} 和 {{RULE_ID}} 向用戶端展示錯誤請求 ID 和觸發攔截的規則 ID，便於後續收集使用者反饋和定位問題。
   生效網站	進階配置項。選擇需要全域生效的網站後，該網站下所有使用預設攔截頁面的規則將自動使用此處配置的自訂攔截頁面。

   說明

   網站內具體規則單獨配置的自訂攔截頁面優先順序高於全域配置。如需統一攔截頁面樣式，需將網站內單獨配置的自訂攔截頁面均改為預設攔截頁面。

適用功能

自訂攔截頁面支援在配置以下規則時引用。

所有基於 WAF 規則引發的攔截頁面（無論是系統預設攔截頁面還是自訂攔截頁面）均不計入使用者套餐流量消耗及費用結算範疇。

操作步驟

通過自訂規則引用已建立的自訂攔截頁面。

1. 在ESA控制台選擇網站管理，在網站列單擊目標網站。

2. 在左側導覽列，單擊安全防護 > WAF > 自訂規則 > 新增規則，進入新增規則頁面，輸入規則名稱。

3. 在如果請求匹配以下規則...欄中，匹配類型選擇用戶端 IP，匹配條件選擇在分組中，輸入框中選擇上面建立的分組。

4. 在則執行…欄中，操作選擇攔截，響應的攔截頁面選擇上面建立的自訂頁面，響應碼修改為 400 以示區分，單擊確定。

5. 完成配置後，觸發對應的 WAF 規則，確認頁面返回的攔截內容為自訂頁面樣式。

建立自訂滑塊頁面

1. 登入ESA控制台，在左側導覽列選擇全域配置 > 自訂頁面。

2. 在自訂頁面管理頁面切換到滑塊頁面頁簽，單擊建立滑塊頁面，完成以下配置後單擊確定：

   • 頁面名稱：滑塊驗證頁面的標題文案，支援中英文、數字及常見符號。

   • 不同語言滑塊樣式：至少選擇一種語言（可選中文和English），選擇後進行對應語言樣式的配置：

     1. 標題：自訂滑塊的顯示主標題

     2. 展示 Request ID：可選擇是否顯示請求ID

     3. 滑塊顏色：設定滑塊驗證按鈕的顏色，支援通過顏色選取器或輸入十六進位顏色值進行配置。

     4. 展示阿里雲 ESA：可選擇是否顯示ESA 標識

     

   • 強制指定語言：強制滑塊頁面使用指定語言顯示（中文或英文）。

   • 生效網站：選擇需要全域生效的網站，配置後該網站下所有滑塊驗證均使用此自訂樣式。

應用自訂滑塊頁面

自訂滑塊頁面建立後，需在建立時選擇全域生效網站才能自動應用。完成配置後，該網站下所有觸發滑塊驗證的情境將自動使用自訂滑塊頁面的樣式，無需在各條規則中單獨引用。若未選擇全域生效網站，自訂滑塊頁面不會對任何網站生效。

驗證自訂攔截頁面

1. 完成 WAF 自訂攔截頁面配置後，訪問加速網域名稱。

2. 確認返回的攔截頁面為自訂頁面，驗證網域名稱解析已生效且安全性原則成功執行。

   

驗證自訂滑塊頁面

在進行驗證前，確認已在 WAF 規則中將處置動作配置為滑塊挑戰，並完成自訂滑塊頁面的建立和全域生效網站配置。

1. 訪問已命中 WAF 滑塊驗證規則的網域名稱，觸發滑塊驗證彈出頁面。

2. 確認滑塊驗證頁面顯示的標題、顏色等樣式與自訂設定一致。