|
1 | | -# Agent Check: Valence Security |
2 | | - |
3 | 1 | ## Overview |
4 | 2 |
|
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. |
6 | 4 |
|
7 | | -## Setup |
| 5 | +This integration ingests the following log types: |
8 | 6 |
|
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. |
10 | 9 |
|
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. |
13 | 11 |
|
14 | | -### Configuration |
| 12 | +## Setup |
15 | 13 |
|
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**. |
17 | 37 |
|
18 | | -### Validation |
| 38 | +## Data Collected |
19 | 39 |
|
20 | | -!!! Add steps to validate integration is functioning as expected !!! |
| 40 | +### Logs |
21 | 41 |
|
22 | | -## Data Collected |
| 42 | +The Valence Security integration collects alerts and audit logs and forwards them to Datadog. |
23 | 43 |
|
24 | 44 | ### Metrics |
25 | 45 |
|
26 | | -Valence Security does not include any metrics. |
| 46 | +The Valence Security integration does not include any metrics. |
27 | 47 |
|
28 | 48 | ### Events |
29 | 49 |
|
30 | | -Valence Security does not include any events. |
| 50 | +The Valence Security integration does not include any events. |
31 | 51 |
|
32 | 52 | ## Troubleshooting |
33 | 53 |
|
34 | | -Need help? Contact [Datadog support][3]. |
| 54 | +Need help? Contact [Datadog support][2]. |
35 | 55 |
|
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