Chapter 6: Definition Reference

define url.domain condition

Binds a user-defined label to a set of domain-suffix patterns for use in a condition= expression. Using this definition block allows you to test a large set of server_url.domain= conditions very quickly. Although the define condition definition block could be used in a similar way to encapsulate a set of domain suffix patterns, this specialized definition block provides a substantial performance boost.

For domain and prefix definitions, the manner in which the URL patterns and any condition expressions are listed is significant. Each line begins with a URL pattern and, optionally, one or more condition expressions, all of which have a Boolean AND relationship. Each line inside the definition block is considered to have a Boolean OR relationship with other lines in the block.

Syntax

define url.domain condition label domain_suffix_pattern [condition_expression ...]

...

end [url.domain condition label]

where:

label—A user-defined identifier for a domain condition definition. Used in a condition= condition.

domain_suffix_pattern—A URL pattern suitable to the url.domain= condition, that includes a domain name (domain), as a minimum. See the url= condition reference for a complete description.

condition_expression ...—An optional condition expression, using any of the conditions available in a rule. For more information, see Chapter 3: "Condition Reference". The layer and timing restrictions for the defined condition will depend on the layer and timing restrictions of the contained expressions.

The condition= condition is one of the expressions that can be included in the body of a define url.domain condition definition block, following a URL pattern. In this way, one domain definition block can call another condition-related definition block, so that they are in effect nested. See the example in the define condition definition block topic.

Layer and Transaction Notes

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

Applies to all transactions.

Example

define domain condition allowed inventory.example.com method=GET affinityclub.example.com

end

<proxy> condition=allowed allow

263

Page 263
Image 263
Blue Coat Systems Proxy SG manual Define url.domain condition