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

Workato error
AgentNonRecoverableException: Error connecting to the gateway sg3.workato.com:443

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

  1. 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.
  2. If the agent must go through a proxy, configure the proxy: section in config.yml.
  3. Check name resolution with nslookup sg3.workato.com.
  4. 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 is HTTP/1.1 200 OK with a JSON body.

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.