Workato · On-prem agent

SFTP UnknownHostException through the on-prem agent

Short answer

This error means the Hostname field of the Workato SFTP connection contains extra whitespace, so the on-prem agent cannot resolve the host. Remove the extra spaces from the Hostname and reconnect.

VerifiedLast verified

01Error text

Workato error
Error processing SFTP request java.lang.RuntimeException: com.jcraft.jsch.JSchException: java.net.UnknownHostException: XX.XX.XX.XX

02Likely causes

  • There is extra whitespace in the Hostname field of the Workato connection.
  • The agent log shows more than one space between the colon and the IP address. SFTP works from the command line on the same machine.
  • The agent log can also show "status":401 with "status_message":"Unauthorized".

03How to fix it

  1. Open the SFTP connection in Workato.
  2. Remove any leading, trailing or extra whitespace from the Hostname field.
  3. Reconnect and rerun the job.

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.