Configuring Receivers

Receivers are data objects in Stellar Cyber that represent the destination of data collected by Photon sensors and other data sources. Each Sensor Profile must refer to one or more receivers.

You must have Root scope to use this feature.

Receiver Overview

Click System | Collection | Receivers to see a list of the configured receivers.

Receiver Overview

  • Click Create to add a new receiver. A dialog box to add a receiver appears.

  • Click to edit the receiver on the corresponding row. A dialog box to edit the receiver appears.

  • Click to delete the receiver on the corresponding row.

Adding a JSON Receiver

Receiver Edit JSON

To add a JSON receiver, fill in the following fields:

  • Name– The name of the receiver. This value will be referred to by one or more sensor profiles. This field does not support multibyte characters.

  • Data Type – Choose JSON.

  • Data Analyzer – This field provides a selection list of available data analyzers. When one is selected, the IP address of the DA is entered into the following field. This field may be left blank.

  • Receiver Hostname – The DNS or IP address that will receive the packets. This field does not support multibyte characters.

    • Set this to the IP/hostname of the DP in an AIO deployment.

    • Set this to the IP/hostname of the Data Analyzer master (DA-Master) in a cluster deployment.

  • Transport – Either HTTP or HTTPS. When this value is changed the Port Number is set to the default value.

  • Port Number – The TCP/IP port number on the receiver host that will receive the packets.

HTTP sends packets over the network unencrypted. Depending on the physical path taken by these packets this may cause a security exposure.

Click Submit in the lower right corner of the dialog box to save the changes. Click the button in the upper right corner to dismiss the dialog box without saving the changes.

Adding a Packet Receiver

Linux agent sensors and network sensors can send packet data to security sensors using VXLAN tunnels. This setup uses a packet-mode receiver as shown in this section. Once the receiver is set up it can be used in a profile that enables packet forwarding.

If you configure a packet receiver with a security sensor as the destination, and that sensor does not have a span port configured, that sensor will not ingest files (for malware and IDS analysis) from its own traffic. For the sensor to ingest files, you must do one of the following:

  • Configure another security sensor to forward traffic to that one.
  • Remove the receiver (if it's not being used).
  • Point the receiver at another sensor.

Receiver Edit Packet

To add a packet receiver, fill in the following fields:

  • Name—The name of the receiver. This field does not support multibyte characters.

  • Data Type—Either JSON or packet. Choose packet.

  • Receiver Hostname—The DNS or IP address of the system that will receive the packets. This field is only required if the selection in the following field is "Third Party." This field does not support multibyte characters.

  • Sensor—This provides a selection of all available sensors. The selected sensor must be a security sensor or a "Third Party."

  • Transport—Currently set only to the value vxlan.

  • Port Number—The TCP/IP port number that will receive the packets. The two choices are usually 4789 or 8472.

  • VNI—The Virtual Network Interface. This value should be left at the default of 200.

  • Local File—This assembles files on the network sensor and sends the files via TLS to the security sensor. Since this action requires the network sensor to process the files, enabling it can impact performance. When this field is toggled on, the additional fields for Upload Port and to Change Upload Password are displayed.

    Local file assembly only works on network sensors. Enabling it disables file assembly on the associated security sensor. Do not enable local file assembly if there are also agent sensors attached to the security sensor.

    • Upload Port—The UDP port number of the target device that will receive packets. Default is 5123.

    • Change Upload Password—When checked this enables the password fields.

    • Password/Reenter Password—These fields are used to set the password that the sensor will use when sending packets to the target sensor.

  • Traffic Filter—Stop forwarding (filter) IDS and malware traffic for the selected applications. If the VXLAN has too much traffic, use this filter to limit the traffic sent. To configure the traffic filter:

    1. Choose whether to Include or Exclude.

      If you have a small subset of applications to include, choose Include. You must explicitly include all applications you want to monitor. If an application is not included, its traffic is filtered out. The default is any.

      If you want to include most applications and exclude a subset, choose Exclude. If an application is excluded, its traffic is filtered out. The default is none.

    2. Choose an application from the Include/Exclude Applications drop-down. Start typing and Stellar Cyber narrows down the list.

    3. Click Add. The application is immediately added to the Added field. The first application you add replaces the default.

    4. Add as many applications as you want.

    5. Click the to remove an application from the list.

    6. Click Submit. The receiver is updated.