Table Of Contents
Managing Maps
Viewing Maps
Adding a Map
Viewing Cookie Maps
Adding a Cookie Map
Viewing Return Code Maps
Adding a Return Code Map
Adding and Editing Match Conditions for a Return Code Map
Viewing URL Maps
Adding a URL Map
Viewing Header Maps
Adding a Header Map
Managing Maps
You can configure maps to define multiple URLs, cookies, HTTP headers, and return codes as groups that can be associated when you configure a policy.
HTTP header insert allows CVDM-CSM to insert information such as the client's IP address into the HTTP header. This feature is useful when CVDM-CSM performs source NAT and the application on the server side requires client information.
This section contains the following topics:
•
Viewing Maps
• Adding a Map
• Viewing Cookie Maps
• Adding a Cookie Map
• Viewing Return Code Maps
• Adding a Return Code Map
• Adding and Editing Match Conditions for a Return Code Map
• Viewing URL Maps
• Adding a URL Map
• Viewing Header Maps
• Adding a Header Map
Viewing Maps
Figure 8-1 Maps Page
You can view details of all maps on the device.
Step 1 Do one of the following:
•Click Home at the top of the window and click Policies under Services Dashboard.
Or:
•Click Setup from the task bar and click Policies in the Setup pane.
Step 2 Select Maps from the object selector. A table appears, displaying the following columns.
Column
|
Description
|
Map Name
|
Displays the map name.
|
Map Type
|
Displays the type for the corresponding map name.
|
Associated Policies
|
Displays the associated policies for the map type.
|
From this main dialog box, you can do the following:
•Click Add under the Maps table to add a new map. For more information, see the Adding a Map.
•Select a map and click Delete to delete an existing map.
Related Topics
• Viewing Cookie Maps
• Viewing Return Code Maps
• Viewing URL Maps
• Viewing Header Maps
The lower pane of the Map window displays the various match conditions of the selected map. The match conditions will differ according to the type of map that you select in the table.
•If you choose cookie map, the following columns appear:
Column
|
Description
|
Cookie Name
|
Name of the cookie.
|
Cookie Value
|
Value of the cookie.
|
From this dialog box, you can do the following:
–Click Add to add a cookie match conditions by entering the cookie name and value.
–Select a match condition and click Edit to edit cookie match conditions.
–Select a match condition and click Delete to delete the cookie match conditions.
•If you choose return code map, the following columns appear:
Column
|
Description
|
Match Conditions
|
Lowest Return Code
|
The lowest return code.
|
Highest Return Code
|
The highest return code.
|
Action for Return Codes
|
Action for the return code. It can one of the following:
•Count—Specifies the number of occurrences of return codes received.
•Log—Specifies where syslog messages are sent when a threshold is reached.
•Remove—Specifies where the syslog messages are sent when a threshold is reached and the server is removed from service.
|
Return Code Instances
|
Instances of the return code.
|
Reset Time after Threshold
|
Number of seconds to wait before the processing can resume.
|
From this dialog box, you can do the following:
–Click Add to add match conditions. For more information, see Adding and Editing Match Conditions for a Return Code Map.
–Select a match condition and click Edit to edit match conditions for return code maps.
–Select a match condition and click Delete to delete the match conditions for return code maps.
•If you choose URL Map, the following columns appear:
Column
|
Description
|
URL Method
|
Specifies the method in incoming HTTP requests.
|
URL
|
Specifies the URL in incoming HTTP requests.
|
From this dialog, you can do the following:
–Click Add to add URL expressions and enter the URL method and URL.
–Select a URL expression and click Edit to edit URL expressions.
–Select a URL expression and click Delete to delete it.
•If you choose header map, the following columns appear:
Column
|
Description
|
Header Name
|
Name of the generic field in the HTTP header.
|
Header Value
|
Header value string to insert in the request.
|
From this dialog box, you can access functions to do the following:
–Click Add to add header match conditions by entering the cookie name and value.
–Select a header match condition and click Edit to edit header match conditions.
–Select a header match condition and click Delete to delete the header match condition.
Adding a Map
Step 1 Do one of the following:
•Click Home at the top of the window and click Policies under Services Dashboard.
Or:
•Click Setup from the task bar and click Policies in the Setup pane.
Step 2 Select Maps from the object selector.
Step 3 Click Add. The Add map dialog box appears, displaying the following columns.
Column
|
Description
|
Map Type
|
Specify the map type. The map types are cookie, header, URL, and return code.
|
Map Name
|
Enter the map name.
|
The fields will differ according to the type of map that you select in the table.
Related Topics
• Adding a Cookie Map
• Adding a Return Code Map
• Adding a URL Map
• Adding a Header Map
Viewing Cookie Maps
Step 1 Do one of the following:
•Click Home at the top of the window and click Policies under Services Dashboard.
Or:
•Click Setup from the task bar and click Policies in the Setup pane.
Step 2 Select Maps > Cookie Maps from the object selector. The Cookie Map table appears, displaying the following columns.
Column
|
Description
|
Map Name
|
Enter the map name.
|
Associated Policies
|
The policy associated to the cookie map.
|
Step 3 When you select a map, the following columns appear in the Cookie Expressions pane:
Column
|
Description
|
Cookie Name
|
Name of the cookie map.
|
Cookie Value
|
Value of the cookie map.
|
From the Cookie Map dialog box, you can do the following:
•Click Add to add a new cookie map. For more information, see Adding a Cookie Map.
•Select a row and click Delete to delete a cookie map.
•Click Edit to edit the cookie value.
From the Cookie Expressions dialog box, you can do the following:
•Click Add to add a cookie match conditions by entering the cookie name and value.
•Select a match condition and click Edit to edit cookie match conditions.
•Select a match condition and click Delete to delete the cookie match conditions.
Adding a Cookie Map
Step 1 Do one of the following:
•Click Home at the top of the window and click Policies under Services Dashboard.
Or:
•Click Setup from the task bar and click Policies in the Setup pane.
Step 2 Select Maps > Cookie Maps from the object selector.
Step 3 Click Add. The Add Cookie Map dialog box appears, displaying the following columns.
Column
|
Description
|
Cookie Map Name
|
Enter the cookie map name.
|
Step 4 To add the match conditions for the cookie map, click Add. The Match Conditions page appears, displaying the following columns.
Column
|
Description
|
Cookie Name
|
Enter a name for the cookie.
|
Cookie Value
|
Enter a value for the cookie.
|
Note The cookie map can have a maximum of five match conditions.
From this dialog box, you can select a cookie map and click Delete to delete it.
Viewing Return Code Maps
Return code maps are used for return code error checking.
Step 1 Do one of the following:
•Click Home at the top of the window and click Policies under Services Dashboard.
Or:
•Click Setup from the task bar and click Policies in the Setup pane.
Step 2 Select Maps > Return Code Map from the object selector. A table appears, displaying the following columns.
Column
|
Description
|
Map Name
|
Name of the map.
|
Associated Server Farms
|
Server Farms associated with the map.
|
Step 3 When you select a return code map, the following details appear in the Match Condition pane:
Column
|
Description
|
Lowest Return Code
|
The lowest return code.
Note You cannot configure overlapping return codes.
|
Highest Return Code
|
The highest return code. Maximum number of return codes that can be configured is 100.
Note You cannot configure overlapping return codes.
For example, if you are already using 100-116,200-216, you cannot configure more than
(100 - (116-100+1) - (216-200_1)) = 66. You are limited to 300 - 365. If you add 300 - 366, an error message will appear.
|
Action for Return Codes
|
Action for the return code. It can one of the following:
•Count—Specifies the number of occurrences of return codes received.
•Log—Specifies where syslog messages are sent when a threshold is reached.
•Remove—Specifies where the syslog messages are sent when a threshold is reached and the server is removed from service.
|
Return Code Instances
|
Instances of the return code.
|
Reset Time after Threshold
|
Number of seconds to wait before the processing can resume.
|
From the return code map dialog box, you can do the following:
•Click Add to add a new return code map. For more information, see Adding a Return Code Map.
•Select a row and click Delete to delete a return code map.
From the Match Condition pane, you can do the following:
•Click Add to add match conditions. For more information, see Adding and Editing Match Conditions for a Return Code Map.
•Select a match condition and click Delete to delete the match condition.
Adding a Return Code Map
Step 1 Do one of the following:
•Click Home at the top of the window and click Policies under Services Dashboard.
Or:
•Click Setup from the task bar and click Policies in the Setup pane.
Step 2 Select Maps > Return Code Map from the object selector.
Step 3 Click Add. The Add Return Code Map dialog box appears, displaying the following columns.
Column
|
Description
|
Map Name
|
Enter a map name.
Click Add to add match conditions. For more information, see Adding and Editing Match Conditions for a Return Code Map.
|
Lowest Return Code
|
Enter the lowest return code.
Note You cannot configure overlapping return codes.
|
Highest Return Code
|
Enter the highest return code. Maximum number of return codes that can be configured is 100.
Note You cannot configure overlapping return codes.
For example, if you are already using 100-116,200-216, you cannot configure more than
(100 - (116-100+1) - (216-200_1)) = 66. You are limited to 300 - 365. If you add 300 - 366, an error message will appear.
|
Action for Return Codes
|
The action for the return code. It can be one of the following:
•Count—Specifies the number of occurrences of return codes received.
•Log—Specifies where syslog messages are sent when a threshold is reached.
•Remove—Specifies where the syslog messages are sent when a threshold is reached and the server is removed from service.
|
Return Code Instances
|
Enter the instances of the return code.
This feature is enabled if you select log or remove.
|
Return Code Reset
|
Select this checkbox to enable reset.
|
Reset Time after Threshold
|
Number of seconds to wait before the processing can resume.
|
From this dialog box, you can do the following:
•Click Add to add match conditions. For more information, see "Adding and Editing Match Conditions for a Return Code Map" section.
•Select a row and click Delete to delete a match condition.
Adding and Editing Match Conditions for a Return Code Map
Step 1 Do one of the following:
•Click Home at the top of the window and click Policies under Services Dashboard.
Or:
•Click Setup from the task bar and click Policies in the Setup pane.
Step 2 Select Maps > Return Code Map from the object selector.
Step 3 Click Add. The Add Return Code Map dialog box appears.
Step 4 Click Add in the dialog box to add match conditions for the selected type of return code map. The Match Conditions for Return Code Maps dialog box appears, displaying the following columns.
Column
|
Description
|
Lowest Return Code
|
Enter the lowest return code.
Note You cannot configure overlapping return codes.
|
Highest Return Code
|
Enter the highest return code. Maximum number of return codes that can be configured is 100.
Note You cannot configure overlapping return codes.
For example, if you are already using 100-116,200-216, you cannot configure more than
(100 - (116-100+1) - (216-200_1)) = 66. You are limited to 300 - 365. If you add 300 - 366, an error message will appear.
|
Action for Return Code
|
The action for the return code. It can be one of the following:
•Count—Specifies the number of occurrences of return codes received.
•Log—Specifies where syslog messages are sent when a threshold is reached.
•Remove—Specifies where the syslog messages are sent when a threshold is reached and the server is removed from service.
|
Return Code Instances
|
Enter the instances of the return code.
|
Return Code Reset
|
Select this check box to enable reset time after threshold.
|
Reset Time after Threshold
|
Enter the number of seconds to wait before the processing can resume.
|
Viewing URL Maps
Step 1 Do one of the following:
•Click Home at the top of the window and click Policies under Services Dashboard.
Or:
•Click Setup from the task bar and click Policies in the Setup pane.
Step 2 Select Maps > URL Maps from the object selector. The following fields appear:
Column
|
Description
|
Map Name
|
The name of the map
|
Associated Policies
|
Policies associated with the map.
|
Step 3 When you select a map, the match conditions for the map appears:
Column
|
Description
|
URL Method
|
Specifies the URL Method to match.
|
URL
|
Specifies the URL associated with the map.
|
From the URL Map dialog box, you can do the following:
•Click Add to add a new URL Map. For more information, see Adding a URL Map.
•Select a row and click Delete to delete a URL Map.
From the Match Conditions pane, you can do the following:
•Click Add to add match conditions by specifying the URL method and URL. For more information, see Adding a URL Map.
•Select a URL expression and click Edit to edit the match conditions to edit the URL.
•Select a URL expression and click Delete to delete a match condition.
Adding a URL Map
Step 1 Do one of the following:
•Click Home at the top of the window and click Policies under Services Dashboard.
Or:
•Click Setup from the task bar and click Policies in the Setup pane.
Step 2 Select Maps > URL Maps from the object selector.
Step 3 Click Add. The Add URL Map dialog box appears, displaying the following columns:
Column
|
Description
|
URL Map Name
|
Enter the URL map name.
|
Step 4 To add the match conditions for the URL map, click Add. The Add URL Conditions dialog box appears, displaying the following columns.
Column
|
Description
|
URL Method
|
Click  and from the list, select or enter a URL method to match.
|
URL
|
Enter the URL associated with the map.
|
Viewing Header Maps
Step 1 Do one of the following:
•Click Home at the top of the window and click Policies under Services Dashboard.
Or:
•Click Setup from the task bar and click Policies in the Setup pane.
Step 2 Select Maps > Header Maps from the object selector. The Header Maps table appears, displaying the following columns:
Column
|
Description
|
Map Name
|
The name of the header map.
|
Associated Policies
|
The policies associated with the header map.
|
Step 3 When you select a header map, the following columns appear in the Match Conditions/Insert Conditions pane:
Column
|
Description
|
Header Name
|
Name of the generic field in the HTTP header.
|
Header Value
|
Header value string to insert in the request.
|
When receiving an HTTP request, you can specify the name of the field and the corresponding value for the CVDM-CSM to match.
Note CVDM-CSM allows you to specify one or more fields in the HTTP header for policy matching. When you configure multiple fields in a single HTTP header group, all of the expressions in this group must match in order to satisfy this criteria.
For more information on HTTP Header Insert, see HTTP Header Insert.
From this dialog box, you can do the following:
•Click Add to add a new header map. For more information, see Adding a Header Map.
•Select a map and click Delete to delete a header map.
•Click Add under the Match Conditions/Insert Conditions pane, to add match condition by entering the header name and value. For more information, see Adding a Header Map.
•Click Edit under the Match Conditions/Insert Conditions pane to edit the match conditions.
•Select a match condition, and click Delete under the Match Conditions/Insert Conditions pane, to delete a match condition.
HTTP Header Insert
The HTTP header insert feature provides CVDM-CSM with the ability to insert information, such as the client's IP address, into the HTTP header. This is useful when CVDM-CSM performs source NAT and the application on the server side requires client information.
Specify the header name and value to insert information into the HTTP header. You can also use the %is and %id special parameters for header values. The %is value inserts the source IP into the HTTP header and the %id value inserts the destination IP into the header. You can specify each special parameter once per header map.
Note A header map may contain multiple insert headers. If you insert header values that are made of multiple keywords that includes spaces, you must use double quotes around the entire expression.
Adding a Header Map
Step 1 Do one of the following:
•Click Home at the top of the window and click Policies under Services Dashboard.
Or:
•Click Setup from the task bar and click Policies in the Setup pane.
Step 2 Select Maps > Header Maps from the object selector.
Step 3 Click Add. The Add header map dialog box appears.
Column
|
Description
|
Header Map Name
|
Enter a header name.
|
Step 4 Do one of the following:
•Click the Match Conditions tab. A table appears, displaying the following.
When receiving an HTTP request, you can specify the name of the field and the corresponding value for the CVDM-CSM to match.
Note CVDM-CSM allows you to specify one or more fields in the HTTP header for policy matching. When you configure multiple fields in a single HTTP header group, all of the expressions in this group must match in order to satisfy this criteria.
Column
|
Description
|
Header Name
|
Name of the generic field in the HTTP header.
|
Header Value
|
Header value string to insert in the request.
|
From this dialog box, you can do the following:
–Click Add to add match conditions. The Add Header Insert Conditions dialog box appears and allows you to enter the header name and value
–Select a match condition and click Delete to delete it.
•Click the Insert Conditions tab. A table appears, displaying the following.
Column
|
Description
|
Header Name
|
Name of the generic field in the HTTP header.
|
Header Value
|
Header value string to insert in the request.
|
For more information on HTTP Header Insert, see HTTP Header Insert.
From this dialog box, you can do the following:
–Click Add to add match conditions. The Add Header Match Conditions dialog box appears and allows you to enter the header name and value.
–Select a match condition and click Delete to delete it.
