Accept the Thumbprint of a Default TLS Certificate

When you add vCenter Server and Horizon Composer instances to Horizon 7, you must ensure that the TLS certificates that are used for the vCenter Server and Horizon Composer instances are valid and trusted by Connection Server. If the default certificates that are installed with vCenter Server and Horizon Composer are still in place, you must determine whether to accept these certificates' thumbprints.

If a vCenter Server or Horizon Composer instance is configured with a certificate that is signed by a CA, and the root certificate is trusted by Connection Server, you do not have to accept the certificate thumbprint. No action is required.

If you replace a default certificate with a certificate that is signed by a CA, but Connection Server does not trust the root certificate, you must determine whether to accept the certificate thumbprint. A thumbprint is a cryptographic hash of a certificate. The thumbprint is used to quickly determine if a presented certificate is the same as another certificate, such as the certificate that was accepted previously.

Note: If you install vCenter Server and Horizon Composer on the same Windows Server host, they can use the same TLS certificate, but you must configure the certificate separately for each component.

For details about configuring TLS certificates, see "Configuring TLS Certificates for Horizon 7 Servers" in the Horizon 7 Installation document.

You first add vCenter Server and Horizon Composer in Horizon Console by using the Add vCenter Server wizard. If a certificate is untrusted and you do not accept the thumbprint, you cannot add vCenter Server and vCenter Server.

After these servers are added, you can reconfigure them in the Edit vCenter Server dialog box.

Note: You also must accept a certificate thumbprint when you upgrade from an earlier release and a vCenter Server or Horizon Composer certificate is untrusted, or if you replace a trusted certificate with an untrusted certificate.

Procedure

1. When Horizon Console displays an Invalid Certificate Detected dialog box, click View Certificate.
2. Examine the certificate thumbprint in the Certificate Information window.
3. Examine the certificate thumbprint that was configured for the vCenter Server or Horizon Composer instance.
   1. On the vCenter Server or Horizon Composer host, start the MMC snap-in and open the Windows Certificate Store.
   2. Navigate to the vCenter Server or Horizon Composer certificate.
   3. Click the Certificate Details tab to display the certificate thumbprint.
   Similarly, examine the certificate thumbprint for a SAML authenticator. If appropriate, take the preceding steps on the SAML authenticator host.
4. Verify that the thumbprint in the Certificate Information window matches the thumbprint for the vCenter Server or Horizon Composer instance.
   Similarly, verify that the thumbprints match for a SAML authenticator.
5. Determine whether to accept the certificate thumbprint.

   Option	Description
   The thumbprints match.	Click Accept to use the default certificate.
   The thumbprints do not match.	Click Reject. Troubleshoot the mismatched certificates. For example, you might have provided an incorrect IP address for vCenter Server or Horizon Composer.