# Datadog

> Verbind Datadog met Tidal Control zodat compliance tests je beveiligingsconfiguratie, users en monitoring setup uitlezen. Alleen-lezen op je organisatie.

Source: https://tidalcontrol.com/nl/docs/integrations/datadog

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

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:**

1. **API key aanmaken**
2. **Application key aanmaken**
3. **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 **Instellingen → Integraties** 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 **"Aanmaken"** om de integratie op te slaan

## Configuratievelden uitgelegd

Het integratievenster vraagt om de volgende waarden:

**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`)

<table>
<thead>
<tr><th>Site</th><th>Regio</th></tr>
</thead>
<tbody>
<tr><td><code>datadoghq.com</code></td><td>US1 (standaard)</td></tr>
<tr><td><code>datadoghq.eu</code></td><td>EU</td></tr>
<tr><td><code>us3.datadoghq.com</code></td><td>US3</td></tr>
<tr><td><code>us5.datadoghq.com</code></td><td>US5</td></tr>
<tr><td><code>ap1.datadoghq.com</code></td><td>AP1 (Azië-Pacific)</td></tr>
<tr><td><code>ap2.datadoghq.com</code></td><td>AP2 (Australië)</td></tr>
<tr><td><code>ddog-gov.com</code></td><td>US1-FED (Amerikaanse overheid)</td></tr>
</tbody>
</table>

## Verificatie

De integratie werkt wanneer het volgende allemaal klopt:

- Instellingen → Integraties toont Datadog onder **Geconfigureerde integraties**
- 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 we nemen zo snel mogelijk contact met je op.

> **info:**

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