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:
Start the inSync Client.
On the navigation pane, click Settings.
Click the Network tab.
Click OpenProxy Settings...
Select the Enable Proxy Settings checkboxto configure the proxy settings.
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.Click Save.
Configure proxy using system proxy settings
To configure proxy using system proxy settings:
Start the inSync Client.
On the navigation pane, click Settings.
Click the Network tab.
Click OpenProxy Settings...
Select the Enable Proxy Settings check to configure the proxy settings.
In the Configure Proxy Server Using list, click System Proxy Settings.
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.
In the Username box, enter the proxy username.
In the Password box, enter the proxy password.
Click Save.
Configure proxy using proxy server details
To configure proxy using system proxy settings:
Start the inSync Client.
On the navigation pane, click Settings.
Click the Network tab.
Click OpenProxy Settings...
Select the Enable Proxy Settings check box to configure the proxy settings.
In the Configure Proxy Server Using list, click Proxy Server Details.
In the Proxy Server IP Address box, enter the IP address of the proxy server.
In the Port box, enter the port number for the proxy server.
In the Proxy Type list, click the proxy type that your organization is using.
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.
In the Username box, enter the proxy username.
In the Password box, enter the proxy password.
Click Save.
Configure proxy settings using PAC file
Start the inSync Client.
On the navigation pane, click Settings.
Click the Network tab.
Click OpenProxy Settings...
Select the Enable Proxy Settings check box to configure the proxy settings.
In the Configure Proxy Server Using list, click Configuration File.
If the PAC file is available on your device, click Choose file to select the file.
In the Proxy Type list, select the proxy type that your organization is using.
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.
In the Username box, enter the proxy username.
In the Password box, enter the proxy password.
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:
Basic pac file: It will return the proxy for all types of connections
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
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.
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
Start the inSync Client.
On the navigation pane, click Settings.
Click the Network tab.
Click OpenProxy Settings...
Select the Enable Proxy Settings check box to configure the proxy settings.
In the Configure Proxy Server Using list, click Configuration File URL.
If the PAC file is available on a WPAD URL, in the WPAD / PAC file URL, enter the URL in the text box.
In the Proxy Type list, select the proxy type that your organization is using.
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.
In the Username box, enter the proxy username.
In the Password box, enter the proxy password.
Click Save.
Configure automatic detection of proxy
To configure proxy using automatic detection of proxy settings
Start the inSync Client.
On the navigation pane, click Settings.
Click the Network tab.
Click OpenProxy Settings...
Select the Enable Proxy Settings check box to configure the proxy settings.
In the Configure Proxy Server Using list, click Automatically Detect Settings.
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.
Alternatively, select the Detect using DHCP (252 option) checkbox to allow inSync to detect the proxy settings using DHCP.
If the inSync Client requires authentication, select the Requires Authentication checkbox. Do not select this checkbox if authentication is not required.
In the Username box, enter the proxy username.
In the Password box, enter the proxy password.
Click Save.