# On-prem connections issues

This guide explains issues you may encounter with on-prem connections. This includes issues with requests sent from the environment where the agent is installed to connection profiles and cloud profiles.

# SFTP on-prem connection error

A connection to SFTP on-prem connection fails when there is whitespace in the Hostname field in your Workato connection.

You see the following error when you try to establish an SFTP on-prem connection:

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

You may also see the following error when you attempt to connect to on-prem logs:

"status":401,..."status_message":"Unauthorized"

However, you are able to connect to SFTP manually using the command line tool.

This happens when there are additional whitespaces in the Java logs. For example, there is typically one whitespace between : and the IP address. The connection fails if there is more than one whitespace. Review your request and remove extra whitespaces to resolve this error. Refer to Connections using an on-prem agent for more information


Last updated: 8/21/2025, 9:16:21 PM