Edge Security Acceleration：匹配欄位

ESA的匹配欄位支援 3 種類型：

• 標準欄位：用於表示用戶端請求或者響應中攜帶的標準協議（如： HTTP 、 IP 、 TLS 等）相關資訊，例如：主機名稱、請求標題、響應標題等。

• 擴充欄位：用於表示ESA對用戶端請求或者響應進行特定運算後獲得的計算值，通常與 HTTP 要求的威脅情報有關。

• 原始欄位：用於表示ESA保留用戶端請求的原始屬性值，通常用於在用戶端請求穿過多個 ESA 功能模組的過程中依然保持原始屬性值。

單條運算式 = （<匹配欄位> <匹配運算子> <匹配值>），如（http.host eq "www.example.com"）

http.cookie

HTTP 要求中攜帶的Cookie標題。

• 欄位名：Cookie

• 類型：String

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：是

• 樣本值："sessionid=330688;userid=abc123"

• 使用限制：查看該欄位在不同功能中的支援情況

http.host

HTTP 要求中使用的主機名稱。

• 欄位名：主機名稱

• 類型：String

• 是否支援區分大小寫：否

• 匹配值是否允許配置Null 字元串：否

• 樣本值："www.example.com"

• 使用限制：查看該欄位在不同功能中的支援情況

http.referer

HTTP 要求中攜帶的Referer標題。

• 欄位名：Referer

• 類型：String

• 是否支援區分大小寫：否

• 匹配值是否允許配置Null 字元串：是

• 樣本值："http://www.example.com/index"

• 使用限制：查看該欄位在不同功能中的支援情況

http.request.body.form

HTTP 要求中攜帶的表單形式的請求本文（當Content-Type標題值為application/x-www-form-urlencoded時使用的請求本文格式），以 Map（關聯陣列）形式表示。

• 欄位名：Body查詢字串

• 類型：Map<Array<String>>

• 樣本值：{"username":["admin"]}

• 使用限制：查看該欄位在不同功能中的支援情況

http.request.body.mime

從 HTTP 要求本文中檢測到的 MIME 類型。支援一般資源類別video, audio, image, application, text的最常見 MIME 類型。

• 欄位名： MIME 類型

• 類型：String

• 樣本："application/json"

• 使用限制：查看該欄位在不同功能中的支援情況

http.request.cookies

HTTP 要求中攜帶的Cookie標題，以 Map （關聯陣列）的形式表示。

• 欄位名： Cookie 值

• 類型：String

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：是

• 樣本值：{"sessionid":["330668"]}

• 使用限制：查看該欄位在不同功能中的支援情況

http.request.full_uri

HTTP 要求的完整 URI ，包括協議、主機名稱、路徑和查詢字串。

• 欄位名： URI 完整

• 類型：String

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：否

• 樣本值："htt­ps://www.example.com/image/cat.jpg?width=400&height=300&format=webp"

• 使用限制：查看該欄位在不同功能中的支援情況

http.request.headers

HTTP 要求中包含的標題資訊，以 Map （關聯陣列）的形式表示。關聯陣列的鍵（即：標題名稱）裡麵包含的所有英文字母都必須使用小寫形式。

• 欄位名：標題

• 類型：Object

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：是

• 樣本值：{"content-type":["application/json"]}

• 使用限制：查看該欄位在不同功能中的支援情況

http.request.method

HTTP 要求使用的要求方法。

• 欄位名：要求方法

• 類型：String

• 樣本值："GET"

• 使用限制：查看該欄位在不同功能中的支援情況

http.request.timestamp.sec

ESA節點收到 HTTP 要求時的 Unix 時間戳記（秒）。

• 欄位名：請求時間戳記

• 類型：Integer

• Unix 時間：（ 1735019278 ）

• 樣本值：1735019278

• 使用限制：查看該欄位在不同功能中的支援情況

http.request.uri

HTTP 要求的 URI ，包括路徑和查詢字串。

• 欄位名： URI

• 類型：String

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：否

• 使用限制：查看該欄位在不同功能中的支援情況

http.request.uri.args

HTTP 要求 URI 中的查詢字串，以 Map （關聯陣列）的形式表示。

• 欄位名： URI 指定查詢字串

• 類型：Map<Array<String>>

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：是

• 樣本值：{"format":["webp"]}

  說明

  僅在如下匹配運算子時支援空值：

  • 等於

  • 不等於

  • 包含

  • 與Regex匹配

• 使用限制：查看該欄位在不同功能中的支援情況

http.request.uri.path

HTTP 要求 URI 中的路徑。

• 欄位名： URI 路徑

• 類型：String

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：否

• 樣本值："/image/cat.jpg"

• 使用限制：查看該欄位在不同功能中的支援情況

http.request.uri.path.extension

HTTP 要求 URI 路徑中檔案的副檔名。

• 欄位名：副檔名

• 類型：String

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：否

• 樣本值：

  URI path	Field value
  /cat	""
  /cat.jpg	"jpg"
  /.jpg	""
  /.cat.jpg	"jpg"
  /cat.jpg.tar	"tar"
  /cat.	""
  /cat.JPG	"JPG"

• 使用限制：查看該欄位在不同功能中的支援情況

http.request.uri.path.file_name

HTTP 要求 URI 路徑中的檔案名稱。

• 欄位名：檔案名稱

• 類型：String

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：否

• 樣本值：

  URI path	Field value
  /cat	"cat"
  /cat.jpg	"cat"
  /.jpg	""
  /.cat.jpg	".cat"
  /cat.jpg.tar	"cat.jpg"
  /cat.	"cat"
  /CAT.jpg	"CAT"

• 使用限制：查看該欄位在不同功能中的支援情況

http.request.uri.path.full_file_name

HTTP 要求 URI 路徑中的完整檔案名稱。

• 欄位名：完整檔案名稱

• 類型：String

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：否

• 樣本值："cat.jpg"

• 使用限制：查看該欄位在不同功能中的支援情況

http.request.uri.query

HTTP 要求 URI 中的查詢字串。

• 欄位名： URI 查詢字串

• 類型：String

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：否

• 樣本值："width=400&height=300&format=webp"

• 使用限制：查看該欄位在不同功能中的支援情況

http.request.version

HTTP 要求的 HTTP 協議版本。

• 欄位名： HTTP 版本

• 類型：String

• 樣本值："HTTP/1.0""HTTP/1.1""HTTP/2.0""HTTP/3.0"

• 使用限制：查看該欄位在不同功能中的支援情況

http.user_agent

HTTP 要求中攜帶的 User-Agent 標題。

• 欄位名： User Agent

• 類型：String

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：是

• 樣本值："Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.X.X Safari/537.36"

• 使用限制：查看該欄位在不同功能中的支援情況

http.x_forwarded_for

HTTP 要求中攜帶的X-Forwarded-For標題。

• 欄位名： X-Forwarded-For

• 類型：String

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：是

• 樣本值："192.168.0.1, 10.10.0.1"

• 使用限制：查看該欄位在不同功能中的支援情況

ip.geoip.asnum

請求源 IP 對應網段歸屬的自治系統編號，詳情請參見什麼是ASN。

• 欄位名： ASN 編號

• 類型： Integer

• 樣本值：37963

• 使用限制：查看該欄位在不同功能中的支援情況

ip.geoip.continent

請求源 IP 歸屬的大洲。

• 欄位名：洲

• 類型：String

• 樣本值：AS

• 使用限制：查看該欄位在不同功能中的支援情況

ip.geoip.country

請求源 IP 歸屬的省/地區。詳情請參見ISO 3166 標準介紹。

• 欄位名：省/地區

• 類型：String

• 是否支援區分大小寫：否

• 匹配值是否允許配置Null 字元串：否

• 樣本值："CN"

• 使用限制：查看該欄位在不同功能中的支援情況

ip.src

請求源 IP 位址（即：用戶端與 ESA 節點建聯使用的 IP 位址）。

• 欄位名：用戶端 IP

• 類型：IP address

• 是否支援區分大小寫：否

• 匹配值是否允許配置Null 字元串：否

• 樣本值：192.0.2.1

• 使用限制：查看該欄位在不同功能中的支援情況

ip.src.isp

請求源 IP 歸屬的互連網服務提供者。

• 欄位名：電訊廠商

• 類型：String

• 樣本值："100017"

• 使用限制：查看該欄位在不同功能中的支援情況

ip.src.version

請求源 IP 的 IP 協議版本資訊。

• 欄位名： IP 協議版本

• 類型：String

• 樣本值："IPv4""IPv6"

• 使用限制：查看該欄位在不同功能中的支援情況

ip.src.subdivision_1_iso_code

請求源 IP 對應地理位置的第一層細分地區，詳情請參見ISO 3166 標準介紹。

• 欄位名：省份

• 類型：String

• 是否支援區分大小寫：是

• 樣本值："CN-ZJ"

• 使用限制：查看該欄位在不同功能中的支援情況

ip.src.region_code

請求源 IP 所在地理位置對應的負載平衡器所在地區。

• 欄位名：負載平衡器所在地區

• 類型：String

• 是否支援區分大小寫：是

• 樣本值："EAS"

• 使用限制：查看該欄位在不同功能中的支援情況

ip.src.city

請求源 IP 歸屬的城市代碼。

• 欄位名：城市代碼

• 類型：String

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：否

• 樣本值："310000"

• 注意事項： ESA 節點對用戶端 IP 的地理位置識別在城市層級的精度有限，因此不適合用於封鎖請求等情境。

• IP 位址無法識別時，返回預設值 XX。

• 使用限制：查看該欄位在不同功能中的支援情況

ip.src.city_name

請求源 IP 歸屬的城市名稱。

• 欄位名：城市名稱

• 類型：String

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：否

• 樣本值："hangzhou"

• 注意事項： ESA 節點對用戶端 IP 的地理位置識別在城市層級的精度有限，因此不適合用於封鎖請求等情境。

• IP 位址無法識別時，返回預設值 XX。

• 使用限制：查看該欄位在不同功能中的支援情況

ip.src.lon

請求源 IP 對應地理位置的經度。

• 欄位名：經度

• 類型：Float

• 樣本值：120.12

• 注意事項： ESA 節點對用戶端 IP 的地理位置識別在城市層級的精度有限，因此不適合用於封鎖請求等情境。

• IP 位址無法識別時，返回預設值 XX。

• 使用限制：查看該欄位在不同功能中的支援情況

ip.src.lat

請求源 IP 對應地理位置的緯度。

• 欄位名：緯度

• 類型：Float

• 樣本值：30.16

• 注意事項： ESA 節點對用戶端 IP 的地理位置識別在城市層級的精度有限，因此不適合用於封鎖請求等情境。

• IP 位址無法識別時，返回預設值 XX。

• 使用限制：查看該欄位在不同功能中的支援情況

ip.src.postal_code

請求源 IP 歸屬的城市對應的郵遞區號。

• 欄位名：郵遞區號

• 類型：String

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：否

• 樣本值："310000"

• IP 位址無法識別時，返回預設值 XX。

• 使用限制：查看該欄位在不同功能中的支援情況

ip.src.timezone

請求源 IP 對應地理位置所在的時區。

• 欄位名：時區

• 類型：String

• 是否支援區分大小寫：是

• 匹配值是否允許配置Null 字元串：否

• 樣本值："UTC+8"

• IP 位址無法識別時，返回預設值 XX。

• 使用限制：查看該欄位在不同功能中的支援情況

ssl

請求是否使用 SSL/TLS 協議。

• 欄位名： SSL/HTTPS

• 類型：Boolean

• 樣本值：true

• 使用限制：查看該欄位在不同功能中的支援情況

ali.ja3_hash

JA3 指紋是通過收集用戶端在 TLS 握手過程中 Client Hello 訊息的特定欄位（這些欄位包括 TLS 版本、可接受的密碼套件、擴充列表、橢圓曲線和橢圓曲線點格式），並且對欄位進行 MD5 雜湊處理之後產生的。

• 欄位名： JA3 指紋

• 類型：String

• 樣本值：d0bfcdbbf2c6aeb4e0fbcf8234fd6cb6

• 使用限制：查看該欄位在不同功能中的支援情況

ali.ja4

JA4 指紋是 JA3 指紋技術的一個進化版， JA4 指紋包含了更多的握手過程資訊或者是對原有資訊的不同處理方式，以便提高指紋的唯一性和準確性。

• 欄位名： JA4 指紋

• 類型：String

• 樣本值：d0bfcdbbf2c6aeb4e0fbcf8234fd6cb6

• 使用限制：查看該欄位在不同功能中的支援情況

ali.js_detection.passed

已通過 JavaScript 檢測。

• 欄位名：已通過 JavaScript 檢測

• 類型：Boolean

• 樣本值：true

• 使用限制：查看該欄位在不同功能中的支援情況

ali.static_resource

是否為靜態請求。

• 欄位名：靜態請求

• 類型：Boolean

• 樣本值：true

• 使用限制：查看該欄位在不同功能中的支援情況

ali.tls_client_auth.cert_verified

已驗證用戶端認證。

• 欄位名：已驗證用戶端認證

• 類型：Boolean

• 樣本值：true

• 使用限制：查看該欄位在不同功能中的支援情況

ali.tls_hash

請求中攜帶的 TLS 資訊對應的雜湊值。

• 欄位名： TLS 指紋

• 類型：String

• 樣本值：ABC123HASH

• 使用限制：查看該欄位在不同功能中的支援情況

ali.site.name

用戶端請求 URL 中包含的網域名稱對應的 ESA 網站名稱。

• 欄位名：網站名

• 類型：String

• 樣本值："example.com"

• 使用限制：查看該欄位在不同功能中的支援情況

http.request.body.raw

HTTP 要求的原始本文內容。

• 欄位名： HTTP 要求 Body

• 類型：String

• 樣本值："ABC123"

• 使用限制：查看該欄位在不同功能中的支援情況