VM Backup 9.22 strengthens the security policies applied to VMware connections, in line with VMware's recommendations and industry best practice. VM Backup now connects to a VMware host only if the host's certificate is trusted by the VM Backup machine.
Hosts whose certificate does not meet this policy are reported as not reachable. Certificates from your organization's or a public certificate authority, configured as described in VMware's documentation, resolve this. If you keep the certificates issued by the VMware Certificate Authority (VMCA), VM Backup can connect after a few configuration steps on the VM Backup machine.
PROBLEM
After upgrading to VM Backup 9.22, one or more of the following occur, although the host is online, the credentials are correct and the host connected before the upgrade:
-
Adding or testing a VMware host fails with: "The Host could not be reached. Please make sure that the Host is online and available"
- VMware hosts that were already configured may no longer connect, and their backups may fail.
ISSUE
VM Backup 9.22 validates the certificate of every VMware host it connects to, in the same way as Windows and web browsers. The certificate must:
- Be issued by a certificate authority that Windows trusts on the VM Backup machine.
- Be issued for the address entered in VM Backup (host name or IP address).
- Not have expired.
- Have a revocation status that can be checked, and not be revoked.
SOLUTION
Recommended — Certificates from your certificate authority, following VMware's guidance
- Configure the certificates of your vCenter and ESXi hosts as described in VMware's security documentation, using certificates from your organization's certificate authority or a public certificate authority.
-
Your VMware administrator can find the procedures in VMware's documentation:
vCenter: vSphere Security Certificates describes Hybrid Mode, which VMware calls "simple and secure": the vCenter's machine SSL certificate is replaced with one from your certificate authority, and VMCA continues to manage the internal and ESXi host certificates. Replacing vSphere Certificates compares the available approaches.
Standalone ESXi host: Managing Certificates for ESX Hosts describes how to use certificates from your own certificate authority.
Alternative for vCenter/ESXi — Use VMCA-issued certificates
If you would like to use VMCA issued certificates, we recommend following VMware's security guidance to keep your VMware environment, and the systems connected to it, secure. VMware recommends keeping vCenter and ESXi hosts on an isolated management network (see About the VMware Certificate Authority).
We recommend placing the VM Backup machine in that network, and using that VM Backup installation only for virtual machines on hosts within it. This keeps VM Backup's VMware connections within the network that VMware intends for management traffic.
Note: make sure that you are adding root certificate not an intermediate certificate.
You can follow the steps below:
- On the VM Backup machine, use Chrome with administrator rights, type the address of the host you will add to VM Backup, starting with
https://:
- vCenter:
https://<vcenter>/, for examplehttps://vcenter.example.com/ - standalone ESXi host:
https://<esxi>/
Take note of the Root certificate thumbprint shown here.
- vCenter:
Click Not secure › Certificate details and read Issued By on the General tab.
-
For vCenter installations "Issued by" will show as CA
In Chrome, open
https://<vcenter>/afd/vecs/caIf Chrome warns "Your connection is not private", click Advanced › Proceed. Chrome saves the file as
ca.cerin Downloads.
- For standalone ESXi hosts
- In Chrome, on
https://<esxi>/, click Not secure › Certificate details › Details. - Under Certificate Hierarchy, select the top entry,
VMware Installer. If the hierarchy shows only one entry, the host's name, stop: see the warning above. - Click Export… and save it as
ca.cerin Downloads. The ESXi certificate must also be issued for the host's name. If Issued To on the General tab is
localhost.localdomainor a different name, VM Backup does not accept the host even after these steps. The ESXi administrator must first set the host's name and regenerate the certificate.
- In Chrome, on
Check the thumbprint. Double-click
ca.cer. On General, Issued To must be the certificate authority (for exampleCA), not the host's name. Open Details and select Thumbprint. Compare it with the value from the VMware administrator. Do not continue if it differs.
-
Install it into Local Machine › Trusted Root Certification Authorities:
In the certificate window from step 1, click Install Certificate….
Store Location: select Local Machine (default is Current User). Click Next and accept the administrator prompt.
Select Place all certificates in the following store (default is automatic). Click Browse… and choose Trusted Root Certification Authorities.
Click Next, then Finish. Windows shows "The import was successful."
To confirm successful installation, double-click
ca.ceragain. The red cross and "not trusted" message are gone, and Certification Path shows "This certificate is OK."
-
Turn off revocation checking. VMCA does not publish revocation information, so VM Backup does not accept VMCA certificates until revocation checking is explicitly turned off. This is done with a small settings file,
SecurityOptions.altj
Note: revocation checking will be disabled for all HTTPS connections made by this specific VM Backup insallation.
Create the settings file
C:\ProgramData\Hornetsecurity\VMBackup\Options\SecurityOptions.altjwith this content:{ "CheckCertificateRevocationList": false }
In Notepad (run as administrator), choose Save as type: All files so that Notepad does not add.txt. Create theOptionsfolder if it does not exist.
Restart all Hornetsecurity services
Confirm that the host is now able to connect, or attempt to connect your vCenter/ESXi if it has not been added already. Use the host's host name, not its IP address, unless the certificate also lists the IP address.
Alternative for Standalone ESXi — Used a self-signed certificate
We recommend placing the VM Backup machine in the same network, and using that VM Backup installation only for virtual machines on hosts within it. This keeps VM Backup's VMware connections within the network that VMware intends for management traffic.
- For standalone ESXi hosts
- In Chrome, on
https://<esxi>/, click Not secure › Certificate details › Details. - Under Certificate Hierarchy, select the top entry,
VMware Installer. If the hierarchy shows only one entry, the host's name, stop: see the warning above. - Click Export… and save it as
ca.cerin Downloads. The ESXi certificate must also be issued for the host's name. If Issued To on the General tab is
localhost.localdomainor a different name, VM Backup does not accept the host even after these steps. The ESXi administrator must first set the host's name and regenerate the certificate.
- In Chrome, on
Check the thumbprint. Double-click
ca.cer. On General, Issued To must be the certificate authority (for exampleCA), not the host's name. Open Details and select Thumbprint. Compare it with the value from the VMware administrator. Do not continue if it differs.
-
Install it into Local Machine › Trusted Root Certification Authorities:
In the certificate window from step 1, click Install Certificate….
Store Location: select Local Machine (default is Current User). Click Next and accept the administrator prompt.
Select Place all certificates in the following store (default is automatic). Click Browse… and choose Trusted Root Certification Authorities.
Click Next, then Finish. Windows shows "The import was successful."
To confirm successful installation, double-click
ca.ceragain. The red cross and "not trusted" message are gone, and Certification Path shows "This certificate is OK."
Offsite Backup Servers connecting to VMware Hosts (for Replication)
The Offsite Backup Server connects to VMware hosts for replication. From version 9.22, it applies the same certificate policy as VM Backup, so the same resolutions apply on the Offsite Backup Server machine. The settings of VM Backup and the Offsite Backup Server are separate: changes on the VM Backup machine do not affect the Offsite Backup Server.
The above resolutions apply for the Offsite Backup Server as well. The recommended resolution is naturally the preferred solution, especially if the Offsite Backup Server is available over the Internet and not just locally accessible.
If it's local only and would like to proceed with a VMCA-issued certificate, follow steps 1-7 in the Alternative section above and for step 8 create the settings file in the Offsite Backup Server's own folder, and restart its service:
Settings file:
C:\ProgramData\Hornetsecurity\OffsiteBackupServer\Options\SecurityOptions.altj, with the same content. TheOptionsfolder does not exist by default; create it.Restart Service: Hornetsecurity Offsite Backup Server
At this point the VMware host should connect.