Cisco Guard Configuration Guide (Software Version 3.1(0))
Attack Reports

Table Of Contents

Attack Reports

Report Layout

General Details

Attack Statistics

Dropped/ Replied Packets

Detected Anomalies

Mitigated Attacks

Spoofed

Zombie

Client Attack

User Defined

Malformed Packets

Zombies

Report Parameters

Viewing Attack Reports

Exporting Attack Reports


Attack Reports


This chapter describes the attack reports that the Guard produces and includes the following topics:

Report Layout

Report Parameters

Viewing Attack Reports

Exporting Attack Reports

Report Layout

The Guard provides an attack report for each zone to help form a clearer picture of the attack. An attack begins when the first dynamic filter is produced and ends when no new dynamic filters are added. Reports include details of the attacks organized into sections. Each section describes different aspects of the traffic flow during an attack. You can view reports for past attacks and ongoing attacks and can export reports to an ftp server.

Reports include the following sections:

General Details

Attack Statistics

Dropped/ Replied Packets

Detected Anomalies

Mitigated Attacks

Zombies—This section is only available when you issue the show reports details and show zombies commands

General Details

This section of the attack report includes general information about an attack. Table 9-1 describes the fields in this section of the report.

Table 9-1 Field Descriptions in General Details Section of Attack Report

Field
Description

Report ID

The identification number of the report.

Attack Start

Displays the date and time that the attack started.

Attack End

Displays the date and time that the attack ended. Attack in progress indicates that there an ongoing attack.

Attack Duration

Displays the duration of the attack.


Attack Statistics

The Attack Statistics provide a general analysis of the zone traffic flow for various packets. Table 9-2 describes for the packet types.

Table 9-2 Packet Types 

Type
Description

Received

Represents the total amount of the diverted traffic.

Forwarded

Represents the legitimate traffic the Guard forwarded on to the zone.

Replied

Represents the traffic the Guard anti-spoofing and anti-zombie mechanisms sent back to the source in a verification attempt.

Dropped

Represents the traffic the Guard dropped.


Dropped/ Replied Packets

The Dropped/Replied Packets section of the attack report analyzes the packets that were dropped and replied. The report classifies the packets by their type (spoofed or malformed) and by their handling mechanism (filter types, or rate limiter). Table 9-3 describes the different kinds of dropped packets

Table 9-3 Types of Dropped/Replied Packets 

Type
Description

Rate Limiter

The packets dropped by the zone rate limiter and user filters rate limiters.

Flex Filter

The packets dropped by the flex filter.

User Filters

The packets dropped by the user filters.

Dynamic Filters

The packets dropped by the dynamic filters.

Spoofed

The packets that were identified by the Guard as Spoofed packets or packets originated by zombies and therefore not forwarded to the zone. Spoofed packets are Replied (bounced) packets to which no replies were received.

Malformed

The packets analyzed as malformed as a result of their malformed structure or due to the Guard's anti-spoofing mechanisms.


Detected Anomalies

The Detected Anomalies section of the attack report provides details of the traffic anomalies the Guard detected in the zone's traffic. A flow is classified as being an anomaly when it requires the production of a Dynamic filter. These anomalies can occur infrequently or can turn into systematic DDoS attacks. The Guard clusters anomalies with the same type and flow parameters (such as source IP address, destination port) under one anomaly type. Table 9-4 describes the different types of detected anomalies.

Table 9-4 Types of Detected Anomalies 

Type
Description

tcp_connections

A detected flow with unusual number of TCP concurrent connections, with or without data.

http

An unusual HTTP traffic flow.

tcp_incoming

A detected flow attacking a TCP service when the zone is a server.

tcp_outgoing

A detected flow consisting of SYN-ACK flood or other packet attacks on connections initiated by the zone when the zone is the client.

unauthenticated_tcp

A detected flow that the Guard anti-spoofing mechanisms have not succeeded in authenticating. For example, ACK flood, FIN flood or any other flood of unauthenticated packets.

dns (udp)

An attacking DNS-UDP protocol flow.

dns (tcp)

An attacking DNS-TCP protocol flow.

udp

An attacking UDP protocol flow.

other_protocols

A non TCP/UDP attacking protocol flow.

fragments

A detected flow with an unusual amount of fragmented traffic.

tcp_ratio

A detected flow with an unusual ratio between different types of TCP packets, for example, SYN packets versus FIN/RST packets.

ip_scan

A detected flow initiated from a source IP address that tried to access many zone destination IP addresses.

port_scan

A detected flow initiated from a source IP address that tried to access many zone ports.

user

An anomaly flow detected by user definitions.


Mitigated Attacks

The Mitigated Attacks section of the attack report details the steps the Guard took to protect the zone (Mitigated Attacks). The report provides details of the timing of the mitigation and the type of mitigated attack. The Guard defines the mitigation type according to the mechanisms utilized. These indicate the attack type and sub-type.

For example, if the Guard utilized a basic anti spoofing mechanism against the attacking flow of syn packets, the mitigated attack would appear as spoofed/tcp_syn_basic. Spoofed indicates the attack type and tcp_syn_basic indicates the sub-type.

There are five types of mitigated attacks:

Spoofed

Zombie

Client Attack

User Defined

Malformed Packets

Spoofed

Spoofed attacks includes all traffic anomalies identified as a DDoS attack coming from a spoofed source. Table 9-5 describes the different types of spoofed attacks.

Table 9-5 Types of Spoofed Attacks 

Attack Type
Description

spoofed/tcp_syn (basic)

A flood of syn packets that the Basic anti-spoofing mechanisms haven't succeeded in authenticating.

spoofed/tcp_syn (strong)

A flood of syn packets that the Strong anti-spoofing mechanisms haven't succeeded in authenticating.

spoofed/tcp_syn_ack (basic)

A flood of syn_ack packets that the Basic anti-spoofing mechanisms haven't succeeded in authenticating.

spoofed/tcp_syn_ack (strong)

A flood of syn_ack packets that the Strong anti-spoofing mechanisms haven't succeeded in authenticating.

spoofed/tcp_incoming (basic)

A flood of traffic that the Basic anti-spoofing mechanisms haven't succeeded in authenticating.

spoofed/
tcp_incoming (strong)

A flood of traffic that the Strong anti-spoofing mechanisms haven't succeeded in authenticating.

spoofed/tcp_outgoing (strong)

A flood of traffic coming in response to zone's initiated connections that the Strong anti-spoofing mechanisms haven't succeeded in authenticating.

spoofed/udp (basic)

A flood of UDP traffic that the Basic anti-spoofing mechanisms haven't succeeded in authenticating.

spoofed/udp (strong)

A flood of UDP traffic that the Strong anti-spoofing mechanisms haven't succeeded in authenticating.

spoofed/other_protocols

A flood of other than TCP and UDP traffic that the Guard anti-spoofing mechanisms haven't succeeded in authenticating.

spoofed/tcp_fragments

A flood of TCP fragmented packets that the Guard anti-spoofing mechanisms haven't succeeded in authenticating.

spoofed/udp_fragments

A flood of UDP fragmented, packets that the Guard anti-spoofing mechanisms haven't succeeded in authenticating.

spoofed /other_protocols_fragments

A flood of other than TCP and UDP fragmented packets that the Guard anti-spoofing mechanisms haven't succeeded in authenticating.

spoofed/dns_queries (strong)

A flood of DNS queries packets that the Strong anti-spoofing mechanisms haven't succeeded in authenticating.

spoofed/dns_replies (basic)

A flood of DNS packets coming in response to zone's initiated connections that the Basic anti-spoofing mechanisms haven't succeeded in authenticating.

spoofed/dns_replies (strong)

A flood of DNS packets coming in response to zone's initiated connections that the Strong anti-spoofing mechanisms haven't succeeded in authenticating.


Zombie

Zombie attacks include traffic anomalies identified as a DDoS attack originated by zombies. Table 9-6 describes the different types of zombie attacks.

Table 9-6 Types of Zombie Attacks 

Attack Type
Description

zombie/http

A flood of HTTP traffic from many sources that were identified as non-spoofed, but the Guard anti-zombie mechanisms have not succeeded in authenticating.


Client Attack

Client attacks include all non-spoofed traffic anomalies. Table 9-7 describes the different types of client attacks.

Table 9-7 Types of Client Attacks 

Attack Type
Description

client_attack/tcp_connections

A flow with unusual number of TCP concurrent connections with or without data.

client_attack/http

A flood of HTTP traffic flow.

client_attack/tcp_ incoming

A flood attacking a TCP service when the zone is a server.

client_attack/tcp_outgoing

An attacking flood coming from authenticated IP connections that the zone initiated.

client_attack
/unauthenticated_tcp

A flood of ACKs, or FINs, or any other packets without a TCP handshake or TCP connections that the Guard's anti-spoofing mechanisms have not succeeded in authenticating.

client_attack/dns (udp)

A flood of attacking DNS-UDP protocol.

client_attack/dns (tcp)

A flood of attacking DNS-TCP protocol.

client_attack/udp

A flood of attacking UDP protocol flow.

client_attack/other_protocols

A flood of non TCP/UDP attacking protocol flow.

client_attack/fragments

A flood of fragmented traffic.

client_attack/user

A user defined attack flood. The attack is defined by a Dynamic filter that was added by the user.


User Defined

User defined attacks include all anomalies handled by the user filters. These can either function by default or be configured by the user (see "Configuring Policy Templates and Policies" for further details). Table 9-8 describes the different types of user-defined attacks.

Table 9-8 Types of User Defined Attacks 

Attack Type
Description

user_defined/rate_limit

A overflow that was rate limited by the user filters or the global rate limiter of the zone.

user_defined/user_drop_filters

A flood that was handled by the user filters with drop action.


Malformed Packets

Malformed packets include all traffic anomalies identified as consisting of maliciously malformed packets. Table 9-9 describes the different types of malformed packets.

Table 9-9 Types of Malformed Packets 

Attack Type
Description

malformed_packets /packets_to_proxy_ip

A flood attacking a Guard's proxy IP address.

malformed_packets
/dns_anti_spoofing_algo

A flood of malformed packets due to the operation of the Guard's DNS anti-spoofing mechanisms.

malformed_packets
/dns (queries)

A flood of malformed DNS packets.

malformed_packets
/dns (short_queries)

A flood of short DNS queries.

malformed_packets
/dns (replies)

A flood of malformed DNS replies.

malformed_packets
/src ip = dst ip

A flood of packets with the zone IP address as their source and destination.

malformed_packets /zero_header_field

A flood of packets in which some of the fields in the header illegally equal zero.


Zombies

Zombie attacks include traffic anomalies identified as a DDoS attack originated by zombies. The Guard attack report displays a table listing zombies that are current attacking the zone. Use the show reports details and show zombies commands to view the list of currently attacking zombies.

See Table 9-14 for information on the fields in the show zombies command output.

Report Parameters

The different sections of the report describe different aspects of the traffic flow.

Table 9-10 describes the fields for Attack Statistics and Dropped/ Replied Packets.

Table 9-10 Field Descriptions for Attack Statistics 

Field
Description

Total Packets

The total number of attack packets.

Average pps

The average traffic rate in packets-per-second units.

Average bps

The average traffic rate in bits-per-second units.

Max. pps

The maximum traffic rate measured in packets-per-second units.

Max. bps

The maximum traffic rate measured in bits-per-second units.

Percentage

The number of forwarded, replied, and dropped packets as a percentage of the total received packets.


Table 9-11 describes the flow statistics for detected anomalies and mitigated attacks

Table 9-11 Field Descriptions for Flow Statistics 

Field
Description

ID

Indicates identification number (ID) of the detected anomaly.

Start time

Indicates the date and time the anomaly was detected.

Duration

Indicates the duration of the anomaly in hours, minutes, and seconds.

Type

Indicates the type of anomaly or mitigated attack.

Triggering rate

Indicates the anomaly traffic rate that violated a policy threshold.

% Threshold

Indicates the percentage by which the triggering rate is above the policy threshold.

Flow

Indicates the anomaly flow and mitigated attack flow. The characteristics include the protocol number, source IP, source port, destination IP, 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 anomaly's parameter.

A value of #, followed by a number, for any of the parameters, indicates the number of values measured for that parameter.

Viewing Attack Reports

Use the show command to display a list of attack reports for any specific zone or a more detailed report for a specific attack. The syntax for the command is as follows:

show reports [current | report-id] [details]

Table 9-12 the keywords and arguments for the show reports command.

Table 9-12 Arguments and Keywords for the show reports Command  

Parameters
Description

current

An attack that is in progress.

The number of bits and packets is not displayed for an ongoing attack. In reports of an attack in progress, the packets and bits fields have a value of zero (0).

report-id

The identification number of the report.

details

(Optional) To view details of the flows and attacking zombies.


For example, to view a list a all attacks on the zone, enter:

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

The report displays the following output with information about the duration of each attack, when it started and when it ended

Report ID
 Attack Start 
 Attack End
 Attack Duration
current
Feb 26 2004 09:58:54
 Attack in progress
N/A
4
Feb 25 2004 15:48:25
Feb 25 2004 18:23:46
02:35:21
3
Feb 25 2004 15:38:45
Feb 25 2004 15:48:18 
00:09:33
2 
Feb 25 2004 15:11:39
Feb 25 2004 15:29:40
00:18:01
1 
Feb 25 2004 13:09:10
Feb 25 2004 13:15:28
00:06:18

.

To view the report for the current attack on the zone, enter:

admin@GUARD-conf-zone-scannet# show reports current

The report displays the following output. For more information about the different sections see the "Report Layout" section.

Attack Start
:
Feb 26 2004 09:58:54
Attack End
:
Attack in progress
Attack Duration
:
00:08:34

Attack Statistics:

Total 
Packets
Average 
pps
Average 
bps
Max pps
Max bps
Percentage
Received
95878
186.53
110977.74
1455.44
914428.24
N/A
Forwarded
53827
104.72
64278.54
1430.85
899196.24
56.14
Replied
1870
3.64
2172.89
23.03
14433.88
1.95
Dropped
40181
78.17
44526.32
96.82
55010.13
41.91 


Dropped/Replied Packets:

Total 
Packets
Average 
pps
Average 
bps
Max pps
Max bps
Percentage
Rate Limiter
0
0
0
0
0
0
Flex Filter
0
0
0
0
0
0
User Filters
0
0
0
0
0
0
Dynamic Filters 
40128
78.07
44473.53
96.82
55010.13
99.84

Spoofed
12
0.02
11.95
0.15
75.29
0.03
Malformed
53
0.1
52.79
1.56
798.12
0.13

Detected Anomalies:
ID
 Start Time
 Duration
 Type
Triggering 
Rate
%Threshold 
1
Feb 26 09:58:54
00:08:34
HTTP
997.44
897.44

Flow: 6 * 
*
92.168.100.34  80
no fragments

Mitigated Attacks:
ID
 Start Time
 Duration
 Type
Triggering 
Rate
%Threshold 
1
Feb 26 09:59:40
 00:07:59
client_attack/
tcp_connections 
 38 
 280

Flow: 6 (#52) 
*
92.168.200.254 80
no fragments

To view a more detailed report on the flow for detected anomalies and mitigated attacks, and view a list of zombies attacks, use the details option.

Table 9-13 provides a list of the flow fields described in the detailed report.

Table 9-13 Field Descriptions of Flows in Detailed Report 

Field
Description

Detected Flow

This row represents the flow that caused the production of the dynamic filter.

Action Flow

This row represents the flow that was addressed by the dynamic filter. The action flow can have a wider range than the detected flow. For example, the detected flow could indicate a specific source port for a specific source IP whereas the action flow could indicate all source ports for the specified source IP.


Table 9-14 describes the fields in the detailed report referring to zombies attacks:

Table 9-14 Field Descriptions for Zombies Attacks Table

Field
Description

IP

The zombie IP address.

Start Time

The date and time the zombie connection was initially identified.

Duration

The duration of the zombie attack.

#Requests

The number of HTTP get requests sent by the zombie.



Note If there are no zombie s attacks, Report doesn't exist appears under the Zombies heading in the report.


Exporting Attack Reports

You can export attack reports to an ftp server for monitoring and diagnostics capabilities. You can export attack reports in text format or in Extensible Markup Language (XML) format.


Note The user name and password of the ftp server appear in the show running-config. We recommend that you use an anonymous ftp account.


Table 9-15


Use the copy command to copy reports to an ftp server manually. You can copy attack reports for attacks on all zones or you can copy a report for a specific zone.

The syntax for the command is as follows:

copy reports [xml] [details] ftp server full-file-name [login] [password]

Table 9-16 describes the arguments and keywords for the copy reports command.

Table 9-16 Keywords and Arguments for the copy reports Command 

Parameter
Description

xml

(Optional) Export the report in XML format. See the xsd file released with the version for a description of the XML schema. By default, reports are exported in text format.

Reports in XML format include all details. If you include the xml option, it is not necessary to include the details option.

details

(Optional) Export details of flow and attacking source IPs.

server

The IP address of ftp server.

full-file-name

The full file name for the report list. If a path is not specified, the default is the login user's home directory.

login

(Optional) The ftp server login name. The ftp server assumes an anonymous login when you do not insert a login name. The server will not prompt you for a password.

password

(Optional) The password for the remote ftp server.


For example, to copy a list of all attacks handled by the Guard, in text format, to an ftp server at IP address 10.0.0.191 using login name user1 and password password1, enter:

admin@GUARD# copy reports ftp 10.0.0.191 Guard-reports.txt user1 
password1

To copy the attack reports for a specific zone to an ftp server, enter the following at the Global command group level:

copy zone zone-name reports [current | report-id] [xml] [details] ftp server full-file-name [login] [password]

Table 9-17 describes the keywords and arguments for copy zone reports command.

Table 9-17 Keywords and Arguments for the copy zone reports Command  

Parameters
Description

zone-name

The name of an existing zone

current

(Optional) Export an ongoing attack report (if applicable).

By default, all zone reports are exported.

report-id

(Optional) The ID of and existing report. The Guard exports the report with the specified ID number. Use the show zone reports command to view the details of the zone attack reports.

By default, all zone reports are exported.

xml

(Optional) Export the report in XML format. See the xsd file released with the version for a description of the XML schema. By default, reports are exported in text format.

Reports in XML format include all details. If you include the xml option, it is not necessary to include the details option.

details

(Optional) Export details of flow and attacking source IPs.

server

The ftp server IP address.

full-file-name

The full file name for the report list. If a path is not specified, the default is the login user's home directory

login

(Optional) The ftp server login name.

When you do not insert a login name, the ftp server assumes an anonymous login and does not prompt for a password.

password

(Optional) The password for the remote ftp server.


For example, to copy all attack reports on the zone to an ftp server at IP address 10.0.0.191 using login name user1 and password password1, enter:

admin@GUARD# copy zone scannet reports ftp 10.0.0.191 
ScannetCurrentReport.txt user1 password1