Carbon Black Endpoint Security Platform configuration

Prev Next

This section describes how to collect events from Carbon Black to send to Helix Enterprise. This requires that you install and configure the cb-event-forwarder to send the Carbon Black events.

To install the Carbon Black Enterprise RPM and ensure that it is running:
  • You can install the cb-event-forwarder on any 64-bit Linux computer that is running CentOS 6.x. It can be installed on the same machine as the Carbon Black server, or on another machine. If you are forwarding many events (for example, all file modifications, registry modifications, or both) to the Communication Broker, install cb-event-forwarder on a separate server. If you are not forwarding many events to the Communications Broker, you can install the cb-event-forwarder on the Carbon Black server.

To install the cb-event-forwarder on a machine other than the Carbon Black server, you must configure the Carbon Black server:
  1. Ensure that TCP port 5004 is open through the iptables firewall on the Carbon Black server. The event-forwarder connects to TCP port 5004 on the Carbon Black server to connect to the Cb message bus.

  2. Get the RabbitMQ user name and password from the /etc/cb/cb.conf file on the Carbon Black server. Search for the RabbitMQUser and RabbitMQPassword variables and note their values for later.

To send logs from Carbon Black Endpoint Security Platform:
  1. Install the CbOpenSource repository if it is not already installed.

    cd /etc/yum.repos.d
    curl -O https://opensource.carbonblack.com/release/x86_64/CbOpenSource.repo
  2. Install the RPM for cb-event-forwarder:

    yum install cb-event-forwarder
  3. Modify the /etc/cb/integrations/event-forwarder/cb-event-forwarder.conf file to include udpout=<Syslog_IP_server>:514.

    where:

    <Syslog_IP_server> is your Helix Enterprise Comm Broker Sender.

  4. If you are installing on a computer other than the Carbon Black server, copy the RabbitMQ user name and password into therabbit_mq_username and rabbit_mq_password variables in the /etc/cb/integrations/event-forwarder/cbevent-forwarder.conf file. In the cb_server_hostname variable, enter the host name or IP address of the Carbon Black server.

  5. Ensure that the configuration is valid by running the cb-event-forwarder in check mode:

    /usr/share/cb/integrations/event-forwarder/cb-event-forwarder -check

    If valid, the message Initialized output displays. If there are errors, the errors are printed to your screen.

  6. Choose the type of event that you want to capture.

    By default, Carbon Black publishes the all feed and watchlist events over the bus. If you want to capture raw sensor events or all binaryinfo notifications, you must enable those features in the /etc/cb/cb.conf file.

    • To capture raw sensor events, edit the DatastoreBroadcastEventTypes option in the /etc/cb/cb.conf file to enable broadcast of the raw sensor events that you want to export.

    • To capture binary observed events, edit the EnableSolrBinaryInfoNotifications option in the /etc/cb/cb.conf file and set it to True.

  7. If any variables were changed in /etc/cb/cb.conf, restart the Carbon Black server:

    "service cb-enterprise restart"
  8. Start the cb-event-forwarder service by using the initctl command:

    Initctl start cb-event-forwarder

    Note

    You can stop the cb-event-forwarder service by using the initctl command: initctl stop cb-event-forwarder.

    Note

    For source code and a quick start guide, see the GitHub website at https://github.com/carbonblack/cb-event-forwarder/