Blue Coat Systems Proxy SG define action

ProxySG Content Policy Language Guide

246

define action

Binds a user-defined label to a sequence of action statements. The action( ) property has syntax that

allows for individual action definition blocks to be enabled and disabled independently, based on the

policy evaluation for the transaction. When an action definition block is enabled, any action

statements it contains operate on the transaction as indicated by their respective arguments. See

Chapter 5: "Action Reference" for more information about the various action statements available.

Note: Action statements that must be performed in a set sequence and cannot overlap are best listed

within a single action definition block

Syntax

define action label

list of action statements

end [action label]

where:

•label—A user-defined identifier for an action definition. Only alphanumeric, underscore, and

dash characters can be used in the label given to a defined action.

•list of action statements—A list of actions to be carried out in sequence. See Chapter 5

Action Reference for the available actions.

Layer and Transaction Notes

Each action statement has its own timing requirements and layer applicability. The timing

requirements for the overall action are the strictest required by any of the action statements contained

in the definition block.

Similarly, the layers that can reference an action definition block are the layers common to all the

action statements in the block.

Action statements that are not appropriate to the transaction will be ignored.

Example

The following is a sample action given the name scrub_private_info, that clears the From and

Referer headers (which normally could be used to identify the user and where they clicked from) in

any request going to servers not in the internal domain.

<cache>

url.domain=!my_internal_site.com action.scrub_private_info(yes)

define action scrub_private_info

set( request.header.From, "" )

set( request.header.Referer, "" )

end

Notice that the object on which the set( ) action operates is given in the first argument, and then

appropriate values follow, in this case, the new value for the specified header. This is common to

many of the actions.