How to Set a Proxy for Linux Sensor Post Install
search cancel

How to Set a Proxy for Linux Sensor Post Install

book

Article ID: 288412

calendar_today

Updated On:

Products

Carbon Black Cloud Endpoint Standard (formerly Cb Defense) Carbon Black Cloud Enterprise EDR (formerly Cb Threathunter)

Issue/Introduction

Change the proxy configuration for a Linux sensor post installation.

Environment

  • Carbon Black Cloud Sensor: 2.11.1 and higher
  • Linux: All Supported Versions

Resolution

  1. Create a separate configuration directory /etc/systemd/system/cbagentd.service.d
  2. Create a file /etc/systemd/system/cbagentd.service.d/custom.conf with the following contents:
    [Service]
    EnvironmentFile=/etc/environment
  3. Add the following contents to /etc/environment:
    all_proxy=<ip_address_of_proxy>:<port number> or
    https_proxy=<ip_address_of_proxy>:<port number>
    
    Note that you can use the FQDN if the hostname is used instead of the IP address.
  4. After making configuration changes, the sensor must be restarted; for example:
    'systemctl
    daemon-reload'; systemctl restart cbagentd

Additional Information

  • Proxy environment variables are not supported in CentOS 6
  • This will set a proxy at the system level. To set a proxy for only the sensor:
    1. Point custom.conf file a custom file location (instead of /etc/environment)
    2. Add the contents of step 3, to the custom file.