Skip to main content
Configure proxy settings on the inSync client
Updated yesterday

Applicable to Client versions -

Windows - v7.1.0 & above | macOS - v6.5.1, 7.1.0 & above | Linux - v5.9.x & above

Overview

If your administrator provides you with the required permissions, you can configure proxy server details on the inSync Client. For example:

  • If you relocate to a different business unit from where inSync Client cannot communicate with the inSync Server directly.

  • If your organization has deployed proxy servers after the inSync Clients are activated.

If your administrator does not give you the required permissions to configure proxy settings for the inSync Client, then you cannot modify proxy settings.

Before you begin

Before you configure the proxy details, contact the administrator for the following information about your proxy server:

  • Proxy server details. You might need the IP address and port number of the proxy server, or the PAC file, or the WPAD URL of the PAC file.

  • Authentication details for the proxy server.

  • Proxy type. inSync supports SOCKS4, SOCKS5, and HTTP.

Configure proxy settings for the inSync Client

To configure proxy settings:

  1. Start the inSync Client.

  2. On the navigation pane, click Settings.

  3. Click the Network tab.

  4. Click OpenProxy Settings...

    configure proxy settings_mac.png
  5. Select the Enable Proxy Settings checkboxto configure the proxy settings.

  6. If you want to use system proxy settings, see Configure proxy using system proxy settings.
    If you want to use proxy server details, see Configure proxy using proxy server details.
    If you to use PAC file, see Configure proxy settings using PAC file.
    If you to use PAC file URL, see Configure proxy settings using PAC file URL.
    If you want inSync Client to automatically detect proxy settings, see Configure automatic detection of proxy.

  7. Click Save.

Configure proxy using system proxy settings

To configure proxy using system proxy settings:

  1. Start the inSync Client.

  2. On the navigation pane, click Settings.

  3. Click the Network tab.

  4. Click OpenProxy Settings...

  5. Select the Enable Proxy Settings check to configure the proxy settings.

  6. In the Configure Proxy Server Using list, click System Proxy Settings.

    proxy settings_use system settings 1.png
  7. If the inSync Client requires authentication, select the Requires Authentication checkbox. Do not select this checkbox if authentication is not required or if authentication is through your AD credentials.

  8. In the Username box, enter the proxy username.

  9. In the Password box, enter the proxy password.

  10. Click Save.

Configure proxy using proxy server details

To configure proxy using system proxy settings:

  1. Start the inSync Client.

  2. On the navigation pane, click Settings.

  3. Click the Network tab.

  4. Click OpenProxy Settings...

  5. Select the Enable Proxy Settings check box to configure the proxy settings.

  6. In the Configure Proxy Server Using list, click Proxy Server Details.

    proxy settings_use server settings .png

  7. In the Proxy Server IP Address box, enter the IP address of the proxy server.

  8. In the Port box, enter the port number for the proxy server.

  9. In the Proxy Type list, click the proxy type that your organization is using.

  10. If the inSync Client requires authentication, select the Requires Authentication checkbox. Do not select this checkbox if authentication is not required or if authentication is through your AD credentials.

  11. In the Username box, enter the proxy username.

  12. In the Password box, enter the proxy password.

  13. Click Save.

Configure proxy settings using PAC file

  1. Start the inSync Client.

  2. On the navigation pane, click Settings.

  3. Click the Network tab.

  4. Click OpenProxy Settings...

  5. Select the Enable Proxy Settings check box to configure the proxy settings.

  6. In the Configure Proxy Server Using list, click Configuration File.

    proxy settings_use config file.png

  7. If the PAC file is available on your device, click Choose file to select the file.

  8. In the Proxy Type list, select the proxy type that your organization is using.

  9. If the inSync Client requires authentication, select the Requires Authentication checkbox. Do not select this checkbox if authentication is not required or if authentication is through your AD credentials.

  10. In the Username box, enter the proxy username.

  11. In the Password box, enter the proxy password.

  12. Click Save.

Recommended Pac file format for inSync Client

Proxy auto-config

A proxy auto-config (PAC) file defines how web browsers and other user agents can automatically choose the appropriate proxy server (access method) for fetching a given URL.

A PAC file contains a JavaScript function FindProxyForURL(url, host). This function returns a string with one or more access method specifications. These specifications cause the user agent to use a particular proxy server or to connect directly.

Standard PAC File for inSync Client

By convention, the PAC file is normally named proxy.pac. The WPAD standard uses wpad.dat. The Pac file is expected to contain at least one function:

  • FindProxyForURL (URL, host), with two arguments and return value in a specific format:

  • URL: object

  • host: Host name derived from that URL. Syntactically it is the same string as between :// and the first: or / after that

  • return "...": String of signatures in the following format
    Example:

    returnValue= type host,":",port,[{ ";",returnValue }];

    type= "DIRECT" | "PROXY" | "SOCKS" | "HTTP" | "HTTPS" | "SOCKS4" | "SOCKS5"
    host= UTF16String (* ECMA262-compatible UTF16 string *)
    port= UTF16String (* Digits *)

A standard template of the pac file for inSync client:

  1. Basic pac file: It will return the proxy for all types of connections

  2. Pac file with if else condition around dnsDomainIs(), here *.druva.com connection will go directly, all other connections will go via proxy.


    dnsDomainIs(host, domain): Provides true value only if the domain of the hostname matches.

    host: Hostname from the URL.

    domain: Domain name to test the hostname against.

    Examples:

    dnsDomainIs("www.mozilla.org", ".mozilla.org") // true

    dnsDomainIs("www", ".mozilla.org") // false

  3. Pac file with if else condition around shExpMatch(), here *.druva.com connection will go via proxy. In this it will first try proxies in the order of example1, example2 then Example 3.

  4. Pac file with if else condition around shExpMatch(), here *.druva.com connection will go directly. In this, it will only try direct connection.


    📝 Note:
    If DIRECT is added to the list of proxies, inSync Client always gives preference to the Direct method and ignores all proxy configurations.
    Do not use the DIRECT method if you want to use proxy always.


shExpMatch(str, shexp): provides true value if the string matches the specified shell glob expression.

str: is any string to compare (e.g. the URL, or the hostname).

shexp: is a shell expression to compare against.

Examples:

shExpMatch("http://home.netscape.com/people/ari/index.html", "*/ari/*"); // returns true

shExpMatch("http://home.netscape.com/people/montulli/index.html", "*/ari/*"); // returns false

Configure proxy settings using PAC file URL

  1. Start the inSync Client.

  2. On the navigation pane, click Settings.

  3. Click the Network tab.

  4. Click OpenProxy Settings...

  5. Select the Enable Proxy Settings check box to configure the proxy settings.

  6. In the Configure Proxy Server Using list, click Configuration File URL.

    proxy settings_use config file url.png

  7. If the PAC file is available on a WPAD URL, in the WPAD / PAC file URL, enter the URL in the text box.

  8. In the Proxy Type list, select the proxy type that your organization is using.

  9. If the inSync Client requires authentication, select the Requires Authentication checkbox. Do not select this checkbox if authentication is not required or if authentication is through your AD credentials.

  10. In the Username box, enter the proxy username.

  11. In the Password box, enter the proxy password.

  12. Click Save.

Configure automatic detection of proxy

To configure proxy using automatic detection of proxy settings

  1. Start the inSync Client.

  2. On the navigation pane, click Settings.

  3. Click the Network tab.

  4. Click OpenProxy Settings...

  5. Select the Enable Proxy Settings check box to configure the proxy settings.

  6. In the Configure Proxy Server Using list, click Automatically Detect Settings.

    Proxy1.png
  7. In the Proxy Type list, click the proxy type that your organization is using.


    ❗ Important

    inSync, by-default, detects the proxy settings using the DNS.


  8. Alternatively, select the Detect using DHCP (252 option) checkbox to allow inSync to detect the proxy settings using DHCP.

    DHCP.png

  9. If the inSync Client requires authentication, select the Requires Authentication checkbox. Do not select this checkbox if authentication is not required.

  10. In the Username box, enter the proxy username.

  11. In the Password box, enter the proxy password.

  12. Click Save.

Did this answer your question?