Configuring CA signed certificates for ESXi 6.x/7.0 hosts
search cancel

Configuring CA signed certificates for ESXi 6.x/7.0 hosts

book

Article ID: 341649

calendar_today

Updated On:

Products

VMware vSphere ESXi

Issue/Introduction

This article guides you through the configuration of Certificate Authority (CA) certificates for a ESXi 6.x/7.0 host. The instructions provided helps you eliminate errors or common causes for problems during certificate implementation, including configuration steps and details, and avoid misconfiguration in implementation of custom certificates in your environment.
 
ESXi hosts that are upgraded from vSphere 5.x to vSphere 6.x continue to use their CA signed certificates if they were replaced in the previous versions. However, ESXi 5.x hosts that were running self-signed certificates and then upgraded to vSphere 6.x will have their certificates regenerated using VMware-signed. For more information, see Host Upgrades and Certificates in the vSphere Security guide. This article helps you to replace ESXi certificate.
  • This article will help you to replace ESXi SSL custom certificate
  • This article help you yo add/install/change and generate ESXi host certificate 
  • This article help you to import and replace certificate for ESXi custom certificate


Environment

VMware vSphere ESXi 6.7
VMware vSphere ESXi 6.5
VMware vSphere ESXi 6.0
VMware vSphere ESXi 7.0.0

Resolution

Note: This article is part of several resolution paths. Before performing the steps in this article, see Implementing CA signed SSL certificates in vSphere 6.0 (2111219)
 
Creating CA assigned certificates for an ESXi 6.x/7.0 host is a complex task. In many organizations, it is required to maintain proper security for regulatory requirements. Each server must be unique to the component as it ties to the fully qualified domain name of the server. As such you cannot just take a single certificate and apply it to all hosts. ESXI wildcard certificates are currently not supported, but even if they were, it is much more secure to have a proper certificate for each host. There are several different work flows required for a successful implementation:
These steps must be followed to ensure successful implementation of a custom certificate for an ESXi 6.x/7.0 host. Before attempting these steps ensure that:

Generating a Certificate Request

To generate a certificate request for an ESXi 6.x/7.0 host:
  1. Open a command prompt and navigate to the OpenSSL directory as previously configured using the Configuring OpenSSL for installation and configuration of CA signed certificates in the vSphere environment article. By default this is C:\OpenSSL-Win32\bin.
  2. Run the command:

    openssl req -new -nodes -out rui.csr -keyout rui-orig.key -config openssl.cfg

    Note: There are no prompts because all information was provided in the openssl.cfg file as configured in the previous article.

    This creates the certificate request rui.csr.
     
  3. Convert the Key to be in RSA format by running these command:

    openssl rsa -in rui-orig.key -out rui.key
After rui.csr is created, proceed to Getting the certificate.

Getting the Certificates

After the certificate request is created, the certificate must be given to the certificate authority for generation of the actual certificate. The authority presents a certificate back, as well as a copy of their root certificate, if necessary. For the certificate chain to be trusted, the root certificate must be installed on the server.
 
Follow the appropriate section for the steps for the certificate authority in question.
 

For Commercial CAs:

  1. Take the certificate request ( rui.csr, as generated above) and send it to the authority in question.
  2. The authority will send back the generated certificate.
  3. Install the root certificate in vCenter Server before proceeding to the Installation of the certificate section of this document.
     

For Microsoft CAs:


Note: For Windows Server 2003 CA's, Enterprise edition is required. Other Windows Server 2003 editions do not have the correct templates for exporting a valid SSL certificate.
  1. Create a custom template for certificate creation. For more information, see Creating a Microsoft Certificate Authority Template for SSL certificate creation in vSphere 6.x.
  2. Log in to the Microsoft CA certificate authority web interface. By default, it is http://servername/CertSrv/ .
  3. Click Request a certificate.
  4. Click advanced certificate request.
  5. Click Submit a certificate request by using a base-64-encoded CMC or PKCS #10 file, or submit a renewal request by using a base-64-encoded PKCS #7 file.
  6. Open the certificate request using a text editor.
  7. Copy the content from -----BEGIN CERTIFICATE REQUEST----- to -----END CERTIFICATE REQUEST----- into the Saved Request box.
  8. Select the custom template created in step 1.
  9. Click Submit to submit the request.
  10. Click Base 64 encoded on the Certificate issued screen.
  11. Click Download Certificate.
  12. Save the certificate on the desktop of the server as rui.crt. When complete, proceed to Installing and configuring the certificate on the ESXi host to complete the configuration of the custom certificate.

Installing and configuring the certificate on the ESXi host

After the certificate is created, complete the installation and configuration of the certificate on the ESXi 6.x/7.0 host: 

Note: Skip the first two steps if the ESXi is not part of vCenter Server (standalone host). Also, steps mentioned in "Process to update the vCenter Server database with the new certificate thumbprint" is not applicable for Standalone ESXi hosts.
  1. Log in to vCenter Server.
  2. Put the host into Maintenance Mode.

    Note: If the ESXi 6.x/7.0 connects to VC 6.x/7.0 after replacing its cert with this KB, the host certs will be replaced by VMCA signed certs. VC 6.x/7.0 needs to switch to custom certificate mode first. For more information, see Understanding Certificate Mode Switches.
  3. Navigate to the console of the server to enable SSH on the ESXi host
  4. Press F2 to log in to the Direct Console User Interface (DCUI)
  5. Click Troubleshooting options > Enable SSH
  6. Log in to the host and then navigate to /etc/vmware/ssl
  7. Copy the files to a backup location, such as a VMFS volume
  8. Log in to the host with WinSCP and navigate to the /etc/vmware/ssl directory
  9. Delete the existing rui.crt and rui.key from the directory
  10. Copy the newly created rui.crt and rui.key to the directory using Text Mode or ASCII mode to avoid the issue of special characters ( ^M) appearing in the certificate file
  11. Type vi rui.crt to validate that there are no extra characters

    Note: There should not be any erroneous ^M characters at the end of each line.
     
  12. Switch back to the DCUI of the host and select Troubleshooting Options > Restart Management Agents
  13. When prompted press F11 to restart the agents. Wait until they are restarted
  14. Press ESC several times until you logout of the DCUI
  15. Exit the host from Maintenance Mode
When complete, the host is made available and successfully rejoins the cluster.

Note: If the host is a part of a View cluster, you may need to perform these steps after updating the certificates to update the vCenter Server database with the new certificate thumbprint:

Process to update the vCenter Server database with the new certificate thumbprint:

  1. Log in to vCenter Server
  2. Place the host into the Maintenance Mode
  3. Right-click the host and click Disconnect
  4. Remove the disconnected host from the View cluster
  5. Recompose the View desktop(s) again on the existing hosts in the cluster and ensure that they recompose successfully
  6. Right-click on the disconnected host and select Connect
  7. Add the host back to the cluster
  8. Set DRS to Manual (optional)
  9. Recompose the desktop on the host that was recently added back into the cluster
  10. If step 9 is successful, set DRS back to Automatic, if required
The configuration of the custom certificate is now complete. Repeat these steps for each host which needs to have a custom certificate.


Additional Information

VMware Skyline Health Diagnostics for vSphere - FAQ
If you are receiving error "Failed to import new SSl certificate", please verify the MD5 check against the Private Key and the Certificate files, both should match if the Private Key belongs to the same certificate.
  • Login to ESXi host using SSH
  • Use below commands to run MD5 check 
openssl x509 -in <path to the Certificate file> -noout -modulus | openssl md5
openssl rsa -in <path to the Private Key file> -noout -modulus | openssl md5

Example (where certificate not matching with private key): 
# openssl x509 -in rui.crt -noout -modulus | openssl md5
(stdin)= 55d84795791549fe72fc498c69f0dd2d
# openssl rsa -in rui.key -noout -modulus | openssl md5
(stdin)= 6b84b1c62e91dbfc6b9f9efa5d34fb86

Reviewing hostd log (/var/run/log/hostd.log) will help to identify the cause if the MD5 values are matching and still getting the same error during Import operation.

Configuring CA signed certificates for ESXi 5.x hosts
Replacing default certificates with CA signed SSL certificates in vSphere 6.x
Creating a Microsoft Certificate Authority Template for SSL certificate creation in vSphere 6.0

Read this article in different language here:
ESXi 6.0 ホスト用の CA 署名証明書の構成
为 ESXi 6.0 主机配置 CA 签名证书

Powered by Wolken Software