This document describes best practices and proactive procedures to renew certificates on the Cisco Identity Services Engine (ISE). It also reviews how to set up alarms and notifications so administrators are warned of upcoming events such as certificate expiration.
Note: This document is not intended to be a troubleshooting guide for certificates.
Cisco recommends that you have knowledge of these topics:
Configuration of a Cisco ISE with certificates
The information in this document is based on these software and hardware versions:
Cisco ISE Release 220.127.116.119
Appliance or VMware
As an ISE administrator, you will eventually encounter the fact that ISE certificates expire. If your ISE server has an expired certificate, serious problems might arise unless you replace the expired certificate with a new, valid certificate.
Note: If the certificate that is used for the Extensible Authentication Protocol (EAP) expires, all authentications might fail because clients do not trust the ISE certificate anymore. If the HTTPS protocol certificate expires, the risk is even greater: an administrator might not be able to log in to the ISE anymore, and the distributed deployment might cease to function and replicate.
In this example, the ISE has an installed certificate from a Certificate Authority (CA) server that will expire in one month. The ISE administrator should install a new, valid certificate on the ISE before the old certificate expires. This proactive approach prevents or minimizes downtime and avoids an impact on your end users. Once the time period of the newly installed certificate begins, you can enable the EAP and/or HTTPS protocol on the new certificate.
You can configure the ISE so that it generates alarms and notifies the administrator to install new certificates before the old certificates expire.
Note: This document uses HTTPS with a self-signed certificate in order to demonstrate the impact of certificate renewal, but this approach is not recommended for a live system. It is better to use a CA certificate for both the EAP and HTTPS protocols.
View ISE Self-Signed Certificates
When the ISE is installed, it generates a self-signed certificate. The self-signed certificate is used for administration access and for communication within the distributed deployment (HTTPS) as well as for user authentication (EAP). In a live system, use a CA certificate instead of a self-signed certificate.
The format for an ISE certificate must be Privacy Enhanced Mail (PEM) or Distinguished Encoding Rules (DER).
In order to view the initial self-signed certificate, navigate to Administration > System> Certificates > Local Certificates in the ISE console:
If you install a server certificate on the ISE via a Certificate Signing Request (CSR) and change the certificate for the HTTPS or EAP protocol, the self-signed server certificate is still present but is no longer used.
Caution: For HTTPS protocol changes, a restart of the ISE services is required, which creates a few minutes of downtime. EAP protocol changes do not trigger a restart of the ISE services and do not cause downtime.
Determine When to Change the Certificate
Assume that the installed certificate expires soon. Is it better to let the certificate expire before you renew it or to change the certificate before expiration? You should change the certificate before expiration so that you have time to plan the certificate swap and to manage any downtime caused by the swap.
When should you change the certificate? Obtain a new certificate with a start date that precedes the expiration date of the old certificate. The time period between those two dates is the change window.
Caution: If you enable HTTPS, it causes a service restart on the ISE server, and you experience a few minutes of downtime.
This image depicts the information for a certificate that is issued by a CA and expires on 29 Nov 2013:
Generate Certificate Signing Request
This procedure describes how to renew the certificate through a CSR:
In the ISE console, navigate to Add > Generate Certificate Signing Request.
The minimum information that you must enter in the Certificate Subject text field is CN=ISEfqdn, where ISEfqdn is the Fully Qualified Domain Name (FQDN) of the ISE. Add additional fields such as O (Organization), OU (Organizational Unit), or C (Country) in the Certificate Subject with the use of commas:
One of the Subject Alternative Name (SAN) text field lines must repeat the ISE FQDN. You can add a second SAN field if you want to use alternative names or a wildcard certificate.
A popup window indicates whether the CSR fields are completed correctly:
In order to export the CSR, click Certificate Signing Requests in the left panel, select your CSR, and click Export:
The CSR is saved on your computer. Submit it to your CA for signature.
Once you receive the final certificate from your CA, you must add the certificate to the ISE:
In the ISE console, click Local Certificates in the left panel, then click Add and Bind CA signed Certificate:
Enter a simple, clear description of the certificate in the Friendly Name text field:
Note: Do not enable the EAP or HTTPS protocol at this time.
Because you are installing the new certificate before the old one expires, you see an error that reports a date range in the future (23 Nov 2013 in this example).
Click Yes in order to continue. The certificate is now installed but not in use, as highlighted in green. The overlap between the expiration date and valid date is highlighted in yellow:
Note: If you use self-signed certificates in a distributed deployment, the primary self-signed certificate must be installed into the trusted certificate store of the secondary ISE server. Likewise, the secondary self-signed certificate must be installed into the trusted certificate store of the primary ISE server. This allows the ISE servers to mutually authenticate each other. Without this, the deployment might break. If you renew certificates from a third-party CA, verify whether the root certificate chain has changed and update the trusted certificate store in the ISE accordingly. In both scenarios, ensure that the ISE nodes, endpoint operating systems, and supplicants are able to validate the root certificate chain.
Configure Alerting System
The Cisco ISE notifies you when the expiration date of a local certificate is within 90 days. Such advance notification helps you avoid expired certificates, plan the certificate change, and prevent or minimize downtime.
The notification appears in several ways:
Color expiration status icons appear in the Local Certificates page.
Expiration messages appear in the Cisco ISE System Diagnostic report.
Expiration alarms are generated at 90 days and 60 days, then daily in the final 30 days before expiration.
Configure the ISE for email notification of expiration alarms. In the ISE console, navigate to Administration > System > Settings > SMTP Server, identify the Simple Mail Transfer Protocol (SMTP) server, and define the other server settings so that email notifications are sent for the alarms:
There are two ways that you can set up notifications:
Use Admin Access in order to notify administrators:
Navigate to Administration > System > Admin Access > Administrators > Admin Users.
Check the Include system alarms in emails checkbox for the Admin Users that need to receive alarm notifications. The email address for the sender of the alarm notifications is hardcoded as ise@hostname.
Configure the ISE alarm settings in order to notify users:
Navigate to Administration > System > Settings > Alarm Settings > Alarm Configuration:
Note: Disable the Status for a category if you wish to prevent alarms from that category.
Click Alarm Notification, enter the email addresses of the users to be notified, and save the configuration change. Changes might take up to 15 minutes before they are active.
Use this section in order to confirm that your configuration works properly.
Verify Alerting System
Verify that the alerting system works correctly. In this example, a configuration change generates an alert with a severity level of Information. (An Information alarm is the lowest severity, while certificate expirations generate a higher severity level of Warning.)
This is an example of the email alarm that is sent by the ISE:
Note: In this example, the ISE sends the email alarm message twice to email@example.com, as highlighted in yellow. This email address was set up to receive notifications by both methods explained in Configure Alerting System.
Verify Certificate Change
This procedure describes how to verify that the certificate is installed correctly and how to change the protocols for EAP and/or HTTPS:
On the ISE console, navigate to Administration > Certificates > Local Certificates, and select the new certificate in order to view the details.
Caution: If you enable the HTTPS protocol, the ISE service restarts, which causes server downtime.
In this example, assume that HTTPS restarts the ISE service.
In order to verify the certificate status on the ISE server, enter this command into the CLI:
CLI:> show application status ise
Once all of the services are active, attempt to log in as an administrator.
For a distributed deployment scenario, navigate to Administration > System > Deployment > Node Status on the ISE console, and verify the node status.
Check that the end user authentication is successful. On the ISE console, navigate to Operations > Authentications, and review the certificate for Protected Extensible Authentication Protocol (PEAP)/EAP-Transport Layer Security (TLS) authentication.
If you want to check the certificate externally, you can use the embedded Microsoft Windows tools or the OpenSSL toolkit.
OpenSSL is an open-source implementation of the Secure Sockets Layer (SSL) protocol. If the certificates use your own private CA, you must place your root CA certificate on a local machine and use the OpenSSL option -CApath. If you have an intermediate CA, you must place it into the same directory as well.
In order to obtain general information about the certificate and verify it, use:
It might also be useful to convert the certificates with the OpenSSL toolkit:
openssl x509 -in certificate.der -inform DER -outform PEM -out certificate.pem
There is currently no specific troubleshooting information available for this configuration.
Because you can install a new certificate on the ISE before it is active, Cisco recommends that you install the new certificate before the old certificate expires. This overlap period between the old certificate expiration date and the new certificate start date gives you time to renew certificates and plan their installation with little or no downtime. Once the new certificate enters its valid date range, enable the EAP and/or HTTPS protocol. Remember, if you enable HTTPS, there will be a service restart.