 Feedback
|
Table Of Contents
Public Key Infrastructure Commands on Cisco IOS XR Software
Public Key Infrastructure Commands on Cisco IOS XR Software
This module describes the Cisco IOS XR software commands used to configure Public Key Infrastructure (PKI).
For detailed information about PKI concepts, configuration tasks, and examples, see the Implementing Certification Authority Interoperability on Cisco IOS XR Software configuration module.
clear crypto ca certificates
To clear certificates associated with trustpoints that no longer exist in the configuration file, use the clear crypto ca certificates command in EXEC mode.
clear crypto ca certificates trustpoint
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
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 the router is loaded with a new configuration file and certificates in the new configuration file do not have their corresponding trustpoint configuration, use the clear crypto ca certificates command to clear the certificates associated with trustpoints that no longer exist in the configuration file.
The clear crypto ca certificates command deletes both certification authority (CA) and router certificates from the system.
Task ID
Examples
The following example shows how to clear the certificates associated with trustpoints that no longer exist in the configuration file:
RP/0/RP0/CPU0:router# clear crypto ca certificates tp_1clear crypto ca crl
To clear all the Certificate Revocation Lists (CRLs) stored on the router, use the clear crypto ca crl command in EXEC mode.
clear crypto ca crl
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
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 clear crypto ca crl command to clear all CRLs stored on the router. As a result, the router goes through the certification authorities (CAs) to download new CRLs for incoming certificate validation requests.
Task ID
Examples
The following example shows how to clear all CRLs stored on the router:
RP/0/RP0/CPU0:router# show crypto ca crlsCRL Entry===============================================Issuer : cn=Certificate Manager,ou=HFR,o=Cisco Systems,l=San Jose,st=CA,c=USLast Update : [UTC] Wed Jun 5 02:40:04 2002Next Update : [UTC] Wed Jun 5 03:00:04 2002CRL Distribution Point :ldap://manager.cisco.com/CN=Certificate Manager,O=Cisco SystemsRP/0/RP0/CPU0:router# clear crypto ca crlRP/0/RP0/CPU0:router# show crypto ca crlsRelated Commands
crl optional (trustpoint)
To allow the certificates of other peers to be accepted without trying to obtain the appropriate CRL, use the crl optional command in trustpoint configuration mode. To return to the default behavior in which CRL checking is mandatory before your router can accept a certificate, use the no form of this command.
crl optional
no crl optional
Syntax Description
This command has no arguments or keywords.
Defaults
The router must have and check the appropriate CRL before accepting the certificate of another IP security peer.
Command Modes
Trustpoint configuration
Command History
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.
When your router receives a certificate from a peer, it searches its memory for the appropriate CRL. If the router finds the appropriate CRL, that CRL is used. Otherwise, the router downloads the CRL from either the certificate authority (CA) or from a CRL distribution point (CDP) as designated in the certificate of the peer. Your router will then check the CRL to ensure that the certificate that the peer sent has not been revoked. If the certificate appears on the CRL, your router cannot accept the certificate and will not authenticate the peer. To instruct the router not to download the CRL and treat the certificate as not revoked, use the crl optional command.
Task ID
Examples
The following example declares a CA and permits your router to accept certificates without trying to obtain a CRL. This example also specifies a nonstandard retry period and retry count.
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# crypto ca trustpoint mycaRP/0/RP0/CPU0:router(config-trustp)# enrollment url http://ca_serverRP/0/RP0/CPU0:router(config-trustp)# enrollment retry period 20RP/0/RP0/CPU0:router(config-trustp)# enrollment retry count 100RP/0/RP0/CPU0:router(config-trustp)# crl optionalRelated Commands
crypto ca authenticate
To authenticate the certification authority (CA) by getting the certificate for the CA, use the crypto ca authenticate command in EXEC mode.
crypto ca authenticate ca-name
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
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.
The crypto ca authenticate command is required when you initially configure CA support at your router.
This command authenticates the CA to your router by obtaining the CA certificate, which contains the public key for the CA. For self-signed root CA, because the CA signs its own certificate, you should manually authenticate the CA public key by contacting the CA administrator when you use this command. The certificate fingerprint matching is done out-of-band (for example, phone call, and so forth).
Authenticating a second-level CA requires prior authentication of the root CA.
After the crypto ca authenticate command is issued and the CA does not respond by the specified timeout period, you must obtain terminal control again to re-enter the command.
Task ID
Examples
The CA sends the certificate, and the router prompts the administrator to verify the certificate by checking the certificate fingerprint (a unique identifier). The CA administrator can also display the CA certificate fingerprint, so you should compare what the CA administrator sees to what the router displays on the screen. If the fingerprint on the display matches the fingerprint displayed by the CA administrator, you should accept the certificate as valid.
The following example shows that the router requests the CA certificate:
RP/0/RP0/CPU0:router# crypto ca authenticate msioxRetrieve Certificate from SFTP server? [yes/no]: yesRead 860 bytes as CA certificateSerial Number : 06:A5:1B:E6:4F:5D:F7:83:41:11:D5:F9:22:7F:95:23Subject:Name: CA2CN= CA2Issued By :cn=CA2Validity Start : 07:51:51 UTC Wed Jul 06 2005Validity End : 08:00:43 UTC Tue Jul 06 2010CRL Distribution Pointhttp://10.56.8.236/CertEnroll/CA2.crlCertificate has the following attributes:Fingerprint: D0 44 36 48 CE 08 9D 29 04 C4 2D 69 80 55 53 A3Do you accept this certificate? [yes/no]: yesRP/0/0/CPU0:router#RP/0/0/CPU0:Apr 10 00:28:52.324 : cepki[335]: %SECURITY-CEPKI-6-INFO : certificate database updatedDo you accept this certificate? [yes/no] yesRelated Commands
Configures a trusted point with a selected name.
Displays information about your certificate and the certificate of the CA.
crypto ca cancel-enroll
To cancel a current enrollment request, use the crypto ca cancel-enroll command in EXEC mode.
crypto ca cancel-enroll ca-name
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
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 ca enroll command to request certificates from the CA for the Rivest, Shamir, and Adelman (RSA) key pairs for the router defined by the rsakeypair command in trustpoint configuration mode. If no rsakeypair command is configured for the current trustpoint, the default RSA key pair is used for enrollment. This task is also known as enrolling with the CA. Use the crypto ca cancel-enroll command to cancel a current enrollment request.
Task ID
Examples
The following example shows how to cancel a current enrollment request from a CA named myca:
RP/0/RP0/CPU0:router# crypto ca cancel-enroll mycaRelated Commands
Obtains a router certificate from the CA.
Specifies a named RSA key pair for a trustpoint.
crypto ca enroll
To obtain a router certificate from the certification authority (CA), use the crypto ca enroll command in EXEC mode.
crypto ca enroll ca-name
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
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 ca enroll command to request certificates from the CA for the Rivest, Shamir, and Adelman (RSA) key pairs for the router defined by the rsakeypair command in trustpoint configuration mode. If no rsakeypair command is configured for the current trustpoint, the default RSA key pair is used for enrollment. This task is also known as enrolling with the CA. (Enrolling and obtaining certificates are two separate events, but they both occur when the crypto ca enroll command is issued.) When using manual enrollment, these two operations occur separately.
The router needs a signed certificate from the CA for each of the RSA key pairs on the router; if you previously generated general-purpose keys, this command obtains the one certificate corresponding to the one general-purpose RSA key pair. If you previously generated special-usage keys, this command obtains two certificates corresponding to each of the special-usage RSA key pairs.
If you already have a certificate for your keys, you are unable to configure this command; instead, you are prompted to remove the existing certificate first. (You can remove existing certificates by removing the trustpoint configuration with the no crypto ca trustpoint command.)
The crypto ca enroll command is not saved in the router configuration.
Task ID
Examples
The following sample output is from the crypto ca enroll command:
RP/0/RP0/CPU0:router# crypto ca enroll msiox% Start certificate enrollment... % Create a challenge password. You will need to verbally provide this password to the CA Administrator in order to revoke your certificate. % For security reasons you password will not be saved in the configuration. % Please make a note of it. %Password re-enter Password: Fingerprint: 4F35ADC9 2791997A CE211437 AFC66CF7 RP/0/RP0/CPU0:May 29 18:49:15.572 : pki_cmd: %PKI-6-LOG_INFO : certificate request pending RP/0/RP0/CPU0:May 29 18:52:17.705 : pki_get_cert: %PKI-6-LOG_INFO : certificate is grantedRelated Commands
Configures a trusted point with a selected name.
Specifies a named RSA key pair for a trustpoint.
crypto ca import
To import a certification authority (CA) certificate manually through TFTP, SFTP, or cut and paste it at the terminal, use the crypto ca import command in EXEC mode.
crypto ca import name certificate
Syntax Description
name certificate
Name of the certification authority (CA). This name is the same name used when the CA was declared with the crypto ca trustpoint command.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
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.
Task ID
Examples
The following example shows how to import a CA certificate through cut-and-paste. In this example, the certificate is myca.
RP/0/RP0/CPU0:router# crypto ca import msiox certificateRelated Commands
Configures a trusted point with a selected name.
Displays information about your certificate and the certification authority (CA) certificate.
crypto ca trustpoint
To configure a trusted point with a selected name, use the crypto ca trustpoint command in global configuration mode. To unconfigure a trusted point, use the no form of this command.
crypto ca trustpoint ca-name
no crypto ca trustpoint ca-name
Syntax Description
Defaults
No default behavior or values
Command Modes
Global configuration
Command History
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 ca trustpoint command to declare a CA.
This command allows you to configure a trusted point with a selected name so that your router can verify certificates issued to peers. Your router need not enroll with the CA that issued the certificates to the peers.
The crypto ca trustpoint command enters trustpoint configuration mode, in which you can specify characteristics for the CA with the following commands:
•
crl optional (trustpoint)—The certificates of other peers are accepted without trying to obtain the appropriate CRL.
•
•
•
Note
•
•
•
Required only if your CA supports Lightweight Directory Access Protocol (LDAP).
•
•
•
•
•
Task ID
Examples
The following example shows how to use the crypto ca trustpoint command to create a trustpoint:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# crypto ca trustpoint msioxRP/0/RP0/CPU0:router(config-trustp)# sftp-password xxxxxxRP/0/RP0/CPU0:router(config-trustp)# sftp-username tmordekoRP/0/RP0/CPU0:router(config-trustp)# enrollment url sftp://223.255.254.254/tftpboot/tmordeko/CAcertRP/0/RP0/CPU0:router(config-trustp)# rsakeypair label-2Related Commands
crypto key generate dsa
To generate Digital Signature Algorithm (DSA) key pairs, use the crypto key generate dsa command in EXEC mode.
crypto key generate dsa
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
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 key generate dsa command to generate DSA key pairs for your router.
DSA keys are generated in pairs—one public DSA key and one private DSA key.
If your router already has DSA keys when you issue this command, you are warned and prompted to replace the existing keys with new keys.
To remove the DSA key generated, use the crypto key zeroize dsa command.
Task ID
Examples
The following example shows how to generate a 512-bit DSA key:
RP/0/RP0/CPU0:router# crypto key generate dsaThe name for the keys will be: the_defaultChoose the size of your DSA key modulus. Modulus size can be 512, 768, or 1024 bits. Choosing a key modulus How many bits in the modulus [1024]: 512 Generating DSA keys... Done w/ crypto generate keypair [OK]Related Commands
Deletes a DSA key pair from your router.
Displays the DSA public keys for your router.
crypto key generate rsa
To generate a Rivest, Shamir, and Adelman (RSA) key pair, use the crypto key generate rsa command in EXEC mode.
crypto key generate rsa [usage-keys | general-keys] [keypair-label]
Syntax Description
Defaults
RSA key pairs do not exist. If the usage-keys keyword is not used, general-purpose keys are generated. If no RSA label is specified, the key is generated as the default RSA key.
Command Modes
EXEC
Command History
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 key generate rsa command to generate RSA key pairs for your router.
RSA keys are generated in pairs—one public RSA key and one private RSA key.
If your router already has RSA keys when you issue this command, you are warned and prompted to replace the existing keys with new keys. The keys generated by this command are saved in the secure NVRAM (which is not displayed to the user or backed up to another device).
To remove an RSA key, use the crypto key zeroize rsa command.
Task ID
Examples
The following example shows how to generate an RSA key pair:
RP/0/RP0/CPU0:router# crypto key generate rsaThe name for the keys will be: the_defaultChoose the size of the key modulus in the range of 360 to 2048 for yourGeneral Purpose Keys. Choosing a key modulus greater than 512 may takea few minutes.How many bits in the modulus[1024]: <return>RP/0/RP0/CPU0:router#Related Commands
Deletes the RSA key pair for your router.
Displays the RSA public keys for your router.
crypto key zeroize dsa
To delete the Digital Signature Algorithm (DSA) key pair from your router, use the crypto key zeroize dsa command in EXEC mode.
crypto key zeroize dsa
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
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 key zeroize dsa command to delete the DSA key pair that was previously generated by your router.
Task ID
Examples
The following example shows how to delete DSA keys from your router:
RP/0/RP0/CPU0:router# crypto key zeroize dsa% Keys to be removed are named the_default Do you really want to remove these keys? [yes/no]: yesRelated Commands
crypto key zeroize rsa
To delete all Rivest, Shamir, and Adelman (RSA) keys from the router, use the crypto key zeroize rsa command in EXEC mode.
crypto key zeroize rsa [keypair-label]
Syntax Description
Defaults
If the key pair label is not specified, the default RSA key pair is removed.
Command Modes
EXEC
Command History
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 key zeroize rsa command to delete all RSA keys that were previously generated by the router. After issuing this command, you must perform two additional tasks:
•
•
Task ID
Examples
The following example shows how to delete the general-purpose RSA key pair that was previously generated:
RP/0/RP0/CPU0:router# crypto key zeroize rsa key1% Keys to be removed are named key1 Do you really want to remove these keys? [yes/no]: yesRelated Commands
description (trustpoint)
To create a description of a trustpoint, use the description command in trustpoint configuration mode. To delete a trustpoint description, use the no form of this command.
description string
no description
Syntax Description
Defaults
The default description is blank.
Command Modes
Trustpoint configuration
Command History
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 in the trustpoint configuration mode to create a description for a trustpoint.
Task ID
Examples
The following example shows how to create a trustpoint description:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# crypto ca trustpoint mycaRP/0/RP0/CPU0:router(config-trustp)# description this is the primary trustpointenrollment retry count
To specify the number of times a router resends a certificate request to a certification authority (CA), use the enrollment retry count command in trustpoint configuration mode. To reset the retry count to the default, use the no form of this command.
enrollment retry count number
no enrollment retry count number
Syntax Description
number
Number of times the router resends a certificate request when the router does not receive a certificate from the previous request. The range is from 1 to 100.
Defaults
If no retry count is specified, the default value is 10.
Command Modes
Trustpoint configuration
Command History
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.
After requesting a certificate, the router waits to receive a certificate from the CA. If the router does not receive a certificate within a specified time (the retry period), the router sends another certificate request. The router continues to send requests until it receives a valid certificate, the CA returns an enrollment error, or the configured number of retries (the retry count) is exceeded.
To reset the retry count to the default of 10, use the no form of this command. Setting the retry count to 0 indicates an infinite number of retries. The router sends the CA certificate requests until a valid certificate is received (there is no limit to the number of retries).
Task ID
Examples
The following example shows how to declare a CA, change the retry period to 10 minutes, and change the retry count to 60 retries. The router resends the certificate request every 10 minutes until receipt of the certificate or approximately 10 hours pass since the original request was sent, whichever occurs first (10 minutes x 60 tries = 600 minutes = 10 hours).
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# crypto ca trustpoint mycaRP/0/RP0/CPU0:router(config-trustp)# enrollment url http://ca_serverRP/0/RP0/CPU0:router(config-trustp)# enrollment retry period 10RP/0/RP0/CPU0:router(config-trustp)# enrollment retry count 60Related Commands
enrollment retry period
To specify the wait period between certificate request retries, use the enrollment retry period command in trustpoint configuration mode. To reset the retry period to the default of 1 minute, use the no form of this command.
enrollment retry period minutes
no enrollment retry period minutes
Syntax Description
minutes
Period (in minutes) between certificate requests issued to a certification authority (CA) from the router. The range is from 1 to 60 minutes.
Defaults
minutes: 1 minute
Command Modes
Trustpoint configuration
Command History
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.
After requesting a certificate, the router waits to receive a certificate from the CA. If the router does not receive a certificate within a specified time (the retry period), the router sends another certificate request. The router continues to send requests until it receives a valid certificate, the CA returns an enrollment error, or the configured number of retries (the retry count) is exceeded.
The router sends the CA another certificate request every minute until a valid certificate is received. (By default, the router sends ten requests, but you can change the number of permitted retries with the enrollment retry count command.)
Task ID
Examples
The following example shows how to declare a CA and change the retry period to 5 minutes:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# crypto ca trustpoint mycaRP/0/RP0/CPU0:router(config-trustp)# enrollment retry period 5Related Commands
enrollment terminal
To specify manual cut-and-paste certificate enrollment, use the enrollment terminal command in trustpoint configuration mode. To delete a current enrollment request, use the no form of this command.
enrollment terminal
no enrollment terminal
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Trustpoint configuration
Command History
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.
You can manually cut and paste certificate requests and certificates when you do not have a network connection between the router and certification authority (CA). When the enrollment terminal command is enabled, the router displays the certificate request on the console terminal, which allows you to enter the issued certificate on the terminal.
Task ID
Examples
The following example shows how to manually specify certificate enrollment through cut-and-paste. In this example, the CA trustpoint is myca.
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# crypto ca trustpoint mycaRP/0/RP0/CPU0:router(config-trustp)# enrollment terminalRelated Commands
enrollment url
To specify the certification authority (CA) location by naming the CA URL, use the enrollment url command in trustpoint configuration mode. To remove the CA URL from the configuration, use the no form of this command.
enrollment url CA-URL
no enrollment url CA-URL
Syntax Description
Defaults
No default behavior or values
Command Modes
Trustpoint configuration
Command History
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 enrollment url command to specify the CA URL. This command is required when you declare a CA with the crypto ca trustpoint command. The URL must include the CA script location if the CA scripts are not loaded into the default cgi-bin script location. The CA administrator should be able to tell you where the CA scripts are located.
Table 27 lists the available enrollment methods.
Table 27 Certificate Enrollment Methods
SFTP
Enroll through SFTP: file system
TFTP1
Enroll through TFTP: file system
1 If you are using TFTP for enrollment, the URL must be in the form tftp://certserver/file_specification. (The file specification is optional.)
TFTP enrollment sends the enrollment request and retrieves the certificate of the CA and the certificate of the router. If the file specification is included in the URL, the router appends an extension to the file specification.
To change the CA URL, repeat the enrollment url command to overwrite the previous URL.
Task ID
Examples
The following example shows the absolute minimum configuration required to declare a CA:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# crypto ca trustpoint myca RP/0/RP0/CPU0:router(config-trustp)# enrollment url http://ca.domain.com/certsrv/mscep/mscep.dllRelated Commands
ip-address (trustpoint)
To specify a dotted IP address that is included as an unstructuredAddress in the certificate request, use the ip-address command in trustpoint configuration mode. To restore the default behavior, use the no form of this command.
ip-address {ip-address | none}
no ip-address {ip-address | none}
Syntax Description
ip-address
Dotted IP address that is included in the certificate request.
none
Specifies that an IP address is not included in the certificate request.
Defaults
You are prompted for the IP address during certificate enrollment.
Command Modes
Trustpoint configuration
Command History
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 ip-address command to include the IP address of the specified interface in the certificate request or to specify that an IP address should not be included in the certificate request.
Task ID
Examples
The following example shows how to include the IP address of the Ethernet-0 interface in the certificate request for the trustpoint frog:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# crypto ca trustpoint frogRP/0/RP0/CPU0:router(config-trustp)# enrollment url http://frog.phoobin.com/RP/0/RP0/CPU0:router(config-trustp)# subject-name OU=Spiral Dept., O=tiedye.comRP/0/RP0/CPU0:router(config-trustp)# ip-address 172.19.72.120The following example shows that an IP address is not to be included in the certificate request:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# crypto ca trustpoint mycaRP/0/RP0/CPU0:router(config-trustp)# enrollment url http://10.3.0.7:80RP/0/RP0/CPU0:router(config-trustp)# subject-name CN=subject1, OU=PKI, O=Cisco Systems, C=USRP/0/RP0/CPU0:router(config-trustp)# ip-address noneRelated Commands
query url
To specify Lightweight Directory Access Protocol (LDAP) protocol support, use the query url command in trustpoint configuration mode. To remove the query URL from the configuration, use the no form of this command.
query url LDAP-URL
no query url LDAP-URL
Syntax Description
Defaults
The URL provided in the router certificate's CRLDistributionPoint extension is used.
Command Modes
Trustpoint configuration
Command History
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.
LDAP is a query protocol used when the router retrieves the Certificate Revocation List (CRL). The certification authority (CA) administrator should be able to tell you whether the CA supports LDAP; if the CA supports LDAP, the CA administrator can tell you the LDAP location where certificates and certificate revocation lists should be retrieved.
To change the query URL, repeat the query url command to overwrite the previous URL.
Task ID
Examples
The following example shows the configuration required to declare a CA when the CA supports LDAP:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# crypto ca trustpoint mycaRP/0/RP0/CPU0:router(config-trustp)# query url ldap://my-ldap.domain.comRelated Commands
rsakeypair
To specify a named Rivest, Shamir, and Adelman (RSA) key pair for this trustpoint, use the rsakeypair command in trustpoint configuration mode. To reset the RSA key pair to the default, use the no form of this command.
rsakeypair keypair-label
no rsakeypair keypair-label
Syntax Description
Defaults
If the RSA key pair is not specified, the default RSA key is used for this trustpoint.
Command Modes
Trustpoint configuration
Command History
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 rsakeypair command to specify a named RSA key pair generated using the crypto key generate rsa command for this trustpoint.
Task ID
Examples
The following example shows how to specify the named RSA key pair key1 for the trustpoint myca:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# crypto ca trustpoint mycaRP/0/RP0/CPU0:router(config-trustp)# rsakeypair key1Related Commands
serial-number (trustpoint)
To specify whether the router serial number should be included in the certificate request, use the serial-number command in trustpoint configuration mode. To restore the default behavior, use the no form of this command.
serial-number [none]
no serial-number
Syntax Description
Defaults
You are prompted for the serial number during certificate enrollment.
Command Modes
Trustpoint configuration
Command History
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.
Before you can use the serial-number command, you must enable the crypto ca trustpoint command, which declares the certification authority (CA) that your router should use and enters trustpoint configuration mode.
Use this command to specify the router serial number in the certificate request, or use the none keyword to specify that a serial number should not be included in the certificate request.
Task ID
Examples
The following example shows how to omit a serial number from the root certificate request:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# crypto ca trustpoint rootRP/0/RP0/CPU0:router(config-trustp)# enrollment url http://10.3.0.7:80RP/0/RP0/CPU0:router(config-trustp)# ip-address noneRP/0/RP0/CPU0:router(config-trustp)# serial-number noneRP/0/RP0/CPU0:router(config-trustp)# subject-name ON=Jack, OU=PKI, O=Cisco Systems, C=USRelated Commands
sftp-password (trustpoint)
To secure the FTP password, use the sftp-password command in trustpoint configuration mode. To disable this feature, use the no form of this command.
sftp-password {clear text | clear text | password encrypted string}
no sftp-password {clear text | clear text | password encrypted string}
Syntax Description
Defaults
The clear text argument is the default behavior.
Command Modes
Trustpoint configuration
Command History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.7.0
No modification.
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.
Passwords are stored in encrypted form and not as plain text. The command-line interface (CLI) contains the provisioning (for example, clear and encrypted) to specify the password input.
The username and password are required as part of the SFTP protocol.If you specify the URL that begins with the prefix (sftp://), you must configure the parameters for the sftp-password command under the trustpoint. Otherwise, the certificate from the SFTP server, which is used for manual certificate enrollment, cannot be retrieved.
Task ID
Examples
The following example shows how to secure the FTP password in an encrypted form:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# crypto ca trustpoint msioxRP/0/RP0/CPU0:router(config-trustp)# sftp-password password xxxxxxRelated Commands
sftp-username (trustpoint)
To secure the FTP username, use the sftp-username command in trustpoint configuration mode. To disable this feature, use the no form of this command.
sftp-username username
no sftp-username username
Syntax Description
Defaults
No default behavior or values
Command Modes
Trustpoint configuration
Command History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.7.0
No modification.
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.
The sftp-username command is used only if the URL has (sftp://) in the prefix. If (sftp://) is not specified in the prefix, the manual certificate enrollment using SFTP fails.
Task ID
Examples
The following example shows how to secure the FTP username:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# crypto ca trustpoint msioxRP/0/RP0/CPU0:router(config-trustp)# sftp-username tmordekoRelated Commands
subject-name (trustpoint)
To specify the subject name in the certificate request, use the subject-name command in trustpoint configuration mode. To clear any subject name from the configuration, use the no form of this command.
subject-name [x.500-name]
no subject-name [x.500-name]
Syntax Description
Defaults
If the x-500-name argument is not specified, the fully qualified domain name (FQDN), which is the default subject name, is used.
Command Modes
Trustpoint configuration
Command History
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.
Before you can use the subject-name command, you must enable the crypto ca trustpoint command, which declares the certification authority (CA) that your router should use and enters trustpoint configuration mode.
The subject-name command is an attribute that can be set for autoenrollment; thus, issuing this command prevents you from being prompted for a subject name during enrollment.
Task ID
Examples
The following example shows how to specify the subject name for the frog certificate:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# crypto ca trustpoint frogRP/0/RP0/CPU0:router(config-trustp)# enrollment url http://frog.phoobin.com/RP/0/RP0/CPU0:router(config-trustp)# subject-name OU=Spiral Dept., O=tiedye.comRP/0/RP0/CPU0:router(config-trustp)# ip-address 172.19.72.120Related Commands
show crypto ca certificates
To display information about your certificate and the certification authority (CA) certificate, use the show crypto ca certificates command in EXEC mode.
show crypto ca certificates
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
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 show crypto ca certificates command to display information about the following certificates:
•
•
Task ID
Examples
The following sample output is from the show crypto ca certificates command:
RP/0/RP0/CPU0:router# show crypto ca certificatesTrustpoint : msiox ================================================== CAa certificateSerial Number : 06:A5:1B:E6:4F:5D:F7:83:41:11:D5:F9:22:7F:95:23Subject:Name: CA2CN= CA2Issued By :cn=CA2Validity Start : 07:51:51 UTC Wed Jul 06 2005Validity End : 08:00:43 UTC Tue Jul 06 2010CRL Distribution Pointhttp://10.56.8.236/CertEnroll/CA2.crlRouter certificateStatus : AvailableKey usage : SignatureSerial Number : 38:6B:C6:B8:00:04:00:00:01:45Subject:Name: tdlr533.cisco.comIP Address: 3.1.53.3Serial Number: 8cd96b64Issued By :cn=CA2Validity Start : 08:30:03 UTC Mon Apr 10 2006Validity End : 08:40:03 UTC Tue Apr 10 2007CRL Distribution Pointhttp://10.56.8.236/CertEnroll/CA2.crlAssociated Trustpoint: MS-IOXRouter certificateStatus : AvailableKey usage : EncryptionSerial Number : 38:6D:2B:A7:00:04:00:00:01:46Subject:Name: tdlr533.cisco.comIP Address: 3.1.53.3Serial Number: 8cd96b64Issued By :cn=CA2Validity Start : 08:31:34 UTC Mon Apr 10 2006Validity End : 08:41:34 UTC Tue Apr 10 2007CRL Distribution Pointhttp://10.56.8.236/CertEnroll/CA2.crlAssociated Trustpoint: msioxRelated Commands
show crypto ca crls
To display information about the local cache Certificate Revocation List (CRL), use the show crypto ca crls command in EXEC mode.
show crypto ca crls
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
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.
Task ID
Examples
The following sample output is from the show crypto ca crls command:
RP/0/RP0/CPU0:router# show crypto ca crls CRL Entry =============================================== Issuer : cn=xyz-w2k-root,ou=HFR,o=Cisco System,l=San Jose,st=CA,c=US Last Update : [UTC] Thu Jan 10 01:01:14 2002 Next Update : [UTC] Thu Jan 17 13:21:14 2002 CRL Distribution Point : http://xyz-w2k.cisco.com/CertEnroll/xyz-w2k-root.crlRelated Commands
show crypto key mypubkey dsa
To display the Directory System Agent (DSA) public keys for your router, use the show crypto key mypubkey dsa command in EXEC mode.
show crypto key mypubkey dsa
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
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.
Task ID
Examples
The following sample output is from the show crypto key mypubkey dsa command:
RP/0/RP0/CPU0:router# show crypto key mypubkey dsaKey label: mykeyType : RSA General purposeSize : 1024Created : 17:33:23 UTC Thu Sep 18 2003Data : 3081F230 81AA0605 2B0E0302 0C3081A0 02020200 024100C8 A36B6179 56B8D620 1F77595C 32EF3004 577A9F79 0A8ABDA4 89FB969D 35C04E7E 5491ED4E 120C657C 610576E5 841696B6 0948846C C92F56E5 B4921458 70FC4902 1500AB61 5C0D63D3 EB082BB9 F16030C5 AA0B5D1A DFE50240 73F661EA 9F579E77 B413DBC4 9047B4F2 10A1CFCB 14D98B57 3E0BBA97 9B5120AD F52BBDC7 15B63454 8CB54885 92B6C9DF 7DC27768 FD296844 42024945 5E86C81A 03430002 4071B49E F80F9E4B AF2B62E7 AA817460 87EFD503 C668AD8C D606050B 225CC277 7C0A0974 8072D7D7 2ADDDE42 329FE896 AB015ED1 3A414254 6935FDCA 0043BA4F 66Related Commands
show crypto key mypubkey rsa
To display the Rivest, Shamir, and Adelman (RSA) public keys for your router, use the show crypto key mypubkey rsa command in EXEC mode.
show crypto key mypubkey rsa
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
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.
Task ID
Examples
The following is sample output from the show crypto key mypubkey rsa command:
RP/0/RP0/CPU0:router# show crypto key mypubkey rsaKey label: mykeyType : RSA General purposeSize : 1024Created : 07:46:15 UTC Fri Mar 17 2006Data : 30819F30 0D06092A 864886F7 0D010101 05000381 8D003081 89028181 00CF8CDF 5BFCA055 DA4D164D F6EDB78B 926B1DDE 0383027F BA71BCC6 9D5592C4 5BA8670E 35CD19B7 1C973A46 62CC5F8C 82BD596C F292410F 8E83B753 4BA71BAC 41AB6B60 F34A2499 EDE11639 F88B4210 B2A0CF5F DD678C36 0D8B7DE1 A2AB5122 9ED947D5 76CF5BCD D9A2039F D02841B0 7F8BFF97 C080B791 10A9ED41 00FB6F40 95020301 0001Key label: the_defaultType : RSA General purposeSize : 512Created : 07:46:15 UTC Fri Mar 17 2006Data :305C300D 06092A86 4886F70D 01010105 00034B00 30480241 00C7DE73 7B3EA447 CCE8F3DF DD1327D8 C1C30C45 2EEB4981 B1B48D2B 1AF14665 178058FB 8F6BB6BB E08C6163 FA0EE356 395C8E5F 2AC59383 0706BDDF EC8E5822 9B020301 0001Related Commands
