# Hyperping

> Verbind een Hyperping-project met Tidal Control via een alleen-lezen API-sleutel, zodat compliancetests je monitors, healthchecks en statuspagina uitlezen.

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

De Hyperping-integratie van Tidal Control leest de configuratie en status van één Hyperping-project uit voor compliancedoeleinden. De verbinding authenticeert met een project-API-sleutel tegen de Hyperping REST API. Uptime-monitoring, waarschuwingen en communicatie over incidenten zijn precies waar auditors naar vragen bij beschikbaarheid, monitoring en incidentbeheer, en deze integratie maakt van je Hyperping-inrichting bewijs daarvoor.

## Wat deze integratie monitort

- **Uptime-monitors:** Of elke monitor actief en bereikbaar is, hoe vaak hij controleert, vanuit hoeveel regio's, en of hij iemand alarmeert via een escalatiebeleid
- **Certificaten en domeinen:** Of HTTPS-monitors waarschuwen voordat een certificaat verloopt, of een gemonitord certificaat binnen 14 dagen verloopt, en of waarschuwingen voor het verlopen van het domein aanstaan
- **Healthchecks:** Of de cron- en heartbeat-checks die back-ups en andere geplande taken bewaken hun pings ontvangen
- **Storingen:** Of er een storing langer dan drie dagen openstaat
- **Statuspagina's:** Of er een statuspagina gepubliceerd is, en of incidenten daarop worden afgesloten met een update met de status Resolved

## Vereisten

- De rol Super User in Tidal Control
- Een Hyperping-gebruiker die de **Developers**-instellingen van het project kan openen
- Eén verbinding per Hyperping-project, omdat een API-sleutel bij één project hoort

## Stappenplan voor de configuratie

We maken in Hyperping een **alleen-lezen API-sleutel** aan en voegen daarna de verbinding toe in Tidal Control.

**Configuratiestappen:**

1. **Maak een alleen-lezen API-sleutel aan**
2. **Configureer de integratie in Tidal Control**

## Stap 1: Maak een alleen-lezen API-sleutel aan

- Open in [Hyperping](https://app.hyperping.io) het project dat je wilt verbinden
- Ga naar **Settings → Developers** en klik op **Create API key**
- Geef de sleutel een naam, bijvoorbeeld `Tidal Control`
- Zet **Permissions** op **Read-only**
- Kies een **Expiration**, of **Never** als je sleutelbeleid dat toestaat
- **Kopieer de sleutel** direct: hij wordt maar één keer getoond

> **info:**

**Waarom alleen-lezen genoeg is.** Een alleen-lezen sleutel kan alleen de GET-endpoints aanroepen. Hij kan geen monitors of healthchecks aanmaken, wijzigen, pauzeren of verwijderen, geen storingen bevestigen of oplossen, en niets publiceren op een statuspagina of naar de abonnees daarvan sturen. Tidal Control schrijft nooit naar Hyperping.

## Stap 2: Configureer de integratie in Tidal Control

- Ga in Tidal Control naar **Instellingen → Integraties**
- Klik op het **plusicoon** naast **Hyperping**
- Vul de configuratie in:
  - **Naam:** Een herkenbare naam, bijvoorbeeld `Hyperping productie`
  - **API-sleutel:** De sleutel uit stap 1
- Klik op **"Aanmaken"** om de integratie op te slaan

Wil je nog een Hyperping-project verbinden? Maak dan een sleutel aan in dat project en voeg een tweede verbinding toe.

## Configuratievelden uitgelegd

Het integratievenster vraagt om de volgende waarden:

**Naam:**
- Een herkenbare naam voor deze verbinding
- Bijvoorbeeld: `Hyperping`, `Hyperping productie`

**API-sleutel:**
- De alleen-lezen sleutel uit stap 1
- Verplicht, wordt als geheim opgeslagen en mag geen spaties bevatten

## Wat Tidal Control uitleest, en wat niet

Tidal Control leest monitors, statuspagina's, lopende storingen, incidenten op statuspagina's en healthchecks uit. Sommige velden daarin kunnen geheimen of persoonsgegevens bevatten, en die worden nooit opgeslagen:

- Request-headers, request-bodies en variabelen van browserchecks van monitors, waarin teams vaak tokens bewaren voor beveiligde endpoints
- De gebruikersnaam, het wachtwoord, de querystring en het fragment van een gemonitorde URL
- Het privé ping-token en de ping-URL van een healthcheck, waarmee iedereen een taak als gezond zou kunnen melden
- Het e-mailadres van degene die een storing bevestigde, en de abonnees van een statuspagina

## Verificatie

De integratie werkt als het volgende allemaal klopt:

- Instellingen → Integraties toont Hyperping onder **Geconfigureerde integraties**
- Hyperping-tests staan in het onderdeel Tests
- Het vernieuwen van tests levert resultaten op zonder authenticatiefouten

## Veelgestelde vragen

**Waarom laten gepauzeerde monitors niet elke test falen?**
Een monitor pauzeren is een bewuste keuze. De test dat elke monitor actief is meldt een gepauzeerde monitor één keer, en de andere monitortests laten hem buiten beschouwing, zodat één gepauzeerde monitor niet een hele reeks tests laat falen.

**Ons project gebruikt het gratis abonnement. Werken de tests dan nog?**
Ja. Geen van de endpoints die deze integratie uitleest is beperkt tot een betaald abonnement, en het controle-interval van vijf minuten van het gratis abonnement voldoet aan de test voor de controlefrequentie.

**Wat gebeurt er als de sleutel verloopt?**
Elke uitleespoging faalt dan met een authenticatiefout tot je een nieuwe sleutel invult. Open de verbinding onder Instellingen → Integraties en vervang daar de sleutel.

## Veelvoorkomende problemen

**"API-sleutel is verplicht"**
- Het veld is leeg. Plak de sleutel uit stap 1

**Authenticatiefouten na het vernieuwen**
- De sleutel is ingetrokken of verlopen. Maak een nieuwe alleen-lezen sleutel aan en werk de verbinding bij

**Geen monitors of statuspagina's gevonden**
- De sleutel hoort bij een ander project dan je bedoelde. Sleutels gelden per project, dus maak er een aan in het juiste project

### Kom je er niet uit?

Stuur een e-mail naar support@tidalcontrol.com, dan nemen we zo snel mogelijk contact met je op.

> **info:**

**Verzamel supportinformatie:** Noteer welke browser je gebruikt, de exacte foutmeldingen en welke stappen je al hebt geprobeerd. Dat versnelt de oplossing aanzienlijk.
