-
Cisco IOS XR System Security Command Reference, Release 3.2
-
Preface
-
Authentication, Authorization, and Accounting Commands on Cisco IOS XR Software
-
Internet Key Exchange Security Protocol Commands on Cisco IOS XR Software
-
IPSec Network Security Commands on Cisco IOS XR Software
-
Public Key Infrastructure Commands on Cisco IOS XR Software
-
Secure Shell Commands on Cisco IOS XR Software
-
Secure Socket Layer Protocol Commands on Cisco IOS XR Software
-
Software Authentication Manager Commands on Cisco IOS XR Software
-
Index
-
Table Of Contents
IPSec Network Security Commands on Cisco IOS XR Software
crypto ipsec security-association lifetime
IPSec Network Security Commands on Cisco IOS XR Software
This chapter describes the Cisco IOS XR software commands used to configure IP Security (IPSec) network security.
For detailed information about IPSec concepts, configuration tasks, and examples, see the Implementing IPSec Network Security on Cisco IOS XR Software configuration module.
clear crypto ipsec sa
To delete specific security associations (SAs), or all SAs in the IP Security (IPSec) security associations database (SADB), use the clear crypto ipsec sa command in EXEC mode.
clear crypto ipsec sa {sa-id | all}
Syntax Description
sa-id
Identifier for the SA. IPSec supports from 1 to 500 sessions.
all
Deletes all IPSec SAs in the IPSec SADB.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
SAs are established to secure data flows in IPSec. Use the clear crypto ipsec sa command to delete active IPSec sessions or force IPSec to reestablish new SAs. Usually, the establishment of SAs is negotiated between peers through Internet Key Exchange (IKE) on behalf of IPSec.
Examples
The following example shows how to remove the SA with ID 100 from the SADB:
RP/0/RP0/CPU0:router# clear crypto ipsec sa 100Related Commands
client authentication list
To apply extended authentication (Xauth) for Internet Key Exchange (IKE) interaction, use the client authentication list command in profile configuration mode. To remove Xauth, use the no form of this command.
client authentication list authen-list-name
no client authentication list authen-list-name
Syntax Description
authen-list-name
Username and password storage location (local or remote server) as defined in the aaa authentication login command.
Defaults
No default behavior or values
Command Modes
Profile configuration
Command History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Xauth allows all Cisco IOS XR software authentication, authorization, and accounting (AAA) authentication methods to perform user authentication in a separate phase after the IKE authentication phase 1 exchange. The AAA configuration list name must match the Xauth configuration list name for user authentication to occur.
Examples
In the following example, AAA username and password storage location information is applied from the list0 authentication list to a profile named sample:
RP/0/RP0/CPU0:router(config)# crypto ipsec profile sampleRP/0/RP0/CPU0:router(config-sample)# client authentication list list0Related Commands
crypto ipsec chkpt-disabled
To disable IP Security (IPSec) checkpointing, use the crypto ipsec chkpt-disabled command in global configuration mode. To reenable checkpointing, use the no form of this command.
crypto ipsec chkpt-disabled
no crypto ipsec chkpt-disabled
Syntax Description
This command has no arguments or keywords.
Defaults
IPSec checkpointing is enabled by default.
Command Modes
Global configuration
Command History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
IPSec checkpoints security associations (SAs) in the local database. If an IPSec process restarts, SAs are retrieved from the local database and need not be reestablished with remote peers.
An SA describes how two or more entities use security services to communicate securely. For example, an IPSec SA defines the encryption algorithm (if used), the authentication algorithm, and the shared session key to be used during the IPSec connection.
IPSec checkpointing is enabled by default. To disable IPSec checkpointing, use the crypto ipsec chkpt-disabled command in global configuration mode.
Examples
The following example shows how to disable IPSec checkpointing:
RP/0/RP0/CPU0:router(config)# crypto ipsec chkpt-disabledcrypto ipsec profile
To configure the IP Security (IPSec) profile and enter profile configuration mode, use the crypto ipsec profile command in global configuration mode. To remove the IPSec profile, use the no form of this command.
crypto ipsec profile name
no crypto ipsec profile name
Syntax Description
Defaults
No default behavior or values
Command Modes
Global configuration
Command History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the crypto ipsec profile command to create a new crypto profile or modify an existing crypto profile.
Crypto profiles configure cryptographic behavior for IPSec transport and tunnel modes, including the keying mechanism to be used, how the traffic is protected, and so on.
The following commands are available in profile configuration mode:
•
client authentication list authen-list-name and no client authentication list
The authen-list-name argument specifies the authentication name that Internet Key Exchange (IKE) uses for extended authentication (Xauth) support.
•
The author-list-name argument specifies the authorization list that IKE will use for mode configuration.
•
This command configures the access control list (ACL) to use for packet classification and the transform set to use for IPSec processing. Multiples of this command are supported. You cannot use the same ACL name more than once.
•
This command sets or resets the perfect forward secrecy (PFS) setting for IKE to handle Diffie-Hellman negotiation.
The default is group1, which corresponds to 768-bit Diffie-Hellman prime modulus group; group2 corresponds to 1024-bit Diffie-Hellman prime modulus group; and group5 corresponds to 1536-bit Diffie-Hellman prime modulus group.
PFS is a cryptographic characteristic associated with a derived shared secret value. With PFS, if one key is compromised, previous and subsequent keys are not compromised because subsequent keys are not derived from previous keys.
•
This command sets or resets the profile mode. Default is static. Dynamic mode lets the profile handle Dynamic Crypto Profile (DCP), which means security association (SA) negotiation from any authenticated peer is allowed. Static mode lets the peer be identified in the configuration (tunnel mode). The discover argument enables IKE tunnel endpoint discovery (TED) protocol handling.
Examples
The following example shows how to create a crypto profile named newprofile, set the PFS to group2, and configure newprofile as a dynamic profile with IKE TED protocol handling:
RP/0/RP0/CPU0:router(config)# crypto ipsec profile newprofileRP/0/RP0/CPU0:router(config-newprofile)# set pfs group2RP/0/RP0/CPU0:router(config-newprofile)# set type dynamic discoverRP/0/RP0/CPU0:router(config-newprofile) match myacl transform-set mytransformsetRelated Commands
crypto ipsec security-association lifetime
To change global lifetime values used when negotiating IP Security (IPSec) security associations (SAs), use the crypto ipsec security-association lifetime command in global configuration mode. To reset an SA lifetime to the default value, use the no form of this command.
crypto ipsec security-association lifetime {seconds seconds | kilobytes kilobytes}
no crypto ipsec security-association lifetime {seconds | kilobytes}
Syntax Description
Defaults
seconds: 3600 seconds (1 hour)
kilobytes: 4194303 kilobytes (10 MBps for 1 hour)Command Modes
Global configuration
Command History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
IPSec SAs use shared secret keys. These keys and their SAs time out together.
Assuming that the particular crypto profile entry does not have lifetime values configured, when the router requests new SAs during SA negotiation, it specifies its global lifetime value in the request to the peer; it uses this value as the lifetime of the new SAs. When the router receives a negotiation request from the peer, it uses either the smaller of the lifetime value proposed by the peer or the locally configured lifetime value as the lifetime of the new SAs.
There are two lifetimes: a "timed" lifetime and a "traffic-volume" lifetime. The SA expires after the first of these lifetimes is reached.
If you change a global lifetime, the change is not applied to existing SAs, but is used in subsequent negotiations to establish new SAs. If you want the new settings to take effect sooner, clear all or part of the SA database by using the clear crypto ipsec sa command.
To change the global timed lifetime, use the crypto ipsec security-association lifetime seconds form of the command. The timed lifetime causes the SA to time out after the specified number of seconds have passed.
To change the global traffic-volume lifetime, use the crypto ipsec security-association lifetime kilobytes form of the command. The traffic-volume lifetime causes the SA to time out after the specified amount of traffic (in KB) has been protected by the key of the SAs.
Shorter lifetimes can make mounting a successful key recovery attack more difficult because the attacker has less data encrypted under the same key with which to work. However, shorter lifetimes require more CPU processing time for establishing new SAs.
How These Lifetimes Work
The SA (and corresponding keys) expire according to whichever occurs sooner, either after the number of seconds has passed (specified by the seconds keyword) or after the amount of traffic in KB has passed (specified by the kilobytes keyword).
A new SA is negotiated before the lifetime threshold of the existing SA is reached to ensure that a new SA is ready for use when the old one expires. The new SA is negotiated approximately 30 seconds before the seconds lifetime expires or when the volume of traffic through the tunnel reaches 256 KB less than the kilobytes lifetime (whichever occurs first).
If no traffic has passed through the tunnel during the entire life of the SA, a new SA is not negotiated when the lifetime expires. Instead, a new SA is negotiated only when IPSec identifies another packet that should be protected.
Examples
The following example shows how to shorten lifetimes to reduce the risk that the keys could be compromised. The timed lifetime is shortened to 2700 seconds (45 minutes), and the traffic-volume lifetime is shortened to 2304000 KB (10 MBps for 30 minutes).
RP/0/RP0/CPU0:router(config)# crypto ipsec security-association lifetime seconds 2700RP/0/RP0/CPU0:router(config)# crypto ipsec security-association lifetime kilobytes 2304000Related Commands
crypto ipsec transform-set
To define a transform set (an acceptable combination of security protocols and algorithms), use the crypto ipsec transform-set command in global configuration mode. To delete a transform set, use the no form of this command.
crypto ipsec transform-set transform-set-name transform1 [transform2 [transform3]]
no crypto ipsec transform-set transform-set-name
Syntax Description
Defaults
No default behavior or values
Command Modes
Global configuration
Command History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use transform sets to define the IPSec security protocols and algorithms for Authentication Header (AH), Encapsulating Security Payload (ESP), or both.
For AH, use either of the following authentication algorithms:
•
•
For ESP, use any of the following cipher algorithms:
•
•
•
•
•
For an optional ESP, use either of the following authentication algorithms:
•
•
Verification of valid transform combinations is done during command-line interface (CLI) configuration. Multiple transform sets can be configured, and then one or more of these transform sets are specified in the crypto profile. The transform set defined in the crypto profile is used in the IPSec service affecting negotiation to protect the data flows specified by that crypto profile access list. During the negotiation, the peers search for a transform set that is the same at both peers. When such a transform set is found, it is selected and applied to the protected traffic as part of the IPSec SAs for both peers. Changes to an existing transform set affects subsequent SA negotiations.
Examples of acceptable transform combinations to define the IPSec security protocols and algorithms for AH, ESP, or both follow:
•
•
•
•
The CLI parser prevents you from entering invalid combinations; for example, after you specify an AH transform, you cannot specify another AH transform for the current transform set.
IPSec Protocols: Encapsulation Security Protocol and Authentication Header
Both the ES and AH protocols implement security services for IPSec.
ESP provides packet encryption and optional data authentication and antireplay services. ESP encapsulates the protected data—either a full IP datagram or only the payload—with an ESP header and ESP trailer.
AH provides data authentication and antireplay services. AH is embedded in the protected data; it inserts an AH header immediately after the outer IP header and before the inner IP datagram or payload.
Traffic that originates and terminates at the IPSec peers can be sent in either tunnel or transport mode; all other traffic is sent in tunnel mode. Tunnel mode encapsulates and protects a full IP datagram; transport mode encapsulates and protects the payload of an IP datagram.
Tip
•
•
•
•
•
Suggested transform combinations follow:
•
•
Changing Existing Transforms
If one or more transforms are specified in the crypto ipsec transform-set command for an existing transform set, the specified transform replaces the existing transform for that transform set.
Any change to a transform set definition is applied only to crypto profile entries that reference the transform set. The changes are not applied to existing SAs, but are used in subsequent negotiations to establish new SAs. If you want the new settings to take effect sooner, clear all or part of the security association database (SADB) by using the clear crypto ipsec sa command.
Examples
The following example shows how to define the transform set to be used with an IPSec peer that supports esp-sha-hmac:
RP/0/RP0/CPU0:router(config)# crypto ipsec transform-set new esp-sha-hmacRelated Commands
crypto ipsec transport
To enter IPSec transport configuration mode, use the crypto ipsec transport command in global configuration mode. To exit IPSec transport configuration mode, use the no form of this command.
crypto ipsec transport
no crypto ipsec transport
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Global configuration
Command History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Authentication Header (AH) and Encapsulating Security Payload (ESP) operate in two IPSec modes, transport and tunnel.
In the transport mode, IP Security (IPSec) protects the Upper Layer Protocol (ULP) header and the payload. IPSec transport mode is used when security is desired end-to-end, that is, security endpoints are the same as host endpoints.
In the tunnel mode, the entire IP datagram is protected, which includes the IP header, the ULP header, and the payload. Tunnel mode is used when security endpoints are not the same as host endpoints. IPSec tunnels can be nested.
All transport mode IPSec traffic has to be configured in the crypto ipsec transport mode.
Examples
The following example shows that IPSec transport configuration mode is entered and then a crypto profile is configured in this mode:
RP/0/RP0/CPU0:router(config)# crypto ipsec transportRP/0/RP0/CPU0:router(config-transport)# profile pn1Related Commands
description (IPSec profile)
To create a description of an IPSec profile, use the description command in profile configuration mode. To delete a profile description, use the no form of this command.
description string
no description
Syntax Description
Defaults
The default description is blank.
Command Modes
Profile configuration
Command History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the description command inside the profile configuration submode to create a description for an IPSec profile.
Examples
The following example shows the creation of a profile description:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# crypto ipsec profile newprofileRP/0/RP0/CPU0:router(config-newprofile)# description this is a sample profileisakmp authorization list
To apply mode configuration for Internet Key Exchange (IKE) interaction, use the isakmp authorization list command in profile configuration mode. To remove mode configuration, use the no form of this command.
isakmp authorization list author-list-name
no isakmp authorization list author-list-name
Syntax Description
author-list-name
Storage source used to find the policy as defined in the
aaa authorization network command.
Defaults
No default behavior or values
Command Modes
Profile configuration
Command History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Mode configuration allows a gateway to download an IP address (and other network level configuration) to the client as part of an IKE negotiation. Using this exchange, the gateway gives IP addresses to the IKE client to be used as an "inner" IP address encapsulated under IP Security (IPSec). This method provides a known IP address for the client that can be matched against IPSec policy.
Use the isakmp authorization list command with the client authentication list command, which applies extended authentication (Xauth) for IKE interaction.
Examples
In the following example, mode configuration is applied to a crypto profile named new:
RP/0/RP0/CPU0:router(config-new)# isakmp authorization list list2Related Commands
match transform-set
To configure an access control list (ACL) to use for packet classification, and if the packet needs protecting, the transform set to use for IP Security (IPSec) processing, use the match transform-set command in profile configuration mode. To remove the configuration, use the no form of this command.
match transform-set acl-name transform-set-name
no match transform-set acl-name transform-set-name
Syntax Description
acl-name
ACL number used for packet classification. Range is from 1 to 65535.
transform-set-name
Name of a transform set. Maximum is 32 characters in length.
Defaults
No default behavior or values
Command Modes
Profile configuration
Command History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Examples
The following example shows how to specify 101 as the ACL and tset1 as the transform set:
RP/0/RP0/CPU0:router(config-profile)# match 101 transform-set tset1Related Commands
Configures the IPSec profile and enters profile configuration mode.
Defines a transform set (an acceptable combination of security protocols and algorithms).
profile
To specify which crypto profile to use for IP Security (IPSec) processing, use the profile command in transport or interface tunnel configuration mode. To remove a crypto profile name, use the no form of this command.
profile profile-name
no profile profile-name
Syntax Description
Defaults
No default behavior or values
Command Modes
Transport configuration
Interface tunnel configurationCommand History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the profile command to specify the crypto profile to use in IPSec processing, and then determine which traffic is protected and how the traffic is protected.
The same crypto profile cannot be shared in different IPSec modes. Multiple commands can be specified for different types of traffic.
Examples
The following example shows a crypto profile being configured:
RP/0/RP0/CPU0:router(config)# crypto ipsec transportRP/0/RP0/CPU0:router(config-transport)# profile pn1RP/0/RP0/CPU0:router(config)# interface tunnel-ipsec0RP/0/RP0/CPU0:router(config-if)# profile pn1Related Commands
set pfs
To set or reset the perfect forward secrecy (PFS) setting for Internet Key Exchange (IKE) to handle Diffie-Hellman negotiation, use the set pfs command in profile configuration mode. To reset the PFS setting, use the no form of this command.
set pfs {group1 | group2 | group5}
no set pfs {group1 | group2 | group5}
Syntax Description
Defaults
group1
Command Modes
Profile configuration
Command History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
PFS is a cryptographic characteristic associated with a derived shared secret value. With PFS, if one key is compromised, previous and subsequent keys are not compromised, because subsequent keys are not derived from previous keys.
Examples
In the following example, an IP Security (IPSec) profile named myprofile is created and PFS is set to group2:
RP/0/RP0/CPU0:router(config)# crypto ipsec profile myprofileRP/0/RP0/CPU0:router(config-myprofile)# set pfs group2set type
To set the profile mode type, use the set type command in profile configuration mode. To reset the mode type, use the no form of this command.
set type {static | dynamic [discover]}
no set type
Syntax Description
Defaults
static
Command Modes
Profile configuration
Command History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Examples
In the following example, the profile mode type is set to dynamic and IKE TED handling is enabled:
RP/0/RP0/CPU0:router(config)# crypto ipsec profile myprofileRP/0/RP0/CPU0:router(config-myprofile)# set type dynamic discovershow crypto ipsec sa
To display security association (SA) information based on the rack/slot/module location, use the show crypto ipsec sa command in EXEC mode.
show crypto ipsec sa [ sa-id | peer ip-address | profile profile-name | detail]
Syntax Description
Command Modes
EXEC
Command History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
If no optional argument or keyword is used, all SAs are displayed within a flow. Within a flow, the SAs are listed by protocol (Encapsulating Security Payload [ESP] or Authentication Header [AH]) and direction (inbound or outbound).
Examples
The following sample output is from the show crypto ipsec sa command:
RP/0/RP0/CPU0:router# show crypto ipsec saSA id: 2interface: tunnel0profile: pn1local ident (addr/mask/prot/port): (172.19.70.92/255.255.255.255/0/0)remote ident (addr/mask/prot/port): (172.19.72.120/255.255.255.255/0/0)##pkts processed: 0, ##pkts dropped 0, ##total bytes 0local crypto endpt: 172.19.70.92, remote crypto endpt: 172.19.72.120outbound esp sas:spi: 0x8b0e950f (2332988687)transform: esp-3des-shain use settings = Tunnelsa lifetime: 3600s, 4194303kbSA id: 2interface: tunnel0profile: pn1local ident (addr/mask/prot/port): (172.19.72.120/255.255.255.255/0/0)remote ident (addr/mask/prot/port): (172.19.70.92/255.255.255.255/0/0)##pkts processed: 0, ##pkts dropped 0, ##total bytes 0local crypto endpt: 172.19.72.120, remote crypto endpt: 172.19.70.92inbound esp sas:spi: 0x2777997c (662149500)transform: esp-3des-shain use settings = Tunnelsa lifetime: 3600s, 4194303kbTable 11 describes the significant fields shown in the display.
The following sample output is from the show crypto ipsec sa profile command for a profile named pn1:
RP/0/RP0/CPU0:router# show crypto ipsec sa profile pn1SA id: 2interface: tunnel0profile: pn1local ident (addr/mask/prot/port): (172.19.70.92/255.255.255.255/0/0)remote ident (addr/mask/prot/port): (172.19.72.120/255.255.255.255/0/0)local crypto endpt: 172.19.70.92, remote crypto endpt: 172.19.72.120outbound esp sas:spi: 0x8b0e950f (2332988687)transform: esp-3des-shain use settings = Tunnelsa lifetime: 3600s, 4194303kbSA id: 2interface: tunnel0profile: pn1local ident (addr/mask/prot/port): (172.19.72.120/255.255.255.255/0/0)remote ident (addr/mask/prot/port): (172.19.70.92/255.255.255.255/0/0)local crypto endpt: 172.19.72.120, remote crypto endpt: 172.19.70.92inbound esp sas:spi: 0x2777997c (662149500)transform: esp-3des-shain use settings = Tunnelsa lifetime: 3600s, 4194303kbThe following sample output is from the show crypto ipsec sa peer command:
RP/0/RP0/CPU0:router# show crypto ipsec sa peer 172.19.72.120SA id: 2interface: tunnel0profile: pn1local ident (addr/mask/prot/port): (172.19.70.92/255.255.255.255/0/0)remote ident (addr/mask/prot/port): (172.19.72.120/255.255.255.255/0/0)local crypto endpt: 172.19.70.92, remote crypto endpt: 172.19.72.120outbound esp sas:spi: 0x8b0e950f (2332988687)transform: esp-3des-shain use settings = Tunnelsa lifetime: 3600s, 4194303kbSA id: 2interface: tunnel0profile: pn1local ident (addr/mask/prot/port): (172.19.72.120/255.255.255.255/0/0)remote ident (addr/mask/prot/port): (172.19.70.92/255.255.255.255/0/0)local crypto endpt: 172.19.72.120, remote crypto endpt: 172.19.70.92inbound esp sas:spi: 0x2777997c (662149500)transform: esp-3des-shain use settings = Tunnelsa lifetime: 3600s, 4194303kbshow crypto ipsec summary
To display IP Security (IPSec) summary information, use the show crypto ipsec summary command in EXEC mode.
show crypto ipsec summary
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Examples
The following sample output is from the show crypto ipsec summary command:
RP/0/RP0/CPU0:router# show crypto ipsec summary# * Attached to a transform indicates a bundle# Active IPSec Sessions:1SA Node Local Peer Remote Peer Mode Profile Transform Lifetime--------------------------------------------------------------------------------1 0/0/0 10.0.0.5 172.16.0.5 TN captain esp-3des 1800/4194303Table 12 describes the significant fields shown in the display.
tunnel destination (IPSec)
To specify the destination for a tunnel interface, use the tunnel destination command in interface configuration mode. To remove the destination, use the no form of this command.
tunnel destination ip-address
no tunnel destination ip-address
Syntax Description
Defaults
No tunnel interface destination is specified.
Command Modes
Interface configuration
Command History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the tunnel destination command to configure the destination address for an IP Security (IPSec) tunnel.
You should not have two tunnels using the same encapsulation mode with the same source and destination address.
Examples
The following example shows how to configure the tunnel destination 172.19.72.120:
RP/0/RP0/CPU0:router(config)# interface tunnel-ipsec0RP/0/RP0/CPU0:router(config-if)# tunnel source 172.19.70.92RP/0/RP0/CPU0:router(config-if)# tunnel destination 172.19.72.120RP/0/RP0/CPU0:router(config-if)# profile pn1Related Commands
tunnel source (IPSec)
To specify the source address for a tunnel interface, use the tunnel source command in interface configuration mode. To remove the source address, use the no form of this command.
tunnel source {ip-address | type instance}
no tunnel source
Syntax Description
Defaults
No tunnel interface source address or interface is specified.
Command Modes
Interface configuration
Command History
Release 2.0
This command was introduced on the Cisco CRS-1.
Release 3.0
No modification.
Release 3.2
This command was supported on the Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the tunnel source command to configure the source address or interface type and instance for an IP Security tunnel.
Examples
The following example shows how to configure the tunnel source 172.19.72.92:
RP/0/RP0/CPU0:router(config)# interface tunnel-ipsec0RP/0/RP0/CPU0:router(config-if)# tunnel source 172.19.72.92RP/0/RP0/CPU0:router(config-if)# tunnel destination 172.19.72.120RP/0/RP0/CPU0:router(config-if)# profile pn1Related Commands
