View Jitterbit Developer Portal
Introduction
If your network is using a proxy to access the Internet, you may be required to enter proxy settings into locally installed Jitterbit applications, such as Design Studio, Data Loader, or a Private Agent. By using a proxy, computers on a network do not connect directly with the Internet. For example, when you request a webpage in your browser, the browser forwards the request to the proxy and the proxy actually connects to the website. Your proxy receives the responses sent by the website and returns the responses to your browser. The proxy may be embedded in your router or it may be a separate server. You may be able to use the proxy settings found in your browser settings for Jitterbit applications or you may need to contact the network administrator or third-party vendor that set up the Internet access to request the correct settings. These instructions change depending on the operating system and exact browser version that you are using. Other operating systems and versions (such as macOS) use a central system preference that will have the required information.Accessing Proxy Settings in Your Browser
Internet Explorer 11
Mozilla Firefox
Google Chrome
Entering Proxy Settings in a 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.
- Start a command prompt and navigate to the directory
- These commands (of the form
jitterbitutils [options]
) can be accessed to set the proxy settings:
- These commands (of the form
Action | Command Form and Example |
---|---|
Displays (prints to the command line) the current HTTP proxy configuration. | > jitterbitutils --print-http-proxy-configuration |
Disables any HTTP proxy configuration. | > jitterbitutils --disable-http-proxy |
Sets the HTTP proxy host name (with optional port). | > jitterbitutils --set-http-proxy-host <hostname>[:<port>] |
Sets the username for proxy server authentication. | > jitterbitutils --set-http-proxy-username <user name> |
Sets the password for proxy server authentication. | > jitterbitutils --set-http-proxy-pwd <password> |
Sets the NTLM domain for proxy server authentication. | > jitterbitutils --set-http-proxy-domain <NTLM domain> |
Sets the exceptions for the proxy server, a comma-separated list of host names for which the proxy configuration should not be used. Wildcards (* and ?) are supported. This cannot be used with the inclusions ( | > jitterbitutils --set-http-proxy-exceptions <exceptions> |
Sets the inclusions for the proxy server, a comma-separated list of host names for which the proxy configuration should be used. Wildcards (* and ?) are supported. This cannot be used with the exceptions ( | > 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:
- From the Windows Start Menu, access the Configure Jitterbit menu item:
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/bin/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
For additional documentation, use the --help
option:
$ /opt/jitterbit/bin/jitterbit-config --help
After changing the configuration, restart the Private Agent if it is currently running.