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
Helper address is not set
Directed broadcast forwarding is disabled
Outgoing access list is not set
Inbound access list is not set
Local Proxy ARP is disabled
Security level is default
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 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
IP verify source reachable-via RX, allow default
0 suppressed verification drops
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:
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
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:
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
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
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
|
CCDE, CCENT, Cisco Eos, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, the Cisco logo, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn is a service mark; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
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)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2008 Cisco Systems, Inc. All rights reserved.