Workato · On-prem agent
AgentNonRecoverableException: Error connecting to the gateway
Short answer
This on-prem agent error means the agent cannot complete a trusted HTTPS connection to the Workato gateway. The usual cause is SSL inspection, a proxy or a firewall intercepting the connection, so create an exception for the Workato gateways or configure the proxy in config.yml.
VerifiedLast verified
01Error text
AgentNonRecoverableException: Error connecting to the gateway sg3.workato.com:44302Likely causes
- Missing intermediate or root certificates.
- SSL inspection or DLP tools replace certificates.
- A proxy or firewall intercepts HTTPS.
- Repeated "agent connected" and "disconnected" log entries indicate unstable connectivity.
03How to fix it
- If your network uses SSL inspection, create exceptions for the Workato gateways. Adding the inspection CA to the trust store does not fix gateway errors.
- If the agent must go through a proxy, configure the
proxy:section inconfig.yml. - Check name resolution with
nslookup sg3.workato.com. - Check connectivity with
curl -k -vvv -GET --no-alpn --key conf/cert.key --cert conf/cert.pem https://sg3.workato.com/gateway/ping. The expected reply isHTTP/1.1 200 OKwith a JSON body.
04Official documentation
→Related errors
- PKIX path building failedPKIX 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.
- 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.
- Failed to start SDK extension. 520 Connection FailedThis error means the SDK handshake between an on-prem extension and the Workato platform failed during startup. Build the extension with JDK 8 and make sure its post() URLs use the correct port.
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