Справочник Пользователя для Blue Coat Systems Time Clock Proxy SG

Chapter 5: Action Reference

235

redirect( ) 

Ends the current HTTP transaction and returns an HTTP redirect response to the client by setting the 

policy_redirect

 exception. Use this action to specify an HTTP 3xx response code, optionally set 

substitution variables based on the request URL, and generate the new Location response-header URL 
after performing variable substitution.

FTP over HTTP requests are redirected for Netscape Navigator clients, but not Microsoft Internet 
Explorer clients. To avoid this issue, do not use the 

redirect( )

 action when the 

url.scheme=ftp

 

condition is true. For example, if the 

http_redirect

 action definition contains a 

redirect( )

 action, 

you can use the following rule:

url.scheme=ftp action.http_redirect(no)

An error results if two 

redirect( )

 actions conflict. The error is noted at compile time if the 

conflicting actions are within the same action definition block. A runtime error is recorded in 
the event log if the conflicting actions are defined in different blocks. 

It is possible to put the browser into an infinite redirection loop if the URL that the 
browser is being redirected to also triggers a policy-based redirect response.

redirect(response_code, regex_pattern, replacement_url)

where:

•

—An HTTP redirect code used as the HTTP response code; supported codes are 

301, 302, 305, and 307.

•

—A quoted regular-expression pattern that is compared with the request URL 

based on an anchored match. If the 

 does not match the request URL, the redirect 

action is ignored. A 

 match sets the values for substitution variables. If no variable 

substitution is performed by the 

 string, specify 

".* "

 for 

 to 

match all request URLs. For more information about regular expressions, refer to Appendix E, 
“Using Regular Expressions,” in the Blue Coat ProxySG Configuration and Management Guide.

•

—A quoted string that can optionally include one or more variable 

substitutions, which replaces the entire URL once the substitutions are performed. The resulting 
URL is considered complete, and replaces any URL that contains a substring matching the 

 substring. Sub-patterns of the 

 matched can be substituted in 

 using the 

$(n)

 syntax, where 

 is an integer from 1 to 32, specifying the 

matched sub-pattern. For more information, see Appendix D: "CPL Substitutions". 

•

Use in 

<Proxy>

 or 

<Cache>

 layers.

•

Do not use in 

<Admin>

, 

<Forward>

, or 

<Exception>

 layers.

•

Actions

: rewrite(url.host, host_regex_pattern, replacement_host)

, 

rewrite(url, 

regex_pattern, replacement_url)

, 

set(url.port, port_number)

•

Conditions: exception.id=