Add Trellix EDR

Prev Next

Add the data source to a receiver. The types of topics collected are: 'BusinessEvents', 'case-mgmt-events', and 'threatEvents'.

  1. Select a receiver.

  2. Click the Properties icon.

  3. From the Receiver Properties window, select Data Sources.

  4. Click Add.

    Option

    Definition

    Data Source Vendor

    Trellix

    Data Source Model

    Trellix EDR

    Data Format

    Default

    Data Retrieval

    API

    Enabled

    Select options for processing events. Some options may not be available for your data source.

    • Parsing - if you want to parse events. Enabling parsing is recommended.

    • Trellix Enterprise Log Manager (ELM) - if you want to log the events on an ELM.

    • Trellix Enterprise Log Search (ELS) - if you want to search event log on an ELS.

    • SNMP Trap - if your environment requires it (this is rare).

    Name

    Name of the data source.

    IP Address/Hostname

    Hostname: To find the hostname,

    1. Go to https://github.com/trellix-enterprise/mvision-edr-activity-feed.

    2. Use the API service endpoint URL appropriate to your environment listed under Step 4. For example, api.soc.trellix.com.

      Note

      Do not use the following format: https://api.soc.trellix.com{}.

    IP Address: When you’ve added the Hostname, click Look up to automatically fill the IP Address field (Don't click on Look Up if there's a value on IP Address Field as it would change the hostname).

    Consumer Group

    A string used to create a consumer to pull the data from EDR. This can be whatever you want, for example ("siem_edr").

    Client ID/Client Secret

    Key

    The Client ID and Client Secret Key are obtained by following the onboarding for Trellix EDR Activity Feed. For more details on generating these credentials, refer to Trellix EDR Integrations.

    Use Proxy

    If you select this, enter the proxy IP, port, and credentials.

    Support Generic Syslogs

    Do nothing.

  5. (Optional) Click Advanced and configure the settings.

    Option

    Definition

    Device URL

    Type the URL address that can be accessed to view event data for this data source (maximum of 512 characters). You can access this URL by clicking the Launch Device URL icon at the bottom of the Event Analysis view.

    Vendor, Product, Version

    Enter the vendor, product, and version of the device where the Trellix ESM Common Event Format (CEF) forwards events.

    Date Order

    Select the format for the dates on data sources:

    • Default — Uses the default date order (month before day). When using client data sources, clients using this setting inherit the date order of the parent data source.

    • Month before day — The month goes before the day (04/23/2018).

    • Day before month — The day goes before the month (23/04/2018).

    Zone

    To assign this data source to a zone, select the zone from the list.

    External data source link

    Automatically selected when you import events from another receiver. You can clear the checkbox which would remove the distinction of imported data.

    For example, you export logs from receiver 1 into receiver 2. The External data source link is applied to the logs being sent so that when logs are imported, Trellix ESM can differentiate the forwarded events.

    Export in NitroFile format

    Use this option when you are exporting raw data source data.

    Data is NitroFile format

    Use this option when you are exporting raw data source data.

    Note

    When you export data sources to a remote file, they are exported in NitroFile format. If you import those files to another Receiver automatically, Data is NitroFile is selected for each of the data sources you are importing. This indicates that the file is in NitroFile format. If you import them manually, you must select this box for each data source.

    Validate SHA1 checksum

    If the data you are importing is in NitroFile format, select this option if the data source has a checksum file.

    Note

    When imported automatically, Validate SHA1 checksum is selected for any data source that has a checksum file. If you import them manually, you must select it. The only exception is when you are importing a data source file that doesn't have a checksum file, but you want to view it anyway.