-
Notifications
You must be signed in to change notification settings - Fork 1.4k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[SAASINT-3541] DDS: Tanium: Crawler Integration v1.0.0 #19343
Changes from 11 commits
1864130
fad4621
e1ce109
00c2994
3cf8909
73b7bf9
c842320
63d03ce
4368d5e
9a3f879
2912f92
2174e95
5ab3860
dc25fbf
2bfc615
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
@@ -1,43 +1,59 @@ | ||||||
# Agent Check: tanium | ||||||
|
||||||
## Overview | ||||||
|
||||||
This check monitors [tanium][1]. | ||||||
[Tanium][1] is an enterprise platform that's primarily used as an endpoint management tool. It empowers security and IT operations teams with quick visibility and control to secure and manage every endpoint on the network. | ||||||
|
||||||
## Setup | ||||||
This integration ingests the following logs: | ||||||
|
||||||
- **Threat Response Alerts**: This endpoint contains information about the core incident response lifecycle with integrated capabilities for alerting, analysis, containment, and remediation. | ||||||
- **Threat Response Audit**: This endpoint contains information about the centralized view of audit events generated by the Tanium Threat Response. | ||||||
- **Platform Audit**: This endpoint contains information about the authentication, API token usage, local settings, persona changes, user settings, and system settings information. | ||||||
|
||||||
This integration collects logs from the sources listed above and sends them to Datadog for analysis with our Log Explorer and Cloud SIEM products | ||||||
* [Log Explorer][3] | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
would be better to just provide the links here There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Done 👍 |
||||||
* [Cloud SIEM][4] | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
delete There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Done 👍 |
||||||
|
||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
delete There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Done 👍 |
||||||
### Installation | ||||||
## Setup | ||||||
|
||||||
The tanium check is included in the [Datadog Agent][2] package. | ||||||
No additional installation is needed on your server. | ||||||
### Generate API Credentials in Tanium | ||||||
|
||||||
### Configuration | ||||||
1. Login into Tanium. | ||||||
2. From the Main menu, go to **Administration** > **Permissions** > **API Tokens**. | ||||||
3. Click **New API Token** and configure the token settings: | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Done 👍 |
||||||
- **Expiration**: Enter the expiration interval in days. | ||||||
- **Trusted IP addresses**: Enter the external IP addresses as `::/0,0.0.0.0/0` to enable any system to use the token. | ||||||
4. Click on **Create**. | ||||||
5. Click on **Yes** and copy the **token** for later use. | ||||||
6. The Tanium host format is **\<customer\>.cloud.tanium.com**. Replace **\<customer\>** with your organization's specific subdomain. | ||||||
|
||||||
!!! Add list of steps to set up this integration !!! | ||||||
### Connect your Tanium Account to Datadog | ||||||
|
||||||
### Validation | ||||||
1. Add your Host and API Token. | ||||||
| Parameters | Description | | ||||||
| ------------------- |------------------------------------------------------------- | | ||||||
| Host | The Host of your Tanium platform. | | ||||||
| API Token | The API Token of your Tanium platform. | | ||||||
|
||||||
!!! Add steps to validate integration is functioning as expected !!! | ||||||
2. Click the Save button to save your settings. | ||||||
|
||||||
## Data Collected | ||||||
|
||||||
### Metrics | ||||||
### Logs | ||||||
|
||||||
tanium does not include any metrics. | ||||||
The Tanium integration collects and forwards threat-response alerts, threat-response audit logs, and platform audit logs to Datadog. | ||||||
|
||||||
### Service Checks | ||||||
### Metrics | ||||||
|
||||||
tanium does not include any service checks. | ||||||
The Tanium integration does not include any metrics. | ||||||
|
||||||
### Events | ||||||
|
||||||
tanium does not include any events. | ||||||
|
||||||
## Troubleshooting | ||||||
The Tanium integration does not include any events. | ||||||
|
||||||
Need help? Contact [Datadog support][3]. | ||||||
## Support | ||||||
|
||||||
[1]: **LINK_TO_INTEGRATION_SITE** | ||||||
[2]: https://app.datadoghq.com/account/settings/agent/latest | ||||||
[3]: https://docs.datadoghq.com/help/ | ||||||
For any further assistance, contact [Datadog support][2]. | ||||||
|
||||||
[1]: https://www.tanium.com/ | ||||||
[2]: https://docs.datadoghq.com/help/ | ||||||
[3]: https://docs.datadoghq.com/logs/explorer/ | ||||||
[4]: https://www.datadoghq.com/product/cloud-siem/ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Suggest to reword this slightly
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done 👍