Question
How do I configure TLS on Tableau Server with Independent Gateway (TSIG) when I want to use a certificate that has a certification path?
How do I configure TLS on Tableau Server with Independent Gateway (TSIG) when I want to use a certificate that has a certification path?
Before starting the configuration of the TLS for TSIG described here : https://help.tableau.com/current/server/en-us/server_tsig_configure_tls.htm
Please apply the procedure below in order to concatenate all certificates:
httpd.conf.stub
as part of setting up the HK TLS configuration). This is the error message you will have in the tabadminagent logs if there is a certificate issue:
2022-08-10 10:42:05.641 +0000 ExternalStatusRequestDispatcher-0 : INFO com.tableausoftware.tabadmin.agent.status.ExternalStatusStore - Posting external status update DOWN for gateway: {"statuses":[{"independentGateway":{"id":"EC2AMAZ-UV5C115","host":"10.108.29.122","port":21319,"protocol":"https","authsecret":"******"},"code":"ERROR","message":"javax.net.ssl.SSLHandshakeException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target"}]}
What Is a Certification Path?
Certification Path: Also called Certificate Chain. An ordered list of certificates where the subject entity of one certificate is identical to the issuing entity of the next certificate.
A certification path can also be defined as an ordered list of certificates where the issuing entity of one certificate can be identified as the subject entity of the previous certificate. But the first certificate has to be a special one, because there is no previous certificate to identify the issuing entity. The first certificate must be a self-signed certificate, where the issuing entity is the same as the subject entity.
For example, the following diagram shows you a certification path:
Certificate 1 Issuer: Herong Yang Subject: Herong Yang Certificate 2 Issuer: Herong Yang Subject: John Smith Certificate 3 Issuer: John Smith Subject: Bill White
OpenSSL offers a nice tool, the "verify" command, to validate a certification path. Here is the syntax of the "verify" command:
verify -CAfile first.crt -untrusted all_middle.crt last.crt