Skip to main content

Who is this article for?

Code42 for Enterprise
CrashPlan for Small Business

Code42 for Enterprise, yes.

CrashPlan for Small Business, yes.

This article applies to app versions 6, 7, and 8.

Other available versions:

Version 5 | Version 4Link: What version am I on?

HOME
GETTING STARTED
RELEASE NOTES
FAQS
SYSTEM STATUS
Code42 Support

Connect to Code42 cloud destinations from a proxy server

Who is this article for?

Code42 for Enterprise
CrashPlan for Small Business

Code42 for Enterprise, yes.

CrashPlan for Small Business, yes.

This article applies to app versions 6, 7, and 8.

Other available versions:

Version 5 | Version 4Link: What version am I on?

Overview

To connect to a destination from behind a proxy server, you must configure proxy server settings. If you are able to make an initial connection to the destination without connecting through a proxy, configure your proxy settings from the Code42 app. However, if you can only connect through a proxy, then you must configure proxy settings manually. Both processes are described below.

Considerations

  • This article assumes you have permission to manage your proxy settings. Your administrator may prevent changes to your proxy settings.
  • The Code42 app does not support SOCKS-only HTTP proxies.

Recommended solution

If you are able to make an initial connection to the destination without connecting through a proxy, configure proxy settings in the Code42 app:

  1. Open the Code42 app.
  2. Navigate to Device Preferences:
  • Code42 app version 6.8.3 and later: Select settings button Settings.
  • Code42 app version 6.8.2 and earlier: 
    1. Click Details.
    2. Select the arrow next to your device name.
    3. Choose Device preferences.
      device preferences
  1. Select Network.
  2. Next to Proxy, click Change.
  3. Select Enable proxy.
  4. If your proxy connection requires a proxy auto-config (PAC) file, select Manual then enter the file URL in PAC URL.
  5. Click Save.

The Code42 app can now detect your proxy settings and connect to the destination, which allows you to begin your backup and modify your settings.

Proxy auto-config (PAC) files

A proxy auto-config (PAC) file defines what proxies the Code42 app should use to connect to its destinations. Use of a PAC file is enabled by a Code42 administrator.

The PAC file specifies whether the Code42 app should connect through a specific proxy, connect directly, or a combination depending on the desired order of failover. The PAC file is JavaScript and implements the FindProxyForURL method that returns the proxies to use for a specified URL and host. The following is an example of a PAC file:

function FindProxyForURL(url, host)
{
return "PROXY fastproxy.example.com:8080; proxy.example.com:8080; DIRECT";
}

The example PAC file directs a Code42 app to first try fastproxy.example.com; if that fails, try proxy.example.com; if that fails, try a direct connection. All proxy servers defined in the PAC file must have a port specified.

Upgrading to 6.0
As of Code42 for Enterprise version 6.0, the PAC file must include the "DIRECT" option. If not, the Code42 app does not attempt a direct connection after the proxies fail. Therefore, if you are upgrading to 6.0, add "DIRECT" to your PAC file and then issue the proxy refresh command in the Code42 app's command-line interface.

Alternative solution

Code42 for Enterprise only

Work with your Code42 administrator to set the proxy URL in a deployment policy.

Confirm your connection

To confirm that the client is able to connect to the server using the proxy:

  1. Open the Code42 app.
  2. Open Code42 Commands by entering the keyboard shortcut for your operating system:
    • Windows: Ctrl+Shift+C
    • Mac: Option+Command+C
  3. Enter the following command-line command using the server and port for the destination:
    proxy test server:port
    
    • For example:
      proxy test master-server.example.com:443

This will also list the proxies returned by the PAC file that the Code42 app is using.