Proxy Setup for Enterprise Nodes

  • 2 minute(s) read
Prev Next

Catchpoint proxy settings are configured directly within the Enterprise Node itself. It does not honor any other proxy settings. Enterprise Nodes allow SOCKS and HTTP proxy types, and requires an IP and PORT for proxy setup.

Proxy Configuration

You can set up a proxy on a Node Instance using the proxy command in the Catchpoint CLI. Catchpoint supports Direct, Static & PAC proxies, and each of them can be set up using a single step or multiple steps.

To specify the type of proxy, use the --type or -t argument. A proxy can be DIRECT, STATIC or PAC.

To set the proxy location, the format depends on the proxy type:

  • DIRECT: this proxy type does not require location options.
  • STATIC: supply '--host domain.com:1234' for Proxy Location. For --host, use hostname or IPv4 IP address or IPv6 IP address along with the port number.
    • `$ catchpoint proxy --type STATIC --host=your.proxy.url:1234
    • `$ catchpoint proxy -t STATIC -h your.proxy.url:1234'
  • PAC - Supply the URL where PAC file using --host
    • $ catchpoint proxy --host=http://pac_file_url/file.p
      -OR-
    • $ catchpoint proxy -h http://pac_file_url/file.p

You may also have an authenticated proxy setup. You can pass the credentials as arguments, and passwords will be encrypted.

Proxy server Username when using a Static Proxy:
$ catchpoint proxy --user={proxyusername}
-OR-
$ catchpoint proxy -u {proxyusername}

Proxy server password when using a Static Proxy.
The password must immediately follow -p without a space. If no password is provided you will be prompted for the password.
$ catchpoint proxy --password={proxypassword}
-OR-
$ catchpoint proxy -p{proxypassword}

There may be situations where you need to bypass some hosts. To add those hosts, you can use the -B (case sensitive) option. If there are multiple URLs that you wish to bypass, you can specify them and separate with semicolons ( ;).

Note that you may also want to bypass local URLs, which is done by specifying -b. For example:
$ catchpoint proxy -t STATIC -h your.proxy.host.url:1234 -b -B "url.com;another.url.com;*.domain.com"

To reset the proxy, use the DIRECT option.
$ catchpoint proxy --type=DIRECT
-OR-
$ catchpoint proxy -t DIRECT

Some more examples using all parameters together:
$ catchpoint proxy --type=PAC --host=http://pac_file_url/file.pac

$ catchpoint proxy -t PAC -h http://pac_file_url/file.pac

$ catchpoint proxy --type=STATIC --host=your.proxy.url:1234 --user={proxyusername} --password={proxypassword}

$ catchpoint proxy -t STATIC -h your.proxy.url:1234 -u {proxyusername} -p{proxypassword}

(Note: There is a space in between the -u flag and the username but not in between -p flag and the password)

$ catchpoint proxy -t STATIC -h your.proxy.host.url:1234 -b -B "url.com;another.url.com;*.domain.com"

Note:

  • The --port option has been removed in Aurora to prevent confusion when setting up a proxy.
  • Instead of using --port, you should include the port directly in the proxy URL using : (colon) notation, like this: --host domain.com:1234
  • This change does not break compatibility because the port could already be set this way before Aurora.
  • Admin privileges (sudo) are required since Snow Leopard.

For more information about Catchpoint Enterprise Nodes, please go to https://docs.catchpoint.com/docs/enterprise-nodes