When running any of the SeaLights agents , you may come across an error related to PKIx/SSL libraries.
For example:
javax.net.ssl.SSLHandshakeException: Remote host closed connection during handshake …
javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed …
These errors could point to an issue with creating a secure connection to our server due to a misconfigured or missing certificate. The following guide will explain the steps required to add the SeaLights certificate to your local Java keystore
Instructions
Retrieve the SeaLights certificate from your dashboard:
While logged in, click on the “Lock” icon to the left of your address bar.
Export the certificate to your local machine:
On Windows: In the Details tab, click on Copy to File and ensure the exported certificate is in .cer format
On Mac: Dragging the certificate icon to your desktop will export it
2. Add the certificate to the Java keystore:
keytool -import -alias your-alias -keystore cacerts -file certificate.der
(Optional) Convert the .cer certificate file to .pem format:
In some cases, it may be necessary to convert the exported certificate to PEM format, so that it could be loaded into the JKS (Java Key Store). To do so, use the following command:
openssl x509 -inform der -in certificate.cer -out certificate.pem
The SeaLights certificate should be added to any Java keystore that communicates with SeaLights.