Loading

×Sorry to interrupt
Uncaught ReferenceError: addCTracking is not defined
throws at https://kb.vmware.com/resource/KM_TealiumTrackingJS?v=0.5:100:1

Refresh

Cookie Preference Center

General Information on cookies

When you visit our website, we use cookies to ensure that we give you the best experience. This information does not usually directly identify you, but it can give you a more personalized web experience. Because we respect your right to privacy, you can choose not to allow some types of cookies by clicking on the different category headings to find out more and change your settings. However, blocking some types of cookies may impact your experience on the site and the services we are able to offer. Further information can be found in our

Cookie Policy.

Strictly Necessary

Strictly Necessary

Always Active

Strictly Necessary

Strictly necessary cookies are always enabled since they are essential for our website to function. They enable core functionality such as security, network management, and website accessibility. You can set your browser to block or alert you about these cookies, but this may affect how the website functions. For more information please visit www.aboutcookies.org or www.allaboutcookies.org.

Cookie Details‎

Performance

Performance

Performance

Performance cookies are used to analyze the user experience to improve our website by collecting and reporting information on how you use it. They allow us to know which pages are the most and least popular, see how visitors move around the site, optimize our website and make it easier to navigate.

Cookie Details‎

Please confirm your settings by refreshing the page.

Functional

Functional

Functional

Functional cookies help us keep track of your past browsing choices so we can improve usability and customize your experience. These cookies enable the website to remember your preferred settings, language preferences, location and other customizable elements such as font or text size. If you do not allow these cookies, then some or all of these services may not function properly.

Cookie Details‎

Advertising

Advertising

Advertising

Advertising cookies are used to send you relevant advertising and promotional information. They may be set through our site by third parties to build a profile of your interests and show you relevant advertisements on other sites. These cookies do not directly store personal information, but their function is based on uniquely identifying your browser and internet device.

Cookie Details‎

Advertising Cookies

Consent Leg.Interest

Select All Vendors

Select All Vendors

Select All Hosts

Select All

Clear Filters

Information storage and access

Apply

Confirm My Choices Reject All Allow All

My Subscriptions

Loading

Knowledge Base

How to add/delete Custom CA Certificates to SDDC Manager and Common Services trust stores (78607)

Last Updated: 11/16/2023Categories: TroubleshootingTotal Views: 20737Language:
English

7 like this article

Subscribe to get an email
newsletter with new updates

7 people found this helpful Please provide article feedback:

Symptoms

If the custom CA root certificate is not published to the SDDC Manager truststores, then the subsequent errors might be evident:

PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target; nested exception is javax.net.ssl.SSLHandshakeException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

In SOS logs:
2020-03-26T11:04:28.661Z [ERROR restutil.py::get::128::_collect_https_esx_logsThread0] GET call failed for https://esxi-1.vrack.vsphere.local/cgi-bin/vm-support.cgi due to HTTPSConnectionPool(host='esxi-1.vrack.vsphere.local', port=443): Max retries exceeded with url: /cgi-bin/vm-support.cgi (Caused by SSLError(SSLError("bad handshake: Error([('SSL routines', 'tls_process_server_certificate', 'certificate verify failed')])")))

Note: This log excerpt is an example. Date, time, and environmental variables may vary depending on your environment.

Resolution

The custom CA root certificate should be added to SDDC-Manager trust stores.

To add custom CA root certificate to SDDC Manager (versions prion to 4.1) trust store:

Note: Take a snapshot of the SDDC Manager VM prior to starting this process

Use a file transfer utility to copy the trusted certificate file to the /tmp directory on the SDDC Manager VM.

SSH to the SDDC Manager VM as the VCF user and then issue the su - command to switch to the root user.

Obtain the trusted certificates key by issuing the following command:

cat /etc/vmware/vcf/commonsvcs/trusted_certificates.key

Note: You will see output similar to the following:

q_0EZjUI7Z^B7V@2A+ ----> Key Store Password

Issue a command similar to the following to import the certificate into the SDDC Manager trust store

keytool -importcert -alias <aliasname> -file <certificate file> -keystore /etc/vmware/vcf/commonsvcs/trusted_certificates.store

When prompted, enter the password.

Notes:

Type yes when prompted to trust the certificate.

Enter alias name, for the <aliasname> value.

Replace <certificate file> with the full path to the certificate file that was uploaded in Step 1.

Replace <trust store key> with the key value returned in Step 3.

Issue a command similar to the following to import the certificate into the java trust store:

keytool -importcert -alias <aliasname> -file <certificate file> -keystore /etc/alternatives/jre/lib/security/cacerts --storepass changeit

Notes:

Type yes when prompted to trust the certificate.

Replace <certificate file> with the full path to the certificate file that was uploaded in Step 1

Issue a command similar to the following to verify that the new trusted certificate has been added to the SDDC Manager trust store:

keytool -list -v -keystore /etc/vmware/vcf/commonsvcs/trusted_certificates.store -storepass <trust store key>

Note: Replace <trust store key> with the trusted certificates key value returned in Step 3
Issue the following command to restart the SDDC Manager services:

/opt/vmware/vcf/operationsmanager/scripts/cli/sddcmanager_restart_services.sh

To delete a stale certificate in trust store : (Please reach out to GSS if you are not sure)

a. Take Snapshot of SDDC manager VM
b. Find the alias of the duplicate cert by running this command
keytool -list -v -keystore /etc/vmware/vcf/commonsvcs/trusted_certificates.store -storepass <trust store key>
c.Delete the duplicate alias by running

keytool -delete -alias alias_fetched_from_above -keystore /etc/vmware/vcf/commonsvcs/trusted_certificate.store

To add custom CA root certificate to SDDC Manager (versions 4.1 and later) trust store:

Public API can also be used from VCF 4.1 to add/delete trusted certificates to the SDDC manager trust store.

Import the trusted certificate using Public API.

VMware Cloud Foundation API Reference Guide

SSH to SDDC Manager and after importing CA certificate to the trust store.

Restart all the SDDC Manager Services using the below command

/opt/vmware/vcf/operationsmanager/scripts/cli/sddcmanager_restart_services.sh

To add custom CA root certificate to SDDC Manager (versions 4.5.1 and later) trust store:

The trusted certificate can also be added to the SDDC Manager trust store using the SDDC Manager UI.
Follow the steps mentioned in  Add a Trusted Certificate to the SDDC Manager Trust Store

Workaround

The attached python script can also be run from SDDC Manager to add the trusted certificates to the SDDC Manager.

Detectable by VMware SkylineTM

Actions

Copy

link to clipboard
copied!

Print

Language:
English

Attachments

root_sync.py

Additional Resources

KB
•
vCenter 6.5/6.7 から 7.0 へのアップグレード時に、「vCenter Server Appliance FQDN が VMware Endpoint Certificate Store の証明書に一致しない」(vCenter Server Appliance FQDN does not match the certificate in VMware Endpoint Certificate Store) というエラーが表示される (78657)

KB
•
在 vCloud Director 10 中，收集 vRealize Operations Aggregate Total 总合计（MB）衡量指标时，值始终值为 0 (78612)

KB
•
从 vSphere 导入虚拟机时出现报错：无法查找属性 'vcloud.HardwareVersion.Hw4.MaxNics' (78582)

Results 1-3 of 3

Ask The Community

Get answers quickly from VMware experts in the community

Post Subject

CONTINUE IN COMMUNITIES

Related Products:

VMware Cloud Foundation

Related Versions:

Vmware Cloud Foundation 4.5.1

Take Our Survey

Support Assistant