Workato · On-prem agent

PKIX path building failed

Short answer

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

Workato error
javax.net.ssl.SSLHandshakeException: PKIX path building failed:
sun.security.provider.certpath.SunCertPathBuilderException:
unable to find valid certification path to requested target

02Likely 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

  1. 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.
  2. If the failing host is one of your own systems, trust its certificates in the connection configuration, in config.yml or in the OPA trust store.
  3. If the failing host is a Workato gateway, create exceptions in the SSL inspection tool for the Workato gateways sg3.workato.com and sg4.workato.com on port 443.
  4. If the agent must go through a proxy, configure the proxy: section in config.yml.
  5. 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

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

The iPaaS Brief

Subscribe to The iPaaS Brief.

The iPaaS newsletter for the people who run integrations. From iPaaS Group.

Free. You finish on theipaasbrief.com and confirm by email.