Skip to main content
Red Canary help

Proxy Configuration

  • Updated .

Note: This feature is available in v0.4.8+

Background

The agent supports the use of an HTTP Connect proxy. This can be configured through the config.json file.

Precedence

The agent utilizes the following precedence order when determining what proxy settings to utilize, if any at all.

  1. config.json's http_proxy field
  2. config.json's env_http_proxy_disabled field
  3. HTTPS_PROXY & HTTP_PROXY environment variables

See additional details below.

Configuration

To explicitly define proxy settings via config.json:

"http_proxy": "https://HOST:PORT",

This overrides any proxy settings configured via the HTTPS_PROXY or HTTP_PROXY environment variables on the endpoint. Ensure `config.json` is valid JSON (the comma at the end may not be needed).

 

To opt out of the use of proxy settings already defined via endpoint environment variables HTTPS_PROXY and/or HTTP_PROXY

"env_http_proxy_disabled": true,

 The default value for this is false. When configured as false, this means the agent will utilize the HTTPS_PROXY or HTTP_PROXY environment variable for proxy settings, if set. Ensure `config.json` is valid JSON (the comma at the end may not be needed).