The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter describes how to configure certification authority (CA) interoperability, which is provided in support of the IPSec protocol. CA interoperability permits Cisco IOS devices and CAs to communicate so that your Cisco IOS device can obtain and use digital certificates from the CA. Although IPSec can be implemented in your network without the use of a CA, using a CA provides manageability and scalability for IPSec.
You need to have a certification authority (CA) available to your network before you configure this interoperability feature. The CA must support the Public Key Infrastructure (PKI) protocol, and the Simple Certificate Enrollment Protocol (SCEP) .
Information About Certification Authority
Without certification authority (CA) interoperability, Cisco IOS devices could not use CAs when deploying IPSec. CAs provide a manageable, scalable solution for IPSec networks.
Cisco supports the following standards with this feature:
Certificate authorities (CAs) are responsible for managing certificate requests and issuing certificates to participating IPSec network devices. These services provide centralized key management for the participating devices.
CAs simplify the administration of IPSec network devices. You can use a CA with a network containing multiple IPSec-compliant devices such as routers.
Digital signatures, enabled by public key cryptography, provide a means of digitally authenticating devices and individual users. In public key cryptography, such as the RSA encryption system, each user has a key pair containing both a public and a private key. The keys act as complements, and anything encrypted with one of the keys can be decrypted with the other. In simple terms, a signature is formed when data is encrypted with a user's private key. The receiver verifies the signature by decrypting the message with the sender's public key. The fact that the message could be decrypted using the sender's public key indicates that the holder of the private key, the sender, must have created the message. This process relies on the receiver's having a copy of the sender's public key and knowing with a high degree of certainty that it really does belong to the sender and not to someone pretending to be the sender.
Digital certificates provide the link. A digital certificate contains information to identify a user or device, such as the name, serial number, company, department, or IP address. It also contains a copy of the entity's public key. The certificate is itself signed by a certification authority (CA), a third party that is explicitly trusted by the receiver to validate identities and to create digital certificates.
In order to validate the signature of the CA, the receiver must first know the CA's public key. Normally this process is handled out-of-band or through an operation done at installation. For instance, most web browsers are configured with the public keys of several CAs by default. The Internet Key Exchange (IKE), an essential component of IPSec, can use digital signatures to scalably authenticate peer devices before setting up security associations.
Without digital signatures, one must manually exchange either public keys or secrets between each pair of devices that use IPSec to protect communications between them. Without certificates, every new device added to the network requires a configuration change on every other device with which it communicates securely. With digital certificates, each device is enrolled with a certification authority. When two devices wish to communicate, they exchange certificates and digitally sign data to authenticate each other. When a new device is added to the network, one simply enrolls that device with a CA, and none of the other devices needs modification. When the new device attempts an IPSec connection, certificates are automatically exchanged and the device can be authenticated.
Some CAs have a registration authority (RA) as part of their implementation. An RA is essentially a server that acts as a proxy for the CA so that CA functions can continue when the CA is offline.
Some of the configuration tasks described in this document differ slightly, depending on whether your CA supports an RA.
How to Configure Certification Authority
Certificates and certificate revocation lists (CRLs) are used by your device when a CA is used. Normally certain certificates and all CRLs are stored locally in the NVRAM of the device, and each certificate and CRL uses a moderate amount of memory.
In some cases, storing these certificates and CRLs locally will not present any difficulty. In other cases, memory might become a problem—particularly if the CA supports an RA and a large number of CRLs have to be stored on the device. If the NVRAM is too small to store root certificates, only the fingerprint of the root certificate is saved.
To save NVRAM space, specify that certificates and CRLs should not be stored locally, but should be retrieved from the CA when needed. This alternative will save NVRAM space but could result in a slight performance impact. To specify that certificates and CRLs should not be stored locally on your device, but should be retrieved when required, enable query mode.
If you do not enable query mode now, you can do it later even if certificates and CRLs have are already stored on the device. In this case, when you enable query mode, the stored certificates and CRLs are deleted from the device after you save the configuration. (If you copy the configuration to a TFTP site prior to enabling query mode, you can save any stored certificates and CRLs at the TFTP site.)
Before disabling query mode, perform the copy system:running-config nvram:startup-config command to save all current certificates and CRLs to NVRAM. Otherwise they could be lost during a reboot.
To specify that certificates and CRLs should not be stored locally on your device, but should be retrieved when required, enable query mode by using the following command in global configuration mode:
 Note |
Query mode may affect availability if the CA is down. |
| Command or Action | Purpose |
|---|---|
|
crypto ca certificate query Example: |
Enables query mode, which causes certificates and CRLs not to be stored locally. |
You must configure the host name and IP domain name of a device if this has not already been done. This is required because the device assigns a fully qualified domain name (FQDN) to the keys and certificates used by IPsec, and the FQDN is based on the host name and IP domain name assigned to the device. For example, a certificate named "device20.example.com" is based on a device host name of "device20" and a device IP domain name of "example.com".
| Command or Action | Purpose | |
|---|---|---|
|
Step 1 |
enable Example: |
|
|
Step 2 |
configure terminal Example: |
Enters global configuration mode. |
|
Step 3 |
hostname name Example: |
Configures the host name of the device. |
|
Step 4 |
ip domain-name name Example: |
Configures the IP domain name of the device. |
|
Step 5 |
end Example: |
Exits global configuration and returns to privileged EXEC mode. |
Rivest, Shamir, and Adelman (RSA) key pairs are used to sign and encrypt IKE key management messages and are required before obtaining a certificate for your device.
| Command or Action | Purpose | |
|---|---|---|
|
Step 1 |
enable Example: |
|
|
Step 2 |
configure terminal Example: |
Enters global configuration mode. |
|
Step 3 |
crypto key generate rsa [usage-keys] Example: |
|
|
Step 4 |
end Example: |
Exits global configuration and returns to privileged EXEC mode. |
You should declare one certification authority (CA) to be used by the device.
| Command or Action | Purpose | |
|---|---|---|
|
Step 1 |
enable Example: |
|
|
Step 2 |
configure terminal Example: |
Enters global configuration mode. |
|
Step 3 |
crypto ca trustpoint name Example: |
Declares the certification authority (CA) that your device should use and enters the CA profile enroll configuration mode. |
|
Step 4 |
enrollment url url Example: |
Specifies the URL of the CA server to which enrollment requests are sent. |
|
Step 5 |
enrollment command Example: |
Specifies the HTTP command that is sent to the CA for enrollment. |
|
Step 6 |
exit Example: |
Exit CA profile enroll configuration mode and returns to global configuration mode. |
|
Step 7 |
crypto pki trustpoint name Example: |
Declares the trustpoint that your device should use and enters Ca-trustpoint configuration mode. |
|
Step 8 |
crl query ldap://url:[port] Example: |
Queries the certificate revocation list (CRL) to ensure that the certificate of the peer is not revoked. |
|
Step 9 |
enrollment {mode ra | retry count number | retry period minutes | url url} Example: |
Specifies the enrollment wait period between certificate request retries. |
|
Step 10 |
enrollment {mode ra | retry count number | retry period minutes | url url} Example: |
Specifies the number of times a device will resend a certificate request when it does not receive a response from the previous request. |
|
Step 11 |
revocation-check method1 [method2 method3] Example: |
Checks the revocation status of a certificate. |
|
Step 12 |
end Example: |
Exit CA trustpoint configuration mode and returns to privileged EXEC mode. |
| Command or Action | Purpose | |
|---|---|---|
|
Step 1 |
enable Example: |
|
|
Step 2 |
configure terminal Example: |
Enters global configuration mode. |
|
Step 3 |
crypto ca trustpoint name Example: |
Declares the trustpoint that your device should use and enters CA trustpoint configuration mode. |
|
Step 4 |
revocation-check method1 [method2 method3] Example: |
Checks the revocation status of a certificate. |
|
Step 5 |
root tftp server-hostname filename Example: |
Obtains the certification authority (CA) certificate via TFTP. |
|
Step 6 |
enrollment http-proxy hostname port-number Example: |
Accesses the certification authority (CA) by HTTP through the proxy server. |
|
Step 7 |
end Example: |
Exits CA trustpoint configuration mode and returns to privileged EXEC mode. |
The device must authenticate the certification authority (CA). It does this by obtaining the self-signed certificate of the CA, which contains the public key of the CA. Because the certificate of the CA is self-signed (the CA signs its own certificate) the public key of the CA should be manually authenticated by contacting the CA administrator to compare the fingerprint of the CA certificate when you perform this step.
Perform the following task to get the public key of the CA:
| Command or Action | Purpose | |
|---|---|---|
|
Step 1 |
enable Example: |
|
|
Step 2 |
configure terminal Example: |
Enters global configuration mode. |
|
Step 3 |
crypto pki authenticatename Example: |
Authenticates the CA by getting the certificate of the CA. |
|
Step 4 |
end Example: |
Exits global configuration mode and returns to privileged EXEC mode. |
You must obtain a signed certificate from the certification authority (CA) for each of the RSA key pairs on your device. If you generated general-purpose RSA keys, your device has only one RSA key pair and needs only one certificate. If you previously generated special-usage RSA keys, your device has two RSA key pairs and needs two certificates.
Note |
If your device reboots after you have issued the crypto pki enroll command, but before you have received the certificates, you must reissue the command and notify the CA administrator. |
| Command or Action | Purpose | |
|---|---|---|
|
Step 1 |
enable Example: |
|
|
Step 2 |
configure terminal Example: |
Enters global configuration mode. |
|
Step 3 |
crypto pki enroll number Example: |
Obtains certificates for your device from the CA. |
|
Step 4 |
end Example: |
Exits global configuration mode and returns to privileged EXEC mode. |
Saving Your Configuration
Always remember to save your work when you make configuration changes.
Use the copy system:running-config nvram:startup-config command to save your configuration. This command includes saving RSA keys to private NVRAM. RSA keys are not saved with your configuration when you use a copy system:running-config rcp: or copy system:running-config tftp: command.
Monitoring and Maintaining Certification Authority
You can request a certificate revocation list (CRL) only if the certification authority (CA) does not support a registration authority (RA). The following task applies only when the CA does not support an RA.
When a device receives a certificate from a peer, your device will download a CRL from the CA. The device then checks the CRL to make sure the certificate that the peer sent has not been revoked. (If the certificate appears on the CRL, the device will not accept the certificate and will not authenticate the peer.)
A CRL can be reused with subsequent certificates until the CRL expires if query mode is off. If the device receives a peer's certificate after the applicable CRL has expired, the device will download the new CRL.
If the device has a CRL that has not yet expired, but you suspect that the contents of the CRL are out of date, you can request that the latest CRL be downloaded immediately to replace the old CRL.
| Command or Action | Purpose | |
|---|---|---|
|
Step 1 |
enable Example: |
|
|
Step 2 |
configure terminal Example: |
Enters global configuration mode. |
|
Step 3 |
crypto pki crl request name Example: |
Requests that a new certificate revocation list (CRL) be obtained immediately from the CA. |
|
Step 4 |
end Example: |
Exits global configuration mode and returns to privileged EXEC mode. |
You can query a certificate revocation list (CRL) only when you configure your device with a trusted root. When your device receives a certificate from a peer from another domain (with a different CA), the CRL downloaded from the CA of the device will not include certificate information about the peer. Therefore, you should check the CRL published by the configured root with the LDAP URL to ensure that the certificate of the peer has not been revoked.
If you would like CRL of the root certificate to be queried when the device reboots, you must enter the crl query command.
Perform the following task to query the CRL published by the configured root with the LDAP URL:
| Command or Action | Purpose | |
|---|---|---|
|
Step 1 |
enable Example: |
|
|
Step 2 |
configure terminal Example: |
Enters global configuration mode. |
|
Step 3 |
crypto pki trustpoint name Example: |
Declares the trustpoint that your device should use and enters CA trustpoint configuration mode. |
|
Step 4 |
crl query ldap ://url : [port] Example: |
Queries the CRL to ensure that the certificate of the peer has not been revoked. |
|
Step 5 |
end Example: |
Exits CA trustpoint configuration mode and returns to privileged EXEC mode. |
Under certain circumstances you may want to delete RSA keys from your device. For example, if you believe the RSA keys were compromised in some way and should no longer be used, you should delete the keys.
]| Command or Action | Purpose | |
|---|---|---|
|
Step 1 |
enable Example: |
|
|
Step 2 |
configure terminal Example: |
Enters global configuration mode. |
|
Step 3 |
crypto key zeroize rsa [key-pair-label] Example: |
Deletes all Rivest, Shamir, and Adelman (RSA) keys from your device. |
|
Step 4 |
end Example: |
Exits global configuration mode and returns to privileged EXEC mode. |
| Command or Action | Purpose | |
|---|---|---|
|
Step 1 |
enable Example: |
|
|
Step 2 |
configure terminal Example: |
Enters global configuration mode. |
|
Step 3 |
crypto key pubkey-chain rsa Example: |
Enters public key chain configuration mode, so that you can manually specify other devices’ RSA public keys. |
|
Step 4 |
no named key key-name [encryption | signature] Example: |
Deletes the RSA public key of a remote peer and enters public key configuration mode. |
|
Step 5 |
end Example: |
Exits public key configuration mode and returns to privileged EXEC mode. |
If the need arises, you can delete certificates that are saved in your device. Your devices saves its own certificates, the certificate of the CA, and any RA certificates .
To delete the CA's certificate, you must remove the entire CA identity, which also removes all certificates associated with the CA—your router's certificate, the CA certificate, and any RA certificates.
| Command or Action | Purpose | |
|---|---|---|
|
Step 1 |
enable Example: |
|
|
Step 2 |
show crypto pki certificates Example: |
Displays information about your device certificate, the certification authority (CA) certificate, and any registration authority (RA) certificates. |
|
Step 3 |
configure terminal Example: |
Enters global configuration mode. |
|
Step 4 |
crypto pki certificate chain name Example: |
Enters certificate chain configuration mode. |
|
Step 5 |
no certificate certificate-serial-number Example: |
Deletes the certificate. |
|
Step 6 |
exit Example: |
Exits certificate chain configuration mode and returns to global configuration mode. |
|
Step 7 |
no crypto pki import name certificate Example: |
Deletes a certificate manually. |
|
Step 8 |
exit Example: |
Exits global configuration mode and returns to privileged EXEC mode. |
Perform the following task toview keys and certificates:
| Command or Action | Purpose | |
|---|---|---|
|
Step 1 |
enable Example: |
|
|
Step 2 |
show crypto key mypubkey rsa [keyname] Example: |
Displays the RSA public keys configured on a device. |
|
Step 3 |
show crypto key pubkey-chain rsa Example: |
Displays the RSA public keys of the peer that are stored on a device. |
|
Step 4 |
show crypto key pubkey-chain rsa [name key-name | address key-address] Example: |
Displays the address of a specific key. |
|
Step 5 |
show crypto pki certificates Example: |
Displays information about the device certificate, the certification authority (CA) certificate, and any registration authority (RA) certificates |
|
Step 6 |
show crypto pki trustpoints Example: |
Displays trustpoints that are configured on a device. |
Feedback