The new docs.trellix.com offers a modernized UI and AI-powered features like conversational searches. Content is currently available only in English. Other languages will be available in mid-October 2026. We hope you enjoy the new experience.

Configure Message Forwarding

Prev Next

Share public, unparsed data with third-party applications. Message Forwarding rules create public copies of raw data on the Data Streaming Bus. You use authentication certificates and Apache Kafka® code to access the raw data. The use of dedicated authentication certificates ensures secure communication.

  • Your system must include a Data Streaming Bus.

  • You need a working knowledge of Kafka.

  • You need to know the names of the topics you want to consume.

  • Get a ca_root_certificate file from Trellix.

  • If your system does not include a Trellix Enterprise Log Search device, enable data routing on the Receivers you want to collect data from (Receiver PropertiesData Routing).

You set up Message Forwarding by creating a rule for each topic you want to forward. Rules specify the sources, topics, and authentication certificates for the topics. Status flags appear to the left of each rule that indicate data source health and certificate life span.

  1. From the Trellix ESM dashboard, click menu.png.

  2. Select Message Forwarding.

    The Message Forwarding Rules page appears.

  3. Click Add.

  4. Type a rule name and select Enabled.

  5. Choose the Source Adapter for the rule. ELS Raw Log retrieves raw data from the ELS. Data Routing retrieves raw data from data sources that have data routing enabled.

    Note

    Once you enable data routing on a Receiver, you can enable and disable it on individual data sources (Receiver PropertiesData Source).

  6. If you want topics from a data source to be consumed only by the third-party Kafka consumer and not parsed, deselect Parsing (Receiver PropertiesData Sources).

  7. Select the Devices you want to collect data from. To select all data sources on a Receiver, select the Receiver.

  8. Type a Target topic name.

  9. Select an existing Authentication certificate or create (Create Certificate) and download a new certificate for the rule.

    Note

    Once a certificate is generated, you have 10 minutes to download it before it expires.

    Important

    If your browser is not configured to automatically download files, manually download the certificate.

  10. Use the DSB IP address/port, both certificates, and the public topic names when you configure your Kafka consumer.