You can use Extended Match and Condition expressions in content rules, HTTP request rewrite rules, and HTTP response rewrite rules. To learn more about these rules, all of which only apply to Layer 7 - HTTP(S) Services, see the following:
In this article:
This article documents the syntax of the extended match and condition expressions. For example:
Header Host co example.com- match a request whose Host header contains example.com
Parameter userid ex- match any request in which the parameter 'userid' is present
(Header Host eq www.example.com) && (Client-IP eq 10.0.0.0/24)- match a request whose host header is
www.example.comand the requesting client's IP address is in the 10.0.0.* subnet.
The following explains the components of an Extended Match or Condition expression.
An expression consists of one or more Element Matches, combined using Join operators to indicate AND and OR operations to combine the Element Matches. Parentheses must be used to delimit individual Element Matches when using join operators. Parentheses can be nested.
An Element Match consists of an Element, an optional Element Name, an Operator followed by an optional Value. Some elements like “Header” require an Element Name like “User-Agent”, whereas some elements like “HTTP-Version” require no further qualification. Also, some operators like “eq” (stands for “equals”) require a value, whereas some operators like “ex” (stands for “exists”) require no value.
Tokens are delimited by space and the parenthesis characters. Double quotes (") can be used to enclose single tokens which contain parenthesis characters or spaces. The back-slash character can also be used to escape, that is, remove the special meaning of the special characters (space and parentheses).
The following are the possible operators in an Element Match. The operators are case insensitive; for example, “eq”, “Eq” and “EQ” are all treated the same.
|True if the operand is equal to the given value. A case insensitive string comparison is performed. Thus, a value of “01” is not the same as a value of “1”, whereas values “one” and “ONE” are treated the same.|
|True if the operand is not equal to the given value. A case insensitive string comparison is performed.|
|True if the operand contains the given value.|
|True if the operand does not contain the given value.|
|True if the operand contains the given value, which is treated as a regular expression.|
|True if the operand does not contain the given value, which is treated as a regular expression.|
|True if the operand matches the given value, which is treated as a regular expression.|
|True if the operand does not match the given value, which is treated as a regular expression.|
|True if the operand exists. A value is not required.|
|True if the operand does not exist. A value is not required.|
The following are the different Elements allowed in the expression. Elements and Element Names are case insensitive, so “Method” and “METHOD” are treated the same.
The HTTP Method that was received in the request.
This refers to the version of the HTTP protocol of the request.
An HTTP header in the request. An Element Name to identify which header is required to follow the word “Header”.
This refers to the IP address of the client sending the request. The IP address can be either host IP address or subnet IP address specified by a mask. Only “
The URI is the Uniform Resource Identifier in the request. This includes any query parameters in the request.
This refers to the path portion of the URI, which excludes any query parameters.
This refers to the portion of URL which is interpreted as
This refers to a parameter in the query string part of the URL. the servers as a name-value pair. The special parameter “
This refers to the status code of the response returned by the servers.
This refers to the HTTP response header in the response. The term “
Example: (Response-Header Set-Cookie co sessionid)
Each expression can be joined with another expression by one of the following:
|True if either of the expressions are true.|
|True only if both the expressions are true.|
More than one Element Match can be combined together by using the join operators
&& provided the Element Matches are enclosed in parentheses. Combining Element Matches without parentheses is not allowed.
(Header cookie ex) && (URI rco .*\.html) && (Method eq GET)
Nested sub-expressions can be created by enclosing parentheses within expressions. This makes the expression more readable as well as unambiguous.
(HTTP-Version eq HTTP/1.1) && ((Header Host eq www.example.com) || (Header Host eq website.example.com))
The space character and the parentheses characters are special characters since they cause the parser to split the string into tokens at these separators. In some cases, it is required to specify these characters as part of the value itself. For example, the User-Agent header typically contains both spaces and parentheses, as in:
User-Agent: Mozilla/5.0 (Linux i686; en-US; rv:22.214.171.124) Firefox/126.96.36.199
The spaces and parenthesis characters in such cases must be escaped by prefixing these characters with a back-slash (\), or the entire value can be enclosed in double-quotes (“).
- Header User-Agent eq “Mozilla/5.0 (Linux i686; en-US; rv:188.8.131.52) Firefox/184.108.40.206”
- Header User-Agent eq Mozilla/5.0\ \(Linux\ i686;\ en-US;\ rv:220.127.116.11\)\ Firefox/18.104.22.168
To specify the double-quote character itself, it must be escaped with a back-slash. This is true inside a quoted string, or a non-quoted string. Note that the single quote character has no special meaning, and is treated as any other character.
To specify the back-slash character itself, it must be escaped as “
\\”. This is true within both quoted strings and non-quoted strings.
The back-slash character escapes all characters, not just the special characters. Thus, “
\c” stands for the character “
c” etc. In other words, back-slash followed by any character stands for the character, whether or not that character has a special meaning in the syntax.
The Barracuda Load Balancer supports several macros to assist in configuring policies. The following table describes these macros arranged by the areas where they can be used. The URI in these cases does not include the host.
|Inserts the source (client) IP address. You can use it for the new value (Rewrite Value parameter) when inserting or rewriting a header.|
|Should be specified in the new value, if you are rewriting or redirecting the URI. $URI specifies the complete request URI including the query string.|
|Adds the username. (1) (2) (3)|
|Adds the password. (1) (2) (3)|
Adds the user roles. (1) (2) (3)
|Inserts a parameter with no name (see No Name Parameters)|
(1) The URL is not protected, i.e. access-control or authentication is off. The value substituted for the macro is the special string
No Name Parameters
The Barracuda Load Balancer treats
xyz as the value of a parameter. In this case, you cannot create an exception rule based on the
xyz value because there is no way to associate it with a named parameter.
To address such situations (that is, requests with parameter name-value pairs of the type
xyz is the value), you can use a special token:
$NONAME_PARAM (case insensitive). This token allows you to create an expression for a parameter without a name as in the following examples:
set = parameter $NONAME_PARAM ex
set = parameter $NONAME_PARAM eq 0
set = parameter $noname_param co xyz