Chapter 3: Condition Reference
url=
Tests if a portion of the requested URL matches the specified criteria. The basic url= test attempts to match the complete request URL against a specified pattern. The pattern may include the scheme, host, port, path and query components of the URL. If any of these is not included in the pattern, then the corresponding component of the request URL is not tested and can have any value.
Specific portions of the URL can be tested by applying URL component modifiers to the trigger. In addition to component modifiers, optional test type modifiers can be used to change the way the pattern is matched.
Note: This set of tests match against the originally requested URL, disregarding the effect of any rewrite( ) actions. Because any rewrites of the URL intended for servers or other upstream devices must be respected by <Forward> layer policy, the url= triggers are not allowed in <Forward> layers. Instead, an equivalent set of server_url= tests are provided for use in the <Forward> layer. Those tests always take into account the effect of any rewrite( ) actions on the URL.
Replaces: various url_xxx forms; url.scheme= replaces protocol=.
Syntax
url[.case_sensitive][.no_lookup]=prefix_pattern url.domain[.case_sensitive][.no_lookup]=domain_suffix_pattern url.regex[.case_sensitive]=regular_expression
url.address=ip_addresssubnetsubnet_label
url.extension[.case_sensitive]=[.]filename_extension
url.host[.exact][.no_lookup]=host url.host.[prefixsubstringsuffix][.no_lookup]=string url.host.regex[.no_lookup]=regular_expression url.host.is_numeric=yesno url.host.no_name=yesno
url.path[.case_sensitive]=/string url.path[.substring.suffix][.case_sensitive]=string url.path.regex[.case_sensitive]=regular_expression
url.port={[low_port_number]..[high_port_number]exact_port_number}
url.query.regex[.case_sensitive]=regular_expression
url.scheme=url_scheme
where the URL test patterns are:
•
Accepted prefix patterns include the following:
scheme://host scheme://host:port scheme://host:port/path_query scheme://host/path_query //host
137
