Cisco Anomaly Guard Module Configuration Guide (Software Version 4.0)
Interactive Protect Mode

Table Of Contents

Interactive Protect Mode

Overview

Activating the Interactive Protect Mode

Viewing Recommendations

Activating Recommendations


Interactive Protect Mode


The Guard module analyses diverted zone traffic in search of policy threshold violations. Once it detects a policy threshold violation, it analyses the results and creates a set of filters that can either be activated automatically or interactively. This chapter describes the interactive protect mode and includes the following major sections:

Overview

Activating the Interactive Protect Mode

Viewing Recommendations

Activating Recommendations

Overview

When a DDoS attack begins, the Guard module policies create Dynamic filters. When the zone is in interactive protect mode, the Guard module does not activate these Dynamic filters automatically, but waits for your decision. These filters are called pending Dynamic filters. The recommendations are a summary of the pending filters according to the policies that produced them. The information includes the policy name that recommended it, data on the traffic anomaly that resulted in policy activation, the number of pending Dynamic filters and the recommended action. You decide which pending Dynamic filters to accept, ignore, or direct to automatic activation, thus giving you greater control over what measures to take when an attack is in progress.

The Guard continues to produce pending Dynamic filters to protect the zone as long as it is in interactive protect mode. You can activate interactive protect mode at any time during zone protect mode, but can only view recommendations and their pending Dynamic filters if the Guard is in interactive protect mode and a DDoS attack on the zone is in progress. You can apply the interactive protect to a zone when defining the zone, or before or after initiating zone protect mode.

When the The Guard module has more than 1000 pending Dynamic filters, it performs the following:

It displays an error message instructing you to deactivate the zone and reactivate it in automatic protect mode

It records the recommendations in the zone log file and report and then discards them

The Guard module does not display a notification when new recommendations are available. To keep track of recommendations, do one of the following:

Use the show command in zone configuration mode to view the status of the zone

Use the event monitor command to receive notification when a new pending Dynamic filter is created

Use an external syslog server to receive notification of new pending Dynamic filters

You can stop interactive protect mode at any time and return to automatic protect mode. The Guard module disregards any decisions made while in the interactive mode and accepts all currently pending Dynamic filters. The policies resume their role of automatically producing and activating the Dynamic filters (see "Configuring Policy Templates and Policies").

Activating the Interactive Protect Mode

To activate the interactive protect mode for an existing zone, enter interactive in zone configuration mode.

To create a new zone configured for interactive protect mode, enter the following command in configuration mode:

zone new-zone-name interactive

The new-zone-name argument specifies the name of the new zone. The zone name is an alphanumeric string that must start with a letter, cannot include any spaces and can have no more than 63 characters.

For example:

admin@GUARD-conf# zone scannew interactive

The new zone is created with a default zone template, configured for interactive protect mode. See "Configuring Zones" for further details.

Use the no interactive command to deactivate the interactive protect mode. When you deactivate the interactive protect mode, the interactive status of the policies becomes always-accept.

Viewing Recommendations

Use the show recommendations command to view a list of all recommendations, a list of pending Dynamic filters or a specific recommendation for a zone. Enter the following command:

show recommendations [recommendation-id] [pending-filters]

Table 9-1 provides the keywords and arguments for the show recommendations command.

Table 9-1 Keywords and Arguments for the show recommendations Command 

Parameter
Description
recommendation-id

(Optional) The ID for a specific recommendation.

pending-filters

(Optional) Displays a list of the pending filters for a specific recommendation.


For example:

admin@GUARD-conf-zone-scannet# show recommendations

Table 9-2

Table 9-2 Field Descriptions for the show recommendations Command 

Field
Description

ID

The recommendation identification number.

Policy

The policy that created the recommendation.

Threshold

The policy threshold that was violated.

Detection date

The date and time the recommendation was created.

Attack flow

The characteristics of the attack flow. The characteristics include the protocol number, source IP address, source port, destination IP address, destination port and indicates whether the traffic is fragmented or not. Any indicates that there is both fragmented and non-fragmented traffic.

Min current rate

The minimum attack rate measured in pps.

For recommendations that have several pending Dynamic filters, the rate of the lowest pending Dynamic filter is displayed.

Max current rate

Maximum attack rate measured in pps.

For recommendations that have several pending Dynamic filters, the rate of the highest pending Dynamic filter is displayed.

No. of pending-filters

The number of pending Dynamic filters that were created as a result of the policy threshold violations.

Recommended action

The recommended action. This action is taken if you accept the recommendation.


describes the fields in the show recommendations command output.

Use the show recommendations command to display a list of all recommendations with recommendation IDs before displaying pending filters for a specific recommendation.

Table 9-3 describes the fields in the show recommendations pending-filters command output.

Table 9-3 Field Descriptions for the show recommendations pending-filters Command 

Field
Description

ID

The recommendation identification number.

Policy

The policy that created the recommendation.

Threshold

The policy threshold, in pps, that was violated.

Pending-filter-id

The pending Dynamic filter identification number.

Detection date

The date and time the recommendation was created.

Attack flow

The flow characteristics of the attack. The characteristics include the protocol number, source IP address, source port, destination IP address, destination port and indicates whether the traffic is fragmented or not. Any indicates that there is both fragmented and non-fragmented traffic.

Triggering rate

The attack rate (in pps) that triggered the creation of the pending Dynamic filter.

Current rate

The current attack rate in pps.

Recommended action

The recommended action. This action is taken if you accept the recommendation.

Action flow

The resulting characteristics of traffic flow to the zone if you accept the pending Dynamic filter. The characteristics include the protocol number, source IP address, source port, destination IP address, destination port and indicates whether the traffic is fragmented or not. Any indicates that there is both fragmented and non-fragmented traffic.


A value of * for any of the parameters indicates one of the following:

The value is undetermined

More than one value was measured for the parameter


Note You can only view recommendations and their pending Dynamic filters if the Guard is in interactive protect mode and a DDoS attack on the zone is in progress.


For example:

admin@GUARD-conf-zone-scannet# show recommendations 135 pending-filters

Activating Recommendations

You can decide whether or not to activate recommendations. You can make decisions for all recommendations, a specific recommendation, or for a specific pending Dynamic filter. Your decisions determine whether the pending Dynamic filters in a policy become Dynamic filters and for how long.

You can instruct the Guard module to automatically activate the pending Dynamic filters of a specific policy. You can also instruct the Guard module to prevent policies from producing recommendations. The Guard module policies continue to produce recommendations as the DDoS attack continues and changes its characteristics.

View the zone status after making decisions to verify your decisions.


Note When you accept a recommendation, additional recommendations that contain the same or partial flow as the accepted recommendation and have the same action and timeout are also accepted. The Guard module deletes these recommendations.


Use the recommendation command in zone configuration mode to decide on recommendations for a zone. Enter the following command:

recommendation recommendation-id [pending-filters pending-filter-id] decision [timeout]

Table 9-4 provides the arguments and keywords for the recommendation command.

Table 9-4 Arguments and Keywords for the recommendation Command 

Parameters
Description

recommendation-id

The specific recommendation identification number. An asterisk (*) is a wildcard indicating all recommendations.

pending-filter-id

(Optional) The ID for a specific pending Dynamic filter.

decision

The action taken on the recommendation. Possible values are:

accept—Accepts the specific recommendation. The pending Dynamic filters become Dynamic filters.

always-accept—Accepts the specific recommendation. The decision applies automatically whenever the recommendation policy produces new recommendations. Pending Dynamic filters automatically become Dynamic filters. If you take this action, the Guard will no longer display such recommendations.

always-ignore—Ignores the specific recommendation. No Dynamic filter or pending v filters are produced. The decision automatically applies to all future recommendations produced by the policy. If you decide to always ignore a recommendation, the Guard no longer display it.

timeout

(Optional) The length of time in seconds that the decision applies. Possible value are:

forever—The Guard activates the Dynamic filters (see the "Configuring Dynamic Filters" section for further details) produced by the recommendations for as long as protection is in effect.

new-timeout—The Guard activates the Dynamic filters (see "Configuring Dynamic Filters" section for further details) produced by the policies for period of time that you define.


You can configure the interactive status for a specific policy, or any part of it, and decide whether that part of the policy should produce recommendations and pending Dynamic filters. See "Configuring the Interactive Status" section for further details. This gives you greater control and enables you to improve how policies adapt to traffic flows.

The Guard does not display always-accept or always-ignore recommendations. When you decide to always ignore or accept a recommendation, your decision becomes part of the interactive-status of the policy that created the recommendation.

You can disable or inactivate a policy in order to prevent it from producing recommendations and their pending Dynamic filters. Use the state command to disable or inactivate a policy. See the "Changing the Policy State" section for further details.

The following example configures the interactive status for dns_tcp policy templates with service 53, using the analysis protection module:

admin@GUARD-conf-zone-scannet-policy-/dns_tcp/53/analysis/# 
interactive-status always-accept 

See "The Policy Sections" section for further details.