Product Documentation

Configuring a Content Filtering Action

Sep 03, 2013

After you enable the content filtering feature, you create one or more actions to tell your NetScaler appliance how to handle the connections it receives.

Content filtering supports the following actions for HTTP requests:
Add
Adds the specified HTTP header before sending the request to the Web server.
Reset
Terminates the connection, sending the appropriate termination notice to the user’s browser.
Forward
Redirects the request to the designated service.
Drop
Silently deletes the request, without sending a response to the user’s browser.
Corrupt
Modifies the designated HTTP header in a manner that prevents it from performing the function it was intended to perform, then sends the request to the server.
Content filtering supports the following actions for HTTP responses:
Add
Adds the specified HTTP header before sending the response to the user’s browser.
ErrorCode
Returns the designated HTTP error code to the user’s browser.
Corrupt
Modifies the designated HTTP header in a manner that prevents it from performing the function it was intended to perform, then sends the response to the user’s browser.

To configure a content filtering action by using the command line interface

At the command prompt, type the following commands to configure a Content Filtering action and verify the configuration:
  • add filter action <name> <qualifier> [<serviceName>] [<value>] [<respCode>] [<page>]
  • show filter action <name>
Example
 
> add filter action act_drop Drop 
 Done 
> show filter action act_drop 
1)      Name: act_drop   Filter Type: drop 
 Done

To configure a content filtering action by using the configuration utility

  1. Navigate to Security > Protection Features > Filter.
  2. In the details pane, do one of the following:
    • To create a new action, click Add.
    • To modify an existing action, select the action, and then click Open.
  3. In the Add Filter Action or Configure Filter Action dialog box, specify values for the parameters:
    • Action Name*—name
    • Qualifier*—qualifier ( Determines which of the following parameters you can configure)
    • Service Name—servicename
    • HeaderName:Value—value
    • Response Code—respcode
    • Response Page—page
  4. Fill in any other required information. For example, if you are configuring an action to send an HTTP error code, you must choose the appropriate error code from a drop-down list. If necessary, you can then modify the text of the error message, which is displayed beneath the drop-down list.
  5. Click Create or OK, and then click Close. The Actions list displays the action you configured, and a message in the status bar indicates that your action has been created.