Workato · On-prem agent
PKIX path building failed
PKIX path building failed means the Workato on-prem agent cannot validate the SSL certificate chain of the host it is connecting to. Trust the missing certificates, or stop a proxy or SSL inspection tool from intercepting the agent's traffic to the Workato gateways.
VerifiedLast verified
01Error text
javax.net.ssl.SSLHandshakeException: PKIX path building failed:
sun.security.provider.certpath.SunCertPathBuilderException:
unable to find valid certification path to requested target02Likely causes
- Intermediate or root certificates are missing.
- SSL inspection or DLP software is modifying certificates.
- A proxy or firewall is intercepting HTTPS traffic.
03How to fix it
- Read the agent log to see which host failed. A gateway failure looks like
com.workato.agent.net.AgentNonRecoverableException: Error connecting to the gateway sg3.workato.com:443. - If the failing host is one of your own systems, trust its certificates in the connection configuration, in
config.ymlor in the OPA trust store. - If the failing host is a Workato gateway, create exceptions in the SSL inspection tool for the Workato gateways
sg3.workato.comandsg4.workato.comon port 443. - If the agent must go through a proxy, configure the
proxy:section inconfig.yml. - Restart the agent and check the log again.
iNotes
The docs note that adding the inspection tool's CA to the OPA trust store does not resolve gateway errors. Repeated agent connected and disconnected log entries often indicate unstable network connectivity.
04Official documentation
→Related errors
- Unable to create directory [work] to use as the base directoryThis Workato on-prem agent startup error means the account running the agent does not have permission to create the work directory. Run the agent as an administrator, or give the service user full access to the install path.
- Certificate not foundCertificate not found appears when a Workato on-prem agent is activated with the Windows Certificate Store selected and the agent cannot read the store. Store the key and certificate in the file system, or update the permissions on the certificate store.
- Unable to load folder structureUnable to load folder structure means the Workato on-prem agent host cannot reliably connect to the target folder used by the on-prem files connector. Remove duplicate agent instances, check the network path and confirm the agent's service account can access the folder.
Test every fix in a non-production environment before you apply it to production. See how entries are verified.
More for Workato work:Open Workato jobsWorkato rates and salariesHire a senior Workato developer