ProxySG Content Policy Language Guide

request.header.Referer.url=

Test if the URL specified by the Referer header matches the specified criteria. The basic request.header.Referer.url= test attempts to match the complete Referer 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 URL is not tested and can have any value.

Specific portions of the Referer 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.

This trigger is unavailable if the Referer header is missing, or if its value cannot be parsed as a URL. If the Referer header contains a relative URL, the requested URL is used as a base to form an absolute URL prior to testing.

Syntax

request.header.Referer.url[.case_sensitive][.no_lookup]=prefix_pattern request.header.Referer.url.domain[.case_sensitive][.no_lookup]=

domain_suffix_pattern

request.header.Referer.url.regex[.case_sensitive]=regular_expression

request.header.Referer.url.address=ip_addresssubnetsubnet_label request.header.Referer.url.extension[.case_sensitive]=[.]filename_extension

request.header.Referer.url.host[.exact][.no_lookup]=host request.header.Referer.url.host.[prefixsubstringsuffix][.no_lookup]=string request.header.Referer.url.host.is_numeric=yesno request.header.Referer.url.host.no_name=yesno

request.header.Referer.url.path[.case_sensitive]=/string request.header.Referer.url.path[.substring.suffix][.case_sensitive]=string request.header.Referer.url.path.regex[.case_sensitive]=regular_expression

request.header.Referer.url.port={[low_port_number]..[high_port_number] exact_port_number}

request.header.Referer.url.query.regex[.case_sensitive]=regular_expression

request.header.Referer.url.scheme=url_scheme

where all options are identical to url=, except for the URL being tested. For more information, see "url=" on page 137.

Discussion

The request.header.Referer.url= condition is identical to url=, except for the lack of a define url condition and [url] or [url.domain] sections.

Layer and Transaction Notes

Use in <Proxy>, <Cache>, and <Exception> layers.

Applies to HTTP proxy transactions.

Examples

; Test if the Referer URL includes this pattern, and block access.

118

Page 118
Image 118
Blue Coat Systems Proxy SG manual Request.header.Referer.url=, Domainsuffixpattern