Webhooks

Met webhooks kan InfraNest realtime updates over je infrastructuur rechtstreeks naar je eigen systemen sturen, zodat je tools automatisch kunnen reageren in plaats van dat je dit handmatig moet controleren.

#Overzicht

• Webhooks brengen een eindpunt dat jij beheert op de hoogte zodra er iets gebeurt in InfraNest — zoals een verlopend domein of een monitorwaarschuwing.
• Elke verzending wordt ondertekend, zodat je kunt bevestigen dat deze daadwerkelijk van InfraNest afkomstig is.
• Mislukte verzendingen worden gelogd en automatisch opnieuw geprobeerd.

#Een webhook toevoegen

1. Ga naar Webhooks en voeg een eindpunt toe.
2. Voer de URL in waarnaar gebeurtenissen moeten worden verzonden, een beschrijving, en kies welke gebeurtenissen deze moet ontvangen.

3. Sla op. InfraNest genereert een geheime sleutel waarmee je de aanvragen kunt verifiëren.

#Kiezen welke gebeurtenissen je wilt ontvangen

Je kunt een webhook abonneren op gebeurtenissen zoals:

• Een verlopend domein
• Een status­wijziging van een domein of server
• Een monitorwaarschuwing
• Wijzigingen in DNS-records
• De drop-catch-levenscyclus (valt binnenkort vrij, beschikbaar, geregistreerd, mislukt)

#Verzendingen verifiëren

1. Elke webhook wordt verzonden als een POST-aanvraag, ondertekend met je geheime sleutel via een HMAC in de header X-InfraNest-Signature-V2, en voorzien van een tijdstempel via X-InfraNest-Timestamp.
2. Gebruik deze headers aan jouw kant om te bevestigen dat de aanvraag daadwerkelijk van InfraNest afkomstig is.
3. Testverzendingen en echte gebeurtenissen worden op dezelfde manier ondertekend, zodat je je configuratie veilig kunt testen voordat je erop vertrouwt.

WarningDe oudere header X-InfraNest-Signature wordt na 30 april 2027 niet meer verzonden. Zorg dat je ontvanger vóór die datum overschakelt op X-InfraNest-Signature-V2.

NoteAls een verzending mislukt, registreert InfraNest dit en probeert het automatisch opnieuw — je hoeft deze niet zelf opnieuw te verzenden.

#Overige inkomende verbindingen

InfraNest accepteert ook een aantal inkomende verbindingen die door je eigen tools worden aangeroepen, elk beveiligd met een eigen token. Voorbeelden hiervan zijn:

• Deploy hooks — start een deploy vanuit je CI-systeem.
• Updates voor dynamische IPs — verzonden vanaf je router (zie Set up Dynamic IP).