Datadog Connector
The Datadog connector syncs users and role assignments from your Datadog organization.
What Gets Synced
- Users
- Roles
- Role assignments
Prerequisites
- Datadog organization access
- A Datadog API key
- A Datadog application key tied to a principal that can read users and roles
Setup Instructions
1. Create an API Key
- Open Datadog organization settings
- Create a new API key for Open-SSPM
- Copy the value
2. Create an Application Key
- Create a new application key
- Copy the value
3. Determine Your Site Value
Enter the Datadog host, not the short site nickname.
| Datadog URL | Value to Enter in Open-SSPM |
|---|---|
https://app.datadoghq.com | datadoghq.com |
https://us3.datadoghq.com | us3.datadoghq.com |
https://us5.datadoghq.com | us5.datadoghq.com |
https://app.datadoghq.eu | datadoghq.eu |
https://app.ddog-gov.com | ddog-gov.com |
Open-SSPM normalizes full URLs and hostnames, but using the host directly is the clearest input.
4. Configure in Open-SSPM
- Go to Settings → Connectors
- Open the Datadog connector
- Enter:
- Site: for example
datadoghq.comorus3.datadoghq.com - API key
- Application key
- Site: for example
- Save the configuration
- Trigger a sync
Settings
| Setting | Required | Description |
|---|---|---|
| Site | Yes | Datadog site host, such as datadoghq.com |
| API Key | Yes | Datadog API key |
| Application Key | Yes | Datadog application key |
Sync Tuning
bash
SYNC_DATADOG_INTERVAL=15m
SYNC_DATADOG_WORKERS=3Troubleshooting
Invalid API or Application Key
- Recreate the key and update the connector
- Make sure the keys belong to the expected Datadog site
Site Errors
- Use the site host, not a shorthand like
us1oreu - Check that the value matches your Datadog URL
Missing Users
- Verify the key owner can read users and roles
- Trigger a fresh sync from Settings → Connector health