Table Of Contents
IS-IS HMAC-MD5 Authentication and Enhanced Clear Text Authentication
Prerequisites for IS-IS HMAC-MD5 Authentication and Enhanced Clear Text Authentication
Information About IS-IS HMAC-MD5 Authentication and Enhanced Clear Text Authentication
Benefits of IS-IS HMAC-MD5 Authentication
Benefits of IS-IS Clear Text Authentication
How to Configure IS-IS HMAC-MD5 Authentication or Enhanced Clear Text Authentication
Configuring HMAC-MD5 Authentication or Clear Text Authentication for the First Time
Configuring HMAC-MD5 or Clear Text Authentication for the IS-IS Instance
Configuring HMAC-MD5 or Clear Text Authentication for an IS-IS Interface
Migrating from Old Clear Text Authentication to HMAC-MD5 Authentication
Migrating from Old Clear Text Authentication to HMAC-MD5 Authentication for the IS-IS Instance
Migrating from Old Clear Text Authentication to HMAC-MD5 Authentication for an IS-IS Interface
Migrating from Old Clear Text Authentication to the New Clear Text Authentication
Configuration Examples for IS-IS HMAC-MD5 Authentication and Enhanced Clear Text Authentication
Configuring IS-IS HMAC-MD5 Authentication Example
Configuring IS-IS Clear Text Authentication Example
IS-IS HMAC-MD5 Authentication and Enhanced Clear Text Authentication
The IS-IS HMAC-MD5 authentication feature adds an HMAC-MD5 digest to each Intermediate System-to-Intermediate System (IS-IS) protocol data unit (PDU). The digest allows authentication at the IS-IS routing protocol level, which prevents unauthorized routing message from being injected into the network routing domain. IS-IS clear text (plain text) authentication is enhanced so that passwords are encrypted when the software configuration is displayed and passwords are easier to manage and change.
Feature Specifications for the IS-IS HMAC-MD5 Authentication and Enhanced Clear Text Authentication Feature
Determining Platform Support Through Cisco Feature Navigator
Cisco IOS software is packaged in feature sets that are supported on specific platforms. To get updated information regarding platform support for this feature, access Cisco Feature Navigator. Cisco Feature Navigator dynamically updates the list of supported platforms as new platform support is added for the feature.
Cisco Feature Navigator is a web-based tool that enables you to quickly determine which Cisco IOS software images support a specific set of features and which features are supported in a specific Cisco IOS image. You can search by feature or release. Under the release section, you can compare releases side by side to display both the features unique to each software release and the features in common.
To access Cisco Feature Navigator, you must have an account on Cisco.com. If you have forgotten or lost your account information, send a blank e-mail to cco-locksmith@cisco.com. An automatic check will verify that your e-mail address is registered with Cisco.com. If the check is successful, account details with a new random password will be e-mailed to you. Qualified users can establish an account on Cisco.com by following the directions found at this URL:
Cisco Feature Navigator is updated regularly when major Cisco IOS software releases and technology releases occur. For the most current information, go to the Cisco Feature Navigator home page at the following URL:
Availability of Cisco IOS Software Images
Platform support for particular Cisco IOS software releases is dependent on the availability of the software images for those platforms. Software images for some platforms may be deferred, delayed, or changed without prior notice. For updated information about platform support and availability of software images for each Cisco IOS software release, refer to the online release notes or Cisco Feature Navigator.
Contents
•
Prerequisites for IS-IS HMAC-MD5 Authentication and Enhanced Clear Text Authentication
•
Information About IS-IS HMAC-MD5 Authentication and Enhanced Clear Text Authentication
•
How to Configure IS-IS HMAC-MD5 Authentication or Enhanced Clear Text Authentication
•
Configuration Examples for IS-IS HMAC-MD5 Authentication and Enhanced Clear Text Authentication
Prerequisites for IS-IS HMAC-MD5 Authentication and Enhanced Clear Text Authentication
In order to use HMAC-MD5 or clear text authentication with encrypted keys, the Integrated IS-IS routing protocol must be configured.
Information About IS-IS HMAC-MD5 Authentication and Enhanced Clear Text Authentication
Before you configure IS-IS HMAC-MD5 authentication or clear text authentication, you should understand the following concepts:
•
IS-IS HMAC-MD5 Authentication
•
Benefits of IS-IS HMAC-MD5 Authentication
•
Benefits of IS-IS Clear Text Authentication
IS-IS HMAC-MD5 Authentication
The IS-IS HMAC-MD5 authentication feature adds an HMAC-MD5 digest to each IS-IS PDU. HMAC is a mechanism for message authentication codes (MACs) using cyptographic hash functions. The digest allows authentication at the IS-IS routing protocol level, which prevents unauthorized routing messages from being injected into the network routing domain.
IS-IS has five packet types: link state packet (LSP), LAN Hello, Serial Hello, CSNP, and PSNP. The IS-IS HMAC-MD5 authentication or the clear text password authentication can be applied to all five types of PDU. The authentication can be enabled on different IS-IS levels independently. The interface-related PDUs (LAN Hello, Serial Hello, CSNP, and PSNP) can be enabled with authentication on different interfaces, with different levels and different passwords.
The HMAC-MD5 mode cannot be mixed with the clear text mode on the same authentication scope (LSP or interface). However, administrators can use one mode for LSP and another mode for some interfaces, for example. If mixed modes are intended, different keys should be used for different modes in order not to compromise the encrypted password in the PDUs.
Benefits of IS-IS HMAC-MD5 Authentication
•
IS-IS now supports MD5 authentication, which is more secure than clear text authentication.
•
MD5 authentication or clear text authentication can be enabled on Level 1 or Level 2 independently.
•
Passwords can be rolled over to new passwords without disrupting routing messages.
•
For the purpose of network transition, you can configure the networking device to accept PDUs without authentication or with wrong authentication information, yet send PDUs with authentication. Such transition might be because you are migrating from no authentication to some type of authentication, you are changing authentication type, or you are changing keys.
Benefits of IS-IS Clear Text Authentication
IS-IS clear text (plain text) authentication was formerly configured only by using the area-password or domain-password command. Clear text authentication can now be configured using new commands that cause passwords to be encrypted when the software configuration is displayed and make passwords easier to manage and change.
How to Configure IS-IS HMAC-MD5 Authentication or Enhanced Clear Text Authentication
The following sections describe configuration tasks for IS-IS authentication. The task you perform depends on whether you are introducing authentication or migrating from an existing authentication scheme.
•
Configuring HMAC-MD5 Authentication or Clear Text Authentication for the First Time (optional)
•
Migrating from Old Clear Text Authentication to HMAC-MD5 Authentication (optional)
•
Migrating from Old Clear Text Authentication to the New Clear Text Authentication (optional)
Configuring HMAC-MD5 Authentication or Clear Text Authentication for the First Time
Before you can configure authentication, you must make the following decisions:
•
Whether to configure authentication for the IS-IS instance or for individual IS-IS interfaces (both tasks are included in this section)
•
Whether to configure HMAC-MD5 authentication or clear text authentication (this decision is made with the authentication mode command if you are configuring an IS-IS instance, or with the isis authentication mode command if you are configuring an IS-IS interface)
Configuring HMAC-MD5 or Clear Text Authentication for the IS-IS Instance
To achieve a smooth transition to authenticating IS-IS packets, perform the following steps in the order shown, which requires moving from router to router doing certain steps before all the steps are performed on any one router.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
key chain name-of-chain
4.
key key-id
5.
key-string text
6.
exit
7.
router isis area-tag
8.
authentication send-only [level-1 | level-2]
9.
Repeat Steps 1 through 8 on each router that will communicate.
10.
authentication mode {md5 | text }[level-1 | level-2]
11.
authentication key-chain name-of-chain [level-1 | level-2]
12.
Repeat Steps 10 and 11 on each router that will communicate.
13.
no authentication send-only
14.
Repeat Step 13 on each router that will communicate.
DETAILED STEPS
Configuring HMAC-MD5 or Clear Text Authentication for an IS-IS Interface
To achieve a smooth transition to authenticating IS-IS packets, perform the following steps in the order shown, which requires moving from router to router doing certain steps before all the steps are performed on any one router.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
key chain name-of-chain
4.
key key-id
5.
key-string text
6.
exit
7.
interface type number
8.
isis authentication send-only [level-1 | level-2]
9.
Repeat Steps 1 through 8 on each router that will communicate.
10.
isis authentication mode {md5 | text }[level-1 | level-2]
11.
isis authentication key-chain name-of-chain [level-1 | level-2]
12.
Repeat Steps 10 and 11 on each router that will communicate.
13.
no isis authentication send-only
14.
Repeat Step 13 on each router that will communicate.
DETAILED STEPS
Migrating from Old Clear Text Authentication to HMAC-MD5 Authentication
When you are migrating from the old clear text authentication to HMAC-MD5 authentication, after you load the first router with an image that includes this feature, the router will continue to use the old clear text authentication with other routers on the network.
Note
If you want HMAC-MD5 authentication, all routers in the authentication scope must have the new image before HMAC-MD5 can be configured. The scope can be either a Level 1 or Level 2 domain.
Before you can configure authentication, you must decide whether to configure authentication for the IS-IS instance or for individual IS-IS interfaces (both tasks are in this section).
Migrating from Old Clear Text Authentication to HMAC-MD5 Authentication for the IS-IS Instance
To achieve a smooth transition to authenticating IS-IS packets, perform the following steps in the order shown, which requires moving from router to router doing certain steps before all the steps are performed on any one router.
When you configure the MD5 authentication, the area-password and domain-password command settings will be overridden automatically with the new authentication commands.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
key chain name-of-chain
4.
key key-id
5.
key-string text
6.
exit
7.
router isis area-tag
8.
authentication send-only [level-1 | level-2]
9.
Repeat Steps 1 through 8 on each router that will communicate.
10.
authentication mode md5 [level-1 | level-2]
11.
authentication key-chain name-of-chain [level-1 | level-2]
12.
Repeat Steps 10 and 11 on each router that will communicate.
13.
no authentication send-only
14.
Repeat Step13 on each router that will communicate.
Migrating from Old Clear Text Authentication to HMAC-MD5 Authentication for an IS-IS Interface
Prerequisites
Before you can migrate from the old method of clear text authentication to HMAC-MD5 authentication at the interface level, you must upgrade all the routers associated with the media of the interfaces to the new image containing the HMAC-MD5 feature.
To achieve a smooth transition to authenticating IS-IS packets, it is important to perform the steps in the order shown, which requires moving from router to router doing certain steps before all the steps are performed on any one router.
When you configure the MD5 authentication, the isis password command setting will be overridden automatically with the new authentication commands.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
key chain name-of-chain
4.
key key-id
5.
key-string text
6.
exit
7.
interface type number
8.
isis authentication send-only [level-1 | level-2]
9.
Repeat Steps 1 through 8 on each router that will communicate.
10.
isis authentication mode md5 [level-1 | level-2]
11.
isis authentication key-chain name-of-chain [level-1 | level-2]
12.
Repeat Steps 10 and 11 on each router that will communicate.
13.
no isis authentication send-only
14.
Repeat Step 13 on each router that will communicate.
DETAILED STEPS
Migrating from Old Clear Text Authentication to the New Clear Text Authentication
The benefits of migrating from the old method of clear text authentication to the new method of clear text authentication are as follows:
•
Passwords are easier to change and maintain.
•
Passwords can be encrypted when the system configuration is being displayed (if you use key management).
Before you can configure authentication, you must decide whether to configure authentication for the IS-IS instance or for individual IS-IS interfaces (both tasks are in this section).
Migrating from Old Clear Text Authentication to the New Clear Text Authentication for the IS-IS Instance
To achieve a smooth transition to authenticating LSPs, perform the following steps in the order shown, which requires moving from router to router doing certain steps before all the steps are performed on any one router.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
key chain name-of-chain
4.
key key-id
5.
key-string text
6.
exit
7.
router isis area-tag
8.
authentication send-only [level-1 | level-2]
9.
Repeat Steps 1 through 8 on each router that will communicate.
10.
authentication mode text [level-1 | level-2]
11.
authentication key-chain name-of-chain [level-1 | level-2]
12.
Repeat Steps 10 and 11 on each router that will communicate.
13.
no authentication send-only
14.
Repeat Step 13 on each router that will communicate.
Migrating from Old Clear Text Authentication to the New Clear Text Authentication for an IS-IS Interface
This section describes how to configure authentication on interface-related PDUs.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
key chain name-of-chain
4.
key key-id
5.
key-string text
6.
exit
7.
interface type number
8.
isis authentication send-only [level-1 | level-2]
9.
Repeat Steps 1 through 8 on each router that will communicate.
10.
isis authentication mode text [level-1 | level-2]
11.
isis authentication key-chain name-of-chain [level-1 | level-2]
12.
Repeat Steps 10 and 11 on each router that will communicate.
13.
Load the new image on all the other routers that share the media that the interface uses.
14.
no isis authentication send-only
15.
Repeat Step 14 on each interface.
DETAILED STEPS
Configuration Examples for IS-IS HMAC-MD5 Authentication and Enhanced Clear Text Authentication
This section provides the following configuration examples:
•
Configuring IS-IS HMAC-MD5 Authentication Example
•
Configuring IS-IS Clear Text Authentication Example
Configuring IS-IS HMAC-MD5 Authentication Example
The following example configures a key chain and key for IS-IS HMAC-MD5 authentication for Ethernet interface 3 (on Hello packets) and for the IS-IS instance (on LSP, CSNP, and PSNP packets):
!key chain ciscokey 100key-string tasman-drive!interface Ethernet3ip address 10.1.1.1 255.255.255.252ip router isis real_secure_networkisis authentication mode md5 level-1isis authentication key-chain cisco level-1!router isis real_secure_networknet 49.0000.0101.0101.0101.00is-type level-1authentication mode md5 level-1authentication key-chain cisco level-1!Configuring IS-IS Clear Text Authentication Example
The following example configures a key chain and key for IS-IS clear text authentication for Ethernet interface 3 (on Hello packets) and for the IS-IS instance (on LSP, CSNP, and PSNP packets):
!key chain ciscokey 100key-string tasman-drive!interface Ethernet3ip address 10.1.1.1 255.255.255.252ip router isis real_secure_networkisis authentication mode text level-1isis authentication key-chain cisco level-1!router isis real_secure_networknet 49.0000.0101.0101.0101.00is-type level-1authentication mode text level-1authentication key-chain cisco level-1!Additional References
For additional information related to IS-IS HMAC-MD5 authentication and clear text authentication, refer to the following references:
•
MIBs
•
RFCs
Related Documents
MIBs
MIBs1 MIBs LinkNo new or modified MIBs are supported by this feature, and support for existing MIBs has not been modified by this feature.
To obtain lists of supported MIBs by platform and Cisco IOS release, and to download MIB modules, go to the Cisco MIB website on Cisco.com at the following URL:
http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml
1 Not all supported MIBs are listed.
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:
http://tools.cisco.com/ITDIT/MIBS/servlet/index
If Cisco MIB Locator does not support the MIB information that you need, you can also obtain a list of supported MIBs and download MIBs from the Cisco MIBs page at the following URL:
http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml
To access Cisco MIB Locator, you must have an account on Cisco.com. If you have forgotten or lost your account information, send a blank e-mail to cco-locksmith@cisco.com. An automatic check will verify that your e-mail address is registered with Cisco.com. If the check is successful, account details with a new random password will be e-mailed to you. Qualified users can establish an account on Cisco.com by following the directions found at this URL:
RFCs
RFCs1 Titledraft-ietf-isis-hmac-03.txt
IS-IS Cryptographic Authentication
RFC 1321
The MD5 Message-Digest Algorithm
RFC 2104
HMAC: Keyed-Hashing for Message Authentication
1 Not all supported RFCs are listed.
Technical Assistance
Command Reference
This section documents the following new commands related to IS-IS HMAC-MD5 authentication. All other commands used with this feature are documented in the Cisco IOS Release 12.2 command reference publications.
•
isis authentication key-chain
•
isis authentication send-only
This section also documents the following revised commands related to clear text authentication. All other commands used with this feature are documented in the Cisco IOS Release 12.2 command reference publications.
•

