Skip to content
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

Merged
Merged
Changes from 11 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
@@ -427,6 +427,10 @@ vonage/assets/logs/ @DataDog/saas
/asana/manifest.json @DataDog/saas-integrations @DataDog/documentation
/asana/assets/logs/ @DataDog/saas-integrations @DataDog/documentation @DataDog/logs-backend

/tanium/ @DataDog/saas-integrations
/tanium/*.md @DataDog/saas-integrations @DataDog/documentation
/tanium/manifest.json @DataDog/saas-integrations @DataDog/documentation
/tanium/assets/logs/ @DataDog/saas-integrations @DataDog/documentation @DataDog/logs-backend

plaid/ @DataDog/saas-integrations
plaid/*.md @DataDog/saas-integrations @DataDog/documentation
60 changes: 38 additions & 22 deletions tanium/README.md
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.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[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.
[Tanium][1] is an enterprise platform designed for endpoint management. It provides security and IT operations teams with rapid visibility and control to secure and manage all network endpoints.

Suggest to reword this slightly

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done 👍

## 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]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This integration collects logs from the sources listed above and sends them to Datadog for analysis with our Log Explorer and Cloud SIEM products
This integration collects logs from the sources listed above and transmits them to Datadog for analysis in [Log Explorer][3] and [Cloud SIEM][4].

would be better to just provide the links here

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done 👍

* [Cloud SIEM][4]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* [Log Explorer][3]

delete

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done 👍


Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* [Cloud SIEM][4]

delete

Copy link
Contributor Author

Choose a reason for hiding this comment

The 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:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. From the Main menu, go to **Administration** > **Permissions** > **API Tokens**.
2. From the main menu, navigate to **Administration** > **Permissions** > **API Tokens**.

Copy link
Contributor Author

Choose a reason for hiding this comment

The 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/
Loading