Introduction

Enter Proxy Settings in Jitterbit Private Agent

The Jitterbit Harmony Private Agent communicates with the Harmony Cloud securely using the HTTPS protocol. You can configure the agent to communicate using a proxy server. Both standard HTTPS proxy and NTLM proxy are supported. 

Windows

Jitterbit has a built-in utility located in the agent installation that is accessible either using a command line or through a GUI. The utility is located in the [jitterbit_home]\bin directory. 

  • Access the utility from a command line: 
    • Start a command prompt and navigate to the directory [jitterbit_home]\bin, substituting for[jitterbit_home] the directory where the Jitterbit Private Agent is installed on your system. 
    • These commands (of the form jitterbitutils [options]) can be accessed to set the proxy settings:

Action

Command Form and Example

Set http proxy host name (with optional port)

> jitterbitutils --set-http-proxy-host <hostname>[:<port>]

Set the username for proxy server authentication

> jitterbitutils --set-http-proxy-username <user name>

Set the password for proxy server authentication

> jitterbitutils --set-http-proxy-pwd <password>

Set NTLM domain for proxy server authentication

> jitterbitutils --set-http-proxy-domain <NTLM domain>

Set exceptions for the proxy server. Comma-separated list of host names for which the proxy configuration should not be used. Wild-cards (* and ?) are supported.

Can't be used together with the inclusions option.

> jitterbitutils --set-http-proxy-exceptions <exceptions>

Set inclusions for the proxy server. Comma-separated list of host names for which the proxy configuration should be used. Wild-cards (* and ?) are supported.

Can't be used together with the exceptions option.

> jitterbitutils --set-http-proxy-inclusions <inclusions>
  • Access the utility using the GUI: 
    • From the Windows Start Menu, access the Configure Jitterbit menu item:
    • This opens a GUI where you can set the appropriate values; see the table above for the command line for details:

After changing the configuration, restart the Private Agent if it is currently running.

Linux

Use this command to configure your agent if you are behind a proxy; these proxy settings are saved and used by the agent when communicating with the Jitterbit Harmony platform after configuration:

$ /opt/jitterbit/jitterbit-config --xh=<host> --xu=<username> --xp=<password> --xn=<domain>

where:

  • <host> is in the form <hostname>:<port number>
  • <username> and <password> are required if the proxy server requires authorization
  • <domain> is required when using an NTLM proxy

After changing the configuration, restart the Private Agent if it is currently running.