Condition Field Description¶
When setting a precise access, CC attack protection, or global protection whitelist rule, there are some fields in the Condition List or Trigger area. These fields together are used to define the request attributes to trigger the rule. This topic describes the fields that you can specify in conditions to trigger a rule.
What Is a Condition Field?¶
A condition field specifies the request attribute WAF checks against protection rules. When configuring a precise access protection rule, CC attack protection rule, or global protection whitelist, you can define condition fields to specify request attributes to trigger the rule. If a request meets the conditions set in a rule, the request matches the rule. WAF handles the request based on the action (for example, allow, block, or log only) set in the rule.
Figure 1 Condition field¶
A condition field consists of the field, subfield, logic, and content. Example:
Example 1: If Field is set to Path, logic to Include, and Content to /admin, a request matches the rule when the requested path contains /admin.
Example 2: Set Field to IPv4, Subfield to Client IP Address, Logic to Equal to, and Content to 192.XX.XX.3. When the client IP address is 192.XX.XX.3, the request hits the rule.
Supported Condition Fields¶
Field | Subfield | Logic | Content (Example) |
|---|---|---|---|
Path: part of a URL that does not include a domain name. This value supports exact matches only, so that the path to be protected must be the same as the path you specify for this parameter. For example, if the path to be protected is /admin, Path must be set to /admin. | -- | Select the desired logical relationship from the Logic drop-down list. | /buy/phone/ Important NOTICE:
|
User Agent: a user agent of the scanner to be protected | -- | Mozilla/5.0 (Windows NT 6.1) | |
IP: An IP address of the visitor. | -- | XXX.XXX.1.1 | |
Params: the request parameter to be protected |
| 201901150929 | |
Referer: the user-defined request resource For example, if the protected path is /admin/xxx and you do not want visitors to access the page from www.test.com, set Content for Referer to http://www.test.com. | -- | ||
Cookie: a small piece of data to identify web visitors |
| jsessionid | |
Header: the user-defined HTTP header |
| text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,/;q=0.8 | |
Method: the user-defined request method. | -- | GET, POST, PUT, DELETE, and PATCH | |
Request Line: the length of a user-defined request line. | -- | 50 | |
Request: the length of a user-defined request. It includes the request header, request line, and request body. | -- | -- | |
Protocol: The protocol of the request. | -- | http | |
Response Code: the status code returned to the request. | -- |
| 404 |
Response Length: the length of the response to the request. | -- |
| -- |
Response Time: time to respond the request. | -- |
| -- |
Response Header: response header. |
|
| -- |
Response Body: response message body | -- |
| -- |
Request Body: request message body. | -- |
| -- |