Overview of Certificate Rotation

Page last updated:

This topic provides an overview of rotating certificate authorities (CAs) and leaf certificates in Ops Manager.

Overview

The Ops Manager API manages and lists internal CAs and leaf certificates that enable Ops Manager components to communicate with each other securely using TLS. It can also list certificates used externally, such as SAML certificates that authenticate to an external identity provider (IDP).

For more information about the CAs and leaf certificates visible to the Ops Manager API, see Certificate Types.

Rotate CAs and leaf certificates before they expire to avoid downtime for your deployment. To rotate certificates in Ops Manager, first check the expiration dates of all certificates. Then, based on the types of certificates that expire soon, follow a certificate rotation procedure to replace expiring certificates and deploy BOSH to apply changes.

When possible, the Ops Manager API invokes CredHub Maestro to rotate certificates. You may encounter CredHub Maestro safety violation errors if you attempt to perform an unsafe operation, such as running a rotation step out of order. For more information about troubleshooting these errors, see Troubleshooting CredHub Maestro Safety Violations During Certificate Rotation.

Check Certificate Expiration Dates and Types

Before determining which certificate rotation procedure to follow, you must determine:

  • Which types of CAs and leaf certificates exist in your deployment.
  • Which CAs and leaf certificates are due to expire soon.

To check the types and expiration dates of your certificates, see Checking Expiration Dates and Certificate Types.

Certificate Rotation Procedures

The topics listed in this section explain how to rotate certificates in Ops Manager, including the Ops Manager root CA, BOSH NATS CA, CAs stored in CredHub, and leaf certificates. There are different rotation procedures for each type of certificate that requires rotation.

Warning: The rotation procedures described in the topics below do not work if the certificates have already expired. If the certificates have expired, contact Support for guidance.

To rotate certificates, follow one of these procedures:

Rotating Other Certificates

Other certificates that the Ops Manager API does not rotate include:

  • The Services TLS CA. To rotate this CA, see Advanced Certificate Rotation with CredHub Maestro.

  • IDP SAML certificates. To rotate IDP SAML certificates, see Rotating Identity Provider SAML Certificates.

  • IPsec certificates. To rotate IPsec certificates, see Rotating IPsec Certificates in the IPsec documentation.

  • CredHub-managed certificates for the following product versions:

    • TAS for VMs v2.7.0-v2.7.20
    • TAS for VMs v2.8.0-v2.8.1
    • Isolation Segment tile v2.7.0-v2.7.20
    • Isolation Segment tile v2.8.0-v2.8.1
    • Small Footprint TAS for VMs v2.7.0-v2.7.20
    • Small Footprint TAS for VMs v2.8.0-v2.8.1
    • TAS for VMs [Windows] v2.7.0-v2.7.16
    • TAS for VMs [Windows] v2.8.0-v2.8.1