Cisco IOS Security Configuration Guide, Release 12.2SR
CISCO-IP-URPF-MIB Support

Table Of Contents

CISCO-IP-URPF-MIB Support

Contents

Prerequisites for CISCO-IP-URPF-MIB Support

Restrictions for CISCO-IP-URPF-MIB Support

Information About CISCO-IP-URPF-MIB Support

Implementing URPF Notification

Software Basis for URPF Notification

Global Scalars

Global Tables

Per-interface Statistics

Per-interface Configuration

Drop-Rate Computation

How to Configure URPF Drop-Rate Notification

Configuring URPF Drop-Rate Notification via Syslog

Prerequisites

Restrictions

Configuring URPF Drop-Rate Notification via SNMP

Prerequisites

Restrictions

Verifying the URPF Configuration

Examples

Configuration Examples for CISCO-IP-URPF-MIB Support

Configuring URPF Drop-Rate Notification via Syslog: Example

Configuring URPF Drop-Rate Notification via SNMP: Example

Additional References

Related Documents

Standards

MIBs

RFCs

Technical Assistance

Command Reference

Feature Information for CISCO-IP-URPF-MIB Support


CISCO-IP-URPF-MIB Support


First Published: December 4, 2006
Last Updated: July 11, 2008

Customers use the IP Unicast Reverse Path Forwarding (URPF) feature to avert denial of service (DoS) attacks by verifying the validity of the source IP of an incoming packet. The CISCO-IP-URPF-MIB has been defined to provide Simple Network Management Protocol (SNMP) notification when a specified URPF drop-rate threshold on a managed device is exceeded. The URPF drop-rate threshold can be configured globally for a device, or per interface.

Finding Feature Information in This Module

Your Cisco IOS software release may not support all of the features documented in this module. For the latest feature information and caveats, see the release notes for your Cisco IOS software release. To reach links to specific feature documentation in this module and to see a list of the releases in which each feature is supported, use the "Feature Information for CISCO-IP-URPF-MIB Support" section.

Finding Support Information for Platforms and Cisco IOS and Catalyst OS Software Images

Use Cisco Feature Navigator to find information about platform support and Cisco IOS and Catalyst OS software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.

Contents

Prerequisites for CISCO-IP-URPF-MIB Support

Restrictions for CISCO-IP-URPF-MIB Support

Information About CISCO-IP-URPF-MIB Support

How to Configure URPF Drop-Rate Notification

Configuration Examples for CISCO-IP-URPF-MIB Support

Additional References

Command Reference

Feature Information for CISCO-IP-URPF-MIB Support

Prerequisites for CISCO-IP-URPF-MIB Support

Cisco IOS support for the CISCO-IP-URPF-MIB requires the following to be configured on the device:

URPF

Cisco Express Forwarding (CEF)

IP Routing

SNMP

Restrictions for CISCO-IP-URPF-MIB Support

Because Cisco IOS does not support Virtual Private Network (VPN) routing and forwarding- (VRF)- specific URPF counters, the following MIB objects related to VRF are not supported:

cipUrpfIfVrfName

cipUrpfVrfName

cipUrpfVrfIfDrops

cipUrpfVrfIfDiscontinuityTime

This implementation of the CISCO-IP-URPF MIB supports IPv4 only.

Information About CISCO-IP-URPF-MIB Support

To configure a notification threshold for URPF dropped packets, you should understand the following concepts:

Implementing URPF Notification

Software Basis for URPF Notification

Implementing URPF Notification

URPF is a security feature that verifies the validity of the source IP of an incoming packet. When a packet arrives at an interface and its source IP is unknown in the routing table or is a known bad source address, URPF drops the packet. Source IP verification is done to prevent denial of service (DoS) attacks by detecting problems with the incoming packets on an interface. However, URPF is challenging to deploy without some automated monitoring capability.

The CISCO-IP-URPF-MIB allows users to specify a URPF drop-rate threshold on interfaces of a managed device, which when exceeded causes an SNMP notification to be sent. This MIB includes objects for specifying global and per-interface drop counts and drop rates, as well as a means of generating SNMP traps when the drop rate exceeds a configurable per-interface threshold.

Although some parameters can be configured globally, this feature must be configured on individual interfaces.

Software Basis for URPF Notification

The following elements make URPF drop-rate notification work:

Global Scalars

Global Tables

Per-interface Statistics

Per-interface Configuration

Drop-Rate Computation

Global Scalars

The following global scalars affect the behavior of the MIB agent in computing all drop rates and controlling notification generation:

cipUrpfDropRateWindow

This object specifies the window of time in the recent past over which the computation takes place. If there were no window (that is, the window is the epoch since booting up), an identical drop count burst at a later time would produce a smaller drop rate than one occurring earlier.

cipUrpfComputeInterval

This object specifies how often the drop-rate computation occurs.

cipUrpfDropNotifyHoldDownTime

This object specifies the minimum time between notifications for a particular packet flow on an interface.

Global Tables

The CISCO-IP-URPF-MIB includes the following global tables:

cipUrpfTable

This table contains global drop count and drop-rate objects per packet flow (for both IPv4 and IPv6). These global rates are useful for determining quickly whether there is URPF activity on the managed device at a specific time.

cipUrpfVrfTable

This table allows users to index drop counters by VRF, if a VRF routing table is used to determine URPF checking. The table provides a means to index all the URPF-enabled interfaces by VRF.

Per-interface Statistics

The following MIB objects track per-interface statistics:

cipUrpfIfMonTable

This table contains the statistics for a particular packet flow on an interface.

cipUrpfIfDrops

This object accumulates URPF drops on an interface. Snapshots of this value are used in the drop-rate computation. Computed drop rate is specified in the cipUrpfIfDropRate object. IfURPF is configured on a subinterface, drop rates are computed.

Per-interface Configuration

The following MIB objects enable per-interface configuration.

cipUrpfIfDropRateNotifyEnable

This object specifies whether the system produces the cipUrpfIfDropRateNotify notification because URPF has dropped of version cipUrpfIfIpVersion IP packets on the specified interface.

cipUrpfIfNotifyDropRateThreshold

This object specifies the drop-rate threshold value above which a notification is generated.

Drop-Rate Computation

Whenever URPF is configured on an interface, the drop-rate calculation is performed periodically (at intervals specified by the cipUrpfComputeInterval object). Drop rates are computed over a constantly sliding window, covering the period ending with the performance of the calculation and starting the configured number of seconds before the calculation.

How to Configure URPF Drop-Rate Notification

This section contains the following tasks:

Configuring URPF Drop-Rate Notification via Syslog

Configuring URPF Drop-Rate Notification via SNMP

Verifying the URPF Configuration

Configuring URPF Drop-Rate Notification via Syslog

This task describes how to configure the URPF drop-rate threshold and computation parameters for notification via syslog.

Prerequisites

You must have URPF configured on the router before configuring this feature. For information about configuring URPF, see Configuring Unicast Reverse Path Forwarding.

Restrictions

This feature can be configured only with IPv4.

SUMMARY STEPS

1. enable

2. configure terminal

3. ip verify drop-rate compute window seconds

4. ip verify drop-rate compute interval seconds

5. ip verify drop-rate notify hold-down seconds

6. configure interface type number

7. ip verify unicast notification threshold rate-val

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Enables privileged EXEC mode.

Step 2 

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Enter your password if prompted.

Step 3 

ip verify drop-rate compute window seconds

Example:

Router <config># ip verify drop-rate compute window 60

Configures the period of time, in seconds, over which the URPF drop count used in the drop-rate computation is collected.

The range of the seconds argument is from 30 to 300. The default is 300.

Note The value for the compute window must be greater than or equal to that entered for the ip verify drop-rate compute interval command.

Step 4 

ip verify drop-rate compute interval seconds

Example:

Router <config># ip verify drop-rate compute interval 60

Configures the interval of time, in seconds, between URPF drop-rate computations.

The range of the seconds argument is from 30 to 300. The default is 30.

Note The value for the compute interval must be less than or equal to that entered for the ip verify drop-rate compute window command.

Step 5 

ip verify drop-rate notify hold-down seconds

Example:

Router <config># ip verify drop-rate notify hold-down 60


Configures the minimum time, in seconds, between URPF drop-rate notifications.

The range of the seconds argument is from 30 to 300. The default is 300.

Enters privileged EXEC mode.

Step 6 

configure interface type number

Example:

Router# configure interface ethernet 3/0

Enters interface configuration mode.

Step 7 

ip verify unicast notification threshold rate-val

Example:

Router (config-if)# ip verify unicast notification threshold 750

Configures the threshold value, in packets per second, used to determine whether to send a URPF drop-rate notification.

The range is from 0 to the maximum number of packets the interface can process in 1 second. The default is 1000.

Note If you configure the threshold to be 0, every packet drop will trigger a notification.

Configuring URPF Drop-Rate Notification via SNMP

This task describes how to configure the URPF drop-rate threshold and computation parameters for notification via SNMP.

Prerequisites

You must have URPF configured on the router before configuring this feature. For information about configuring URPF, see Configuring Unicast Reverse Path Forwarding.

You must enable SNMP on the router to use this feature. For information about enabling SNMP, see Configuring SNMP Support.

Restrictions

This feature can be configured only with IPv4.

SUMMARY STEPS

1. enable

2. configure terminal

3. ip verify drop-rate compute window seconds

4. ip verify drop-rate compute interval seconds

5. ip verify drop-rate notify hold-down seconds

6. configure interface type number

7. ip verify unicast notification threshold rate-val

8. snmp trap ip verify drop-rate

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Enables privileged EXEC mode.

Step 2 

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 3 

ip verify drop-rate compute window seconds

Example:

Router <config># ip verify drop-rate compute window 60

Configures the period of time, in seconds, over which the URPF drop count used in the drop-rate computation is collected.

The range is from 30 to 300. The default is 300.

Note The value for the compute window must be greater than or equal to that entered for the ip verify drop-rate compute interval command.

Step 4 

ip verify drop-rate compute interval seconds

Example:

Router <config># ip verify drop-rate compute interval 60

Configures the interval of time, in seconds, between URPF drop-rate computations.

The range is from 30 to 300. The default is 30.

Note The value for the compute interval must be less than or equal to that entered for the ip verify drop-rate compute window command

Step 5 

ip verify drop-rate notify hold-down seconds

Example:

Router <config># ip verify drop-rate notify hold-down 60


Configures the minimum time, in seconds, between URPF drop-rate notifications.

The range is from 30 to 300. The default is 300.

Enters privileged EXEC mode.

Step 6 

configure interface type number

Example:

Router# configure interface ethernet 3/0

Enters interface configuration mode.

Step 7 

ip verify unicast notification threshold rate-val

Example:

Router (config-if)# ip verify unicast notification threshold 750

Configures the threshold value, in packets per second, used to determine whether to send a URPF drop-rate notification.

The range is from 0 to the maximum number of packets the interface can process in 1 second. The default is 1000.

Note If you configure the threshold to be 0, every packet drop will trigger a notification.

Step 8 

snmp trap ip verify drop-rate

Example:

Router (config-if)# snmp trap ip verify drop-rate

Configures the router to send an SNMP notification when the URPF drop rate exceeds the configured threshold.

Verifying the URPF Configuration

You can use the following two commands to verify the URPF configuration and troubleshoot the operation of URPF drop-rate notification.

SUMMARY STEPS

1. enable

2. show ip interface type number

3. debug ip verify mib

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables privileged EXEC mode.

Enter your password if prompted.

Step 2 

show ip interface type number

Example:

Router# show ip interface ethernet 3/0

Displays the verification drop rate and the number of verification drops when URPF is configured for the specified interface.

Step 3 

debug ip verify mib

Example:

Router# debug ip verify mib

Displays output useful for troubleshooting URPF notification.

Examples

The last five lines in following example shows the output of the show ip interface command when URPF is configured:

Router# show ip interface ethernet 2/3

Ethernet2/3 is up, line protocol is up
  Internet address is 10.10.5.4/16
  Broadcast address is 255.255.255.255
  Address determined by non-volatile memory
  MTU is 1500 bytes
  Helper address is not set
  Directed broadcast forwarding is disabled
  Outgoing access list is not set
  Inbound  access list is not set
  Proxy ARP is enabled
  Local Proxy ARP is disabled
  Security level is default
  Split horizon is enabled
  ICMP redirects are always sent
  ICMP unreachables are always sent
  ICMP mask replies are never sent
  IP fast switching is disabled
  IP Flow switching is disabled
  IP CEF switching is disabled
  IP Null turbo vector
  IP Null turbo vector
  IP multicast fast switching is disabled
  IP multicast distributed fast switching is disabled
  IP route-cache flags are No CEF
  Router Discovery is disabled
  IP output packet accounting is disabled
  IP access violation accounting is disabled
  TCP/IP header compression is disabled
  RTP/IP header compression is disabled
  Probe proxy name replies are disabled
  Policy routing is disabled
  Network address translation is disabled
  WCCP Redirect outbound is disabled
  WCCP Redirect inbound is disabled
  WCCP Redirect exclude is disabled
  BGP Policy Mapping is disabled
  Input features: uRPF
  IP verify source reachable-via RX, allow default
   0 verification drops
   0 suppressed verification drops
   0 verification drop-rate
router#

The following example shows the output of the debug ip verify mib command:

Router# debug ip verify mib

01:29:45: cipUrpfScalar_get, searchType 161
01:29:45: ipurpfmib_get_scalars
01:29:45: cipUrpfScalar_get, searchType 161
01:29:45: cipUrpfScalar_get, searchType 161
01:29:45: ipurpfmib_get_scalars
01:29:45: cipUrpfScalar_get, searchType 161
01:29:45: cipUrpfScalar_get, searchType 161
01:29:45: ipurpfmib_get_scalars
01:29:45: cipUrpfScalar_get, searchType 
161ipurpfmib_get_urpf_entryipurpfmib_get_urpf_entryipurpfmib_get_urpf_entryipurpfmib_get_ 
urpf_entry
01:29:45: cipUrpfIfMonEntry_get, searchType 161
01:29:45: ipurpfmib_get_urpf_ifmon_entry entry: ST 161, if 1, ip 1
01:29:45: cipUrpfIfMonEntry_get, searchType 161
01:29:45: ipurpfmib_get_urpf_ifmon_entry entry: ST 161, if 1, ip 1
01:29:45: cipUrpfIfMonEntry_get, searchType 161
01:29:45: ipurpfmib_get_urpf_ifmon_entry entry: ST 161, if 1, ip 1
01:29:45: cipUrpfIfMonEntry_get, searchType 161
01:29:45: ipurpfmib_get_urpf_ifmon_entry entry: ST 161, if 1, ip 1
01:29:45: cipUrpfIfMonEntry_get, searchType 161
01:29:45: ipurpfmib_get_urpf_ifmon_entry entry: ST 161, if 1, ip 1
01:29:45: cipUrpfIfMonEntry_get, searchType 161
01:29:45: ipurpfmib_get_urpf_ifmon_entry entry: ST 161, if 1, ip 1
01:29:45: cipUrpfIfMonEntry_get, searchType 161
01:29:45: ipurpfmib_get_urpf_ifmon_entry entry: ST 161, if 1, ip 1
01:29:45: cipUrpfIfMonEntry_get, searchType 161
01:29:45: ipurpfmib_get_urpf_ifmon_entry entry: ST 161, if 1, ip 1
01:29:45: cipUrpfIfMonEntry_get, searchType 161
01:29:45: ipurpfmib_get_urpf_ifmon_entry entry: ST 161, if 1, ip 1
01:29:45: cipUrpfIfMonEntry_get, searchType 161
01:29:45: ipurpfmib_get_urpf_ifmon_entry entry: ST 161, if 1, ip 1

Configuration Examples for CISCO-IP-URPF-MIB Support

This section includes the following examples:

Configuring URPF Drop-Rate Notification via Syslog: Example

Configuring URPF Drop-Rate Notification via SNMP: Example

Configuring URPF Drop-Rate Notification via Syslog: Example

The following example shows how to configure URPF drop-rate notification via syslog:

configure terminal
ip verify drop-rate compute window 60
ip verify drop-rate compute interval 60
ip verify drop-rate hold-down 60
configure interface ethernet 3/0
interface ethernet 3/0
ip verify unicast notification threshold 750

Configuring URPF Drop-Rate Notification via SNMP: Example

The following example shows how to configure URPF drop-rate notification via SNMP:

configure terminal
ip verify drop-rate compute window 60
ip verify drop-rate compute interval 60
ip verify drop-rate hold-down 60
configure interface ethernet 3/0
interface ethernet 3/0
ip verify unicast notification threshold 750
snmp trap ip verify drop-rate

Additional References

The following sections provide references related to the CISCO-IP-URPF-MIB Support feature.

Related Documents

Related Topic
Document Title

Configuring Unicast Reverse Path Forwarding

Configuring Unicast Reverse Path Forwarding

Configuring SNMP

Configuring SNMP Support


Standards

Standard
Title

No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.


MIBs

MIB
MIBs Link

CISCO-IP-URPF-MIB

To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:

http://www.cisco.com/go/mibs


RFCs

RFC
Title

No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.


Technical Assistance

Description
Link

The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies.

To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds.

Access to most tools on the Cisco Support website requires a Cisco.com user ID and password.

http://www.cisco.com/techsupport


Command Reference

The following commands are introduced or modified in the feature or features documented in this module. For information about these commands, see the Cisco IOS Security Command Reference at http://www.cisco.com/en/US/docs/ios/security/command/reference/sec_book.html. For information about all Cisco IOS commands, use the Command Lookup Tool at http://tools.cisco.com/Support/CLILookup or a Cisco IOS master commands list.

debug ip verify mib

ip verify drop-rate compute interval

ip verify drop-rate compute window

ip verify drop-rate notify hold-down

ip verify unicast notification threshold

show ip interface

snmp trap ip verify drop-rate

Feature Information for CISCO-IP-URPF-MIB Support

Table 1 lists the release history for this feature.

Not all commands may be available in your Cisco IOS software release. For release information about a specific command, see the command reference documentation.

Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which Cisco IOS and Catalyst OS software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.


Note Table 1 lists only the Cisco IOS software release that introduced support for a given feature in a given Cisco IOS software release train. Unless noted otherwise, subsequent releases of that Cisco IOS software release train also support that feature.


Table 1 Feature Information for CISCO-IP-URPF-MIB Support

Feature Name
Releases
Feature Information

CISCO-IP-URPF-MIB Support

12.2(31)SB212.2(33)SRC
12.4(20)T

The CISCO-IP-URPF-MIB has been defined to provide Simple Network Management Protocol (SNMP) notification when a specified URPF drop-rate threshold on a managed device is exceeded.

The following commands were introduced or modified:

debug ip verify mib, ip verify drop-rate compute interval, ip verify drop-rate compute window, ip verify drop-rate notify hold-down, ip verify unicast notification threshold, show ip interface, snmp trap ip verify drop-rate


All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0805R)