Skip to content

Commit d196b77

Browse files
[SIEMINT-118] DDS: Trellix Endpoint Security: Crawler Integration v1.0.0 (#18673)
* Add Trellix Endpoint Security integration with assets * Resolve CI failures * Update log pipeline sample * Update log pipeline sample * Resolve CI Failures * Update log pipeline * Update log pipeline * Update Dashboard * Update dashboard widget * Update readme and dashboard * Update screenshot * Address review comments * Update setup section of readme * Update setup section of README
1 parent 47b0180 commit d196b77

File tree

7 files changed

+3751
-22
lines changed

7 files changed

+3751
-22
lines changed

trellix_endpoint_security/README.md

Lines changed: 35 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,43 +1,57 @@
1-
# Agent Check: trellix_endpoint_security
2-
31
## Overview
42

5-
This check monitors [trellix_endpoint_security][1].
3+
[Trellix Endpoint Security (ENS)][1] protects servers, computer systems, laptops, and tablets against known and unknown threats. These threats include malware, suspicious communications, unsafe websites, and downloaded files. Trellix Endpoint Security enables multiple defense technologies to communicate in real time to analyze and protect against threats.
64

7-
## Setup
5+
This integration ingests the following logs:
6+
7+
- **Threat Events**: This endpoint provides details about threat events triggered by Trellix Endpoint Security, including threat prevention, web control, firewall, and adaptive threat protection.
8+
9+
This integration provides enrichment and visualization for above mentioned event types. It helps to visualize detailed insights into security trends, threats, and policy violations through the out-of-the-box dashboards. Also, This integration provides out of the box detection rules.
810

9-
### Installation
11+
## Setup
1012

11-
The trellix_endpoint_security check is included in the [Datadog Agent][2] package.
12-
No additional installation is needed on your server.
13+
### Generate API Credentials in Trellix Endpoint Security
1314

14-
### Configuration
15+
1. Log in to the Trellix ePO Saas.
16+
2. Navigate to the **[Trellix Developer Portal][2]**.
17+
3. Under **Self-Service**, select **API Access Management**.
18+
4. In the **Credential Configurations** section, provide the following details:
19+
- **Client Type**: Enter a descriptive and identifiable name.
20+
- **APIs**: Choose **Events** from the dropdown.
21+
- **Method Types**: Select **GET**.
22+
5. Click **Request** to submit the request. It typically takes 2-3 days to process. You will be notified once your credentials are ready.
23+
6. When your credentials are available, generate your Client credentials by clicking **Generate** under **Create Client Credentials**.
24+
7. Copy the API key from **Access Management**, along with the Client ID and Client Secret, from **Create Client Credentials**.
1525

16-
!!! Add list of steps to set up this integration !!!
26+
### Connect your Trellix Endpoint Security Account to Datadog
1727

18-
### Validation
28+
1. Add your Client ID, Client Secret, and API Key.
29+
| Parameters | Description |
30+
| ------------- | -------------------------------------- |
31+
| Client ID | The Client ID of Trellix ePO SaaS. |
32+
| Client Secret | The Client Secret of Trellix ePO SaaS. |
33+
| API Key | The API Key of Trellix ePO SaaS. |
1934

20-
!!! Add steps to validate integration is functioning as expected !!!
35+
2. Click the Save button to save your settings.
2136

2237
## Data Collected
2338

24-
### Metrics
39+
### Logs
2540

26-
trellix_endpoint_security does not include any metrics.
41+
The Trellix Endpoint Security integration collects and forwards events related to threat prevention, web control, firewall, and adaptive threat protection to Datadog.
2742

28-
### Service Checks
43+
### Metrics
2944

30-
trellix_endpoint_security does not include any service checks.
45+
The Trellix Endpoint Security integration does not include any metrics.
3146

3247
### Events
3348

34-
trellix_endpoint_security does not include any events.
49+
The Trellix Endpoint Security integration does not include any events.
3550

36-
## Troubleshooting
51+
## Support
3752

38-
Need help? Contact [Datadog support][3].
53+
For additional assistance, contact [Datadog support][3].
3954

40-
[1]: **LINK_TO_INTEGRATION_SITE**
41-
[2]: https://app.datadoghq.com/account/settings/agent/latest
55+
[1]: https://www.trellix.com/products/endpoint-security/
56+
[2]: https://developer.manage.trellix.com/mvision/selfservice/home
4257
[3]: https://docs.datadoghq.com/help/
43-

0 commit comments

Comments
 (0)