Datadog

Datadog integratie configureren

Tidal Control's Datadog integratie monitort de beveiligingsconfiguratie, users en monitoring setup van je organisatie voor compliance doeleinden.

Wat deze integratie monitort:

Users: MFA status en accountconfiguratie
Organisatie-instellingen: SAML-configuratie en authenticatie-instellingen
API keys: Gebruik en verouderde keys
Application keys: Scope-configuratie
Monitors: Prioriteitsinstellingen en actieve downtimes
Security monitoring regels: Of detectieregels ingeschakeld zijn
CSM findings: Mislukte Cloud Security Management findings
Synthetics tests: Teststatus en locatieconfiguratie

Vereisten:

Super User rol in Tidal Control
Datadog account met toegang tot Organisation Settings

Configuratie stappenplan

Wat gaan we doen: We maken een Datadog API key en application key aan en voegen de verbinding toe in Tidal Control. Als je organisatie een andere Datadog site gebruikt dan de standaard US-regio, configureer je ook het site-veld.

Configuratie stappen:

API key aanmaken
Application key aanmaken
Integratie configureren in Tidal Control

Stap 1: API key aanmaken

Log in op je Datadog account
Klik op je organisatienaam linksonder in het scherm
Selecteer Organisation Settings
Navigeer naar API Keys in de linker zijbalk
Klik op New Key
Voer een naam in (bijv. Tidal Control)
Klik op Create Key
Kopieer de key-waarde — deze wordt slechts één keer getoond

Warning

Sla de API key direct op. Datadog toont de volledige key-waarde slechts één keer bij aanmaken. Als je het dialoogvenster sluit zonder te kopiëren, moet je een nieuwe key aanmaken.

Stap 2: Application key aanmaken

Datadog gebruikt application keys om toegang tot specifieke data te autoriseren. De application key bepaalt wat de integratie kan lezen.

Blijf in Organisation Settings
Navigeer naar Application Keys in de linker zijbalk
Klik op New Key
Voer een naam in (bijv. Tidal Control)
Klik op Create Key
Kopieer de key-waarde — deze wordt slechts één keer getoond

Info

Scoped application keys: Datadog biedt de mogelijkheid om application keys te beperken tot specifieke machtigingen. Als je scoped keys gebruikt, zorg dan dat de key leestoegang heeft tot: users, monitors, organisatie-instellingen, API keys, application keys, security monitoring regels, CSM findings en Synthetics tests. Een unscoped key werkt met volledige leestoegang.

Stap 3: Integratie configureren in Tidal Control

Ga naar Settings → Integrations in Tidal Control
Klik op het plus-icoon naast Datadog
Vul de configuratie in:
- Name: Een beschrijvende naam, bijv. Datadog
- API Key: De API key uit stap 1
- Application Key: De application key uit stap 2
- Site: Laat leeg als je organisatie de standaard US-regio gebruikt (datadoghq.com). Voer je site in als je een andere Datadog-regio gebruikt (zie hieronder)
Klik op "Create" om de integratie op te slaan

Configuratie velden uitgelegd

Name:

Een beschrijvende naam voor deze verbinding
Bijvoorbeeld: Datadog, Datadog Productie

API Key:

Identificeert je Datadog organisatie
Aangemaakt in stap 1
Houd deze waarde veilig

Application Key:

Autoriseert Tidal Control om data te lezen uit je Datadog account
Aangemaakt in stap 2
Houd deze waarde veilig

Site (optioneel):

De regionale Datadog site die je organisatie gebruikt
Laat leeg voor de standaard site (datadoghq.com)
Voer alleen het domein in, zonder https:// (bijv. datadoghq.eu, niet https://datadoghq.eu)

Site	Regio
`datadoghq.com`	US1 (standaard)
`datadoghq.eu`	EU
`us3.datadoghq.com`	US3
`us5.datadoghq.com`	US5
`ap1.datadoghq.com`	AP1 (Azië-Pacific)
`ap2.datadoghq.com`	AP2 (Australië)
`ddog-gov.com`	US1-FED (Amerikaanse overheid)

Verificatie

Controleer integratie status:

Settings → Integrations toont "Connected" status voor Datadog
Datadog tests zijn beschikbaar in de Tests sectie
Test refresh levert resultaten zonder authenticatiefouten

Veelgestelde vragen

Kan ik dezelfde API key en application key gebruiken voor meerdere Tidal Control omgevingen? Ja, je kunt dezelfde keys hergebruiken voor verschillende Tidal Control instanties.

Hoe weet ik welke Datadog site ik gebruik? Controleer de URL wanneer je bent ingelogd op Datadog. Als je app.datadoghq.eu gebruikt, is je site datadoghq.eu. Als je app.datadoghq.com gebruikt, laat het site-veld leeg.

Moet ik Datadog admin zijn om keys aan te maken? Je hebt voldoende rechten in Datadog nodig om API keys en application keys aan te maken. Dit vereist doorgaans een admin- of owner-rol in je Datadog organisatie.

Veelvoorkomende problemen

"The Datadog API key does not have the required permissions"

Controleer of zowel de API key als de application key correct zijn ingevoerd
Als je een scoped application key gebruikt, controleer dan of deze leestoegang heeft tot de vereiste datatypes
Maak een nieuwe unscoped application key aan om te bevestigen dat de verbinding werkt

"Site must not include a protocol prefix"

Verwijder https:// of http:// uit het site-veld
Voer alleen het domein in, bijvoorbeeld datadoghq.eu

"Site must be one of..."

Controleer of de site-waarde exact overeenkomt met een van de ondersteunde site-domeinen in de tabel hierboven

Kom je er nog niet uit?

Stuur een e-mail naar support@tidalcontrol.com, en wij nemen zo snel mogelijk contact op.

Info

Support info verzamelen: Noteer welke browser je gebruikt, exacte foutmeldingen, en welke stappen je al geprobeerd hebt. Dit versnelt de oplossing aanzienlijk.