Enabling Proxy for Private Agents

Introduction

If your network is using a proxy to access the Internet, you may be required to enter proxy settings into locally-installed Jitterbit product 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.

Accessing Proxy Settings in Your Browser

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.

Internet Explorer

• Launch Internet Explorer.
• In the upper right corner of the Internet Explorer browser, click on the Tools icon

• Click on the Internet Options in the drop-down menu.
  • Click on the Connections tab.
  • Dial-Up or VPN: Click on the Settings button.
  • Local Area Network: Click on the LAN Settings button.

• The Proxy Settings pop-up window will display.
  • Automatically detect settings checkbox: If this option is selected, contact your network administrator or third-party vendor that set up the Internet access to request the proxy settings.  Enter these settings into the Jitterbit Proxy Settings.
  • Use Automatic configuration script checkbox:  If this option is selected, contact your network administrator or third-party vendor that set up the Internet access to request the proxy settings.  Enter these settings into the Jitterbit Proxy Settings.
  • Proxy Server checkbox: If this option is selected, the Address and Port values will be populated. Enter these settings into the Jitterbit Proxy Settings.

Mozilla Firefox

• Launch Mozilla Firefox.
• In the upper right corner of the Firefox browser, Click on the Open Menu icon

• Click on Options in the drop down menu.

• Click on Advanced in the side-bar menu.

• Click on the Network tab.
  • In the Connections section, Click on the Settings button.

• The Connection Settings pop-up window displays.
  • No Proxy:  If selected, you will not need to enter proxy settings into Jitterbit Studio or Cloud Data Loader.
  • Auto Detect Proxy Settings: If selected, you will need to contact your network administrator or third-party vendor that set up the Internet access to request the proxy settings. Enter the settings into the Jitterbit Proxy Settings.
  • Use System Proxy Settings:  If selected, you will need to contact your network administrator or third-party vendor that set up the Internet access to request the proxy settings. Enter the settings into the Jitterbit Proxy Settings.
  • Manual Proxy Configurations: If selected, the HTTP Proxy and Port values will be populated. Enter these settings into the Jitterbit Proxy Settings.

Google Chrome

• Launch Google Chrome.
• In the upper right corner of the Google browser, Click on the Customize Google Chrome icon

• Click on Settings in the drop-down menu.
  
• Scroll to the bottom of the page and Click on the Show advanced settings link.
  • In the Network section, Click on the Change proxy settings button.
• The Internet Properties pop-up window displays.
• Click on the Connections tab.
  • Dial-Up or VPN: Click on the Settings button.
  • Local Area Network: Click on the LAN Settings button.

• The Proxy Settings pop-up window will display.
  • Automatically detect settings checkbox: If this option is selected, contact your network administrator or third-party vendor that set up the Internet access to request proxy settings. Enter the proxy settings into the Jitterbit Proxy Settings.
  • Use Automatic configuration script checkbox:  If this option is selected, contact your network administrator or third-party vendor that set up the Internet access to request proxy settings.  Enter the proxy settings into the Jitterbit Proxy Settings.
  • Proxy Server checkbox: If this option is selected, the Address and Port values will be populated. Enter these settings into the Jitterbit Proxy Settings.

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:

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

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

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

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

> jitterbitutils --set-http-proxy-exceptions <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:
    

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.