Skip to content

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

  1. Open Datadog organization settings
  2. Create a new API key for Open-SSPM
  3. Copy the value

2. Create an Application Key

  1. Create a new application key
  2. Copy the value

3. Determine Your Site Value

Enter the Datadog host, not the short site nickname.

Datadog URLValue to Enter in Open-SSPM
https://app.datadoghq.comdatadoghq.com
https://us3.datadoghq.comus3.datadoghq.com
https://us5.datadoghq.comus5.datadoghq.com
https://app.datadoghq.eudatadoghq.eu
https://app.ddog-gov.comddog-gov.com

Open-SSPM normalizes full URLs and hostnames, but using the host directly is the clearest input.

4. Configure in Open-SSPM

  1. Go to Settings → Connectors
  2. Open the Datadog connector
  3. Enter:
    • Site: for example datadoghq.com or us3.datadoghq.com
    • API key
    • Application key
  4. Save the configuration
  5. Trigger a sync

Settings

SettingRequiredDescription
SiteYesDatadog site host, such as datadoghq.com
API KeyYesDatadog API key
Application KeyYesDatadog application key

Sync Tuning

bash
SYNC_DATADOG_INTERVAL=15m
SYNC_DATADOG_WORKERS=3

Troubleshooting

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 us1 or eu
  • 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

Released under the MIT License.