Skip to main content

Who is this article for?
Find your product plan in the Code42 console on the Account menu.

Incydr Professional, Enterprise, and Gov F2
Incydr Basic, Advanced, and Gov F1
Other product plans

Incydr Professional and Enterprise, no.

Incydr Basic and Advanced, yes.

CrashPlan Cloud, yes.

Other product plans, yes.

CrashPlan for Small Business, no.

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

Other available versions:

Version 5 | Version 4

HOME
GETTING STARTED
RELEASE NOTES
FAQs
APIs
SYSTEM STATUS
Code42 Support

Connect to Code42 cloud destinations from a proxy server

Who is this article for?
Find your product plan in the Code42 console on the Account menu.

Incydr Professional, Enterprise, and Gov F2
Incydr Basic, Advanced, and Gov F1
Other product plans

Incydr Professional and Enterprise, no.

Incydr Basic and Advanced, yes.

CrashPlan Cloud, yes.

Other product plans, yes.

CrashPlan for Small Business, no.

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

Other available versions:

Version 5 | Version 4

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 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.

DIRECT proxy requirements
  • Code42 app version 8.7.1 and later automatically applies the DIRECT connection option if none is explicitly defined in the PAC file.
  • In Code42 app versions 6.0 - 8.7.0, the PAC file must include the DIRECT option. If not, the Code42 app does not attempt a direct connection if the proxy fails. After adding the "DIRECT" option to your PAC file, 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 using one of the following methods: 

    • Version 8.6 and later: Double-click the Code42 logo in the upper-left corner.
    • All versions: Enter the keyboard shortcut for your operating system:
      • Windows: Ctrl+Shift+C
      • Mac: Option+Command+C
      • Linux: Ctrl+Shift+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.