Jitterbit Success Central will be undergoing system maintenance and may be inaccessible during this time: November 5 at 11 to 3 pm PST; 5 November at 19:00 to 23:00 UTC; 6 November at 6 to 10 am AEDT.

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Next »

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, including Design Studio, Data Loader, or a Local Agent.

By using a proxy, computers on a network do not connect directly with the Internet. 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 in your browser settings or you may need to contact the network administrator or third-party vendor that set up the Internet access to request the correct settings.

Access Proxy Settings in Your Browser 

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 Design Studio or Data Loader

  • Launch Design Studio or Data Loader:


  • Click the  button. 
  • The Proxy Settings dialog displays:
    Jitterbit Proxy Settings
  • Host: Enter the Address or HTTP Proxy listed in your browser proxy settings, which will be in a format such as 192.001.001.001.
  • Port: Enter the Port listed for your proxy settings.
  • User: Enter the username if used to access your proxy server. If unknown or if the username is automatically entered, contact your network administrator or third-party vendor that set up the internet access for your network to request the username.
  • Password: Enter the password if one is used to access your proxy server. If unknown or if the password is automatically entered, contact your network administrator or third-party vendor that set up the internet access for your network to request the password.
  • NTLM Domain: Enter a Domain name if you have been given one.
  • Click the OK button to save the proxy settings.

Enter Proxy Settings in Jitterbit Local Agent

The Jitterbit Harmony Local 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 Local 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:
       

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 Harmony platform after configuration:

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

where:

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

On This Page

Last updated:  May 23, 2018

  • No labels