Filter
Top Products
ProxySG Content Policy Language Guide
250
define category
Category definitions are used to extend vendor content categories or to create your own. The
category_name
definition can be used anywhere a content filter category name would normally be
used, including in
category= tests.
Definitions can include other definitions to create a hierarchy. For example, sports could include
football by including
category=football in the definition for sports. A defined category can have at
most one parent category (multiple inheritance is not allowed).
Multiple definitions using the same
category_name are coalesced together.
When policy tests a request URL to determine if it is in one of the categories specified by a trigger, all
sub-categories are also checked (see Examples).
Syntax
define category category_name
urlpaths
end [category_name]
where:
•
category_name—If category_name matches the name of an existing category from the
configured content filtering service, this is used to extend the coverage of that category; otherwise
it defines a new user defined category.
category_name can be used anywhere a content filter
category name would normally be used, including in
category= tests.
•
urlpaths—A list of domain suffix or path prefix expressions, as used in the url.domain=
condition.You only need to specify a partial URL:
❐ Hosts and subdomains within the domain you specify are automatically included.
❐ If you specify a path, all paths with that prefix will be included (if you specify no path, the
entire site is included).
Layer and Transaction Notes
•Use in
<Proxy> and <Cache> Layers.
• Applies to all transactions.
Examples
The following example illustrates some of the variations allowed in a category definition:
define category Grand_Canyon
kaibab.org
www2.nature.nps.gov/ard/parks/grca/
nps.gov/grca/
grandcanyon.org
end
The following definitions define the categories sports and football, and make football a sub-category
of sports:
define category sports
sports.com