View Jitterbit Developer Portal
- Created by Lisa Brown, last modified on Aug 29, 2018
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
.
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.
- 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 |
---|---|
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:
- 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/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.
Last updated: Aug 29, 2018
- No labels