Add the data source to a receiver. The types of topics collected are: 'BusinessEvents', 'case-mgmt-events', and 'threatEvents'.
Select a receiver.
Click the Properties icon.
From the Receiver Properties window, select Data Sources.
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,
Go to https://github.com/trellix-enterprise/mvision-edr-activity-feed.
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.
(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.