Skip to content

Commit f004846

Browse files
[SAASINT-5086] DDS: Valence Security: Crawler Integration v1.0.0 (DataDog#22258)
* Add Valence Security crawler integration without assets * Add Valence Security integration with assets * Resolve CI Failures * Added dashboard images * Address review comments * Resolve CI Failure * Address review comments
1 parent 695ff3e commit f004846

16 files changed

Lines changed: 6054 additions & 21 deletions

valence_security/README.md

Lines changed: 37 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,57 @@
1-
# Agent Check: Valence Security
2-
31
## Overview
42

5-
This check monitors [Valence Security][1].
3+
[Valence Security][1] is a SaaS security platform that protects cloud applications by discovering, monitoring, and remediating risks across business applications. It reduces exposure from misconfigurations, third-party integrations, and identity threats across SaaS environments.
64

7-
## Setup
5+
This integration ingests the following log types:
86

9-
### Installation
7+
- **Alerts**: Logs that capture detected SaaS security risks, including suspicious activity, misconfigurations, identity threats, and data exposure across cloud applications.
8+
- **Audit logs**: Logs that capture user and system activity, including configuration changes, access events, and administrative actions.
109

11-
The Valence Security check is included in the [Datadog Agent][2] package.
12-
No additional installation is needed on your server.
10+
Integrate Valence Security with Datadog to analyze alerts and audit logs using pre-built dashboards. Datadog parses and enriches these logs using built-in log pipelines, supporting search and analysis. You can also use this data with Cloud SIEM detection rules for security monitoring.
1311

14-
### Configuration
12+
## Setup
1513

16-
!!! Add list of steps to set up this integration !!!
14+
### Generate an API key in Valence Security
15+
16+
1. Log in to the Valence Security platform using an admin account.
17+
2. Navigate to **Administration** > **Settings** > **Valence API**.
18+
3. Click **+ Generate API Key** and provide the following details:
19+
- **API key description**: A description of the API key's purpose.
20+
- **Display name**: A user-friendly name to identify the API key.
21+
- **Role**: The role associated with the API key (select **Admin**).
22+
4. Click **Generate** and copy the API key.
23+
5. Identify your Valence Security region by checking the hostname suffix of your URL:
24+
- `app.valencesecurity.com`: US
25+
- `appeu.valencesecurity.com`: EU
26+
27+
### Connect your Valence Security account to Datadog
28+
29+
1. Add your `Region` and `API key`.
30+
| Parameter | Description |
31+
| ---------- | ---------------------------------------------- |
32+
| Region | The Valence Security region. |
33+
| API key | The Valence Security API key. |
34+
| Get Alerts | Collect alert logs from Valence Security (enabled by default). |
35+
| Get Audit Logs | Collect audit logs from Valence Security (enabled by default). |
36+
2. Click **Save**.
1737

18-
### Validation
38+
## Data Collected
1939

20-
!!! Add steps to validate integration is functioning as expected !!!
40+
### Logs
2141

22-
## Data Collected
42+
The Valence Security integration collects alerts and audit logs and forwards them to Datadog.
2343

2444
### Metrics
2545

26-
Valence Security does not include any metrics.
46+
The Valence Security integration does not include any metrics.
2747

2848
### Events
2949

30-
Valence Security does not include any events.
50+
The Valence Security integration does not include any events.
3151

3252
## Troubleshooting
3353

34-
Need help? Contact [Datadog support][3].
54+
Need help? Contact [Datadog support][2].
3555

36-
[1]: **LINK_TO_INTEGRATION_SITE**
37-
[2]: https://app.datadoghq.com/account/settings/agent/latest
38-
[3]: https://docs.datadoghq.com/help/
56+
[1]: https://www.valencesecurity.com/
57+
[2]: https://docs.datadoghq.com/help/

0 commit comments

Comments
 (0)