Een aangepaste webhook koppelen

Met een aangepaste webhook kun je InfraNest koppelen aan vrijwel elke tool die HTTP spreekt, zelfs als we daar nog geen kant-en-klare integratie voor hebben. Het is bedoeld voor iedereen die wil dat hun eigen systeem een melding krijgt wanneer er iets gebeurt in InfraNest, of die een andere tool acties hier wil laten starten.

#Overzicht

• Stuur events naar een URL die je zelf beheert, zodat je eigen systeem hoort wat er in InfraNest gebeurt.
• Krijg van ons een URL die elke tool kan aanroepen om hier een automatisering te starten.
• Beide richtingen zijn onafhankelijk — stel er één in, beide, of geen van beide.
• Inkomende URL's zijn niet gebonden aan één tool, daarom verwijzen de pagina's van Zapier, Make, n8n en Power Automate terug naar deze pagina.

#Events versturen

1. Ga naar Integrations → Custom webhook en selecteer Add endpoint. Voordat er iets is ingesteld, staat dit op de kaart Set up Custom webhook; daarna staat het onder Where events go op het tabblad Connections & settings.
2. Plak de URL waarop je eigen systeem luistert in Endpoint URL, en voeg eventueel een Description (optional) toe. Laat Send every event here aangevinkt staan zodat vanaf het begin elk event wordt verstuurd, en selecteer daarna Create.
3. Kopieer het signing secret dat eenmalig wordt getoond na het opslaan, en geef het door aan je ontvanger zodat die kan verifiëren dat het verzoek echt van ons komt.
4. Kies op de pagina van het endpoint een event in de lijst naast Send test event, en selecteer vervolgens Send test event, om te bevestigen dat je ontvanger het accepteert voordat je erop vertrouwt.
5. Kies wat er wordt verstuurd: onder Automations that post here toont de pagina van het endpoint de automatisering Send everything to … die daarmee is gestart. Open deze om het te beperken tot de events die je interesseren — of, als je het vinkje hebt uitgezet, kies een startpunt onder Or start from a ready-made automation: of bouw je eigen regel.

Elk endpoint heeft een eigen pagina, te openen via het ⋯-menu van het endpoint met Edit. Hetzelfde menu bevat Send test event (dit stuurt een voorbeeld van Domain expiring) en Delete, waarmee het endpoint direct wordt verwijderd, samen met de bijbehorende afleveringsgeschiedenis. Om afleveringen tijdelijk te stoppen zonder iets te verwijderen, zet je Active — deliver events to this endpoint uit op de pagina van het endpoint.

#Hoe een aflevering eruitziet

Elk event wordt verstuurd als een bericht met drie onderdelen: de naam van het event (wat er is gebeurd, zoals een verlopend domein), wanneer het is aangemaakt, en de details van dat event. Elk event stuurt alleen zijn eigen velden mee, en elk daarvan kan leeg zijn.

Elke aflevering bevat ook een aantal headers, waaronder de naam van het event, het nummer van de aflevering (zoals weergegeven onder Recent deliveries), wanneer deze is ondertekend, en een handtekening waarmee je kunt controleren dat het echt van ons komt.

NoteJe endpoint heeft 10 seconden om te reageren. Elke succesvolle reactie telt als afgeleverd; alles anders, inclusief een omleiding, telt als mislukt. We weigeren ook te versturen naar een URL die verwijst naar een privé-, lokaal of intern adres.

#Iets laten triggeren wat InfraNest doet

1. Ga naar Integrations → Custom webhook en selecteer Add incoming URL. Zodra er iets is ingesteld, staat dit onder URLs we give you op het tabblad Connections & settings.
2. Geef het een Name die je later herkent — je kiest het op naam bij het schrijven van de regel.
3. Stel eventueel een Shared secret (optional) in. Als je deze instelt, accepteren we alleen aanroepen die deze meesturen, zodat een gelekte URL op zichzelf niet genoeg is.
4. Kopieer Your URL en plak deze in de andere tool. Die moet zijn gegevens als bericht naar die URL versturen.
5. Start in InfraNest een automatisering vanuit Let another tool trigger an automation (of met de trigger Incoming webhook) en voeg toe wat er moet gebeuren — een onderhoudsvenster openen, een monitor pauzeren, een incident oplossen. Alles wat de andere tool heeft meegestuurd, is beschikbaar om te gebruiken in de regel, samen met de naam van de URL.

Elke URL verwerkt maximaal 120 aanroepen per minuut. Als een URL opnieuw is gegenereerd, stopt de oude direct met werken en worden aanroepen ernaar geweigerd.

#Goed om te weten

• Er is geen inloggegeven nodig. Jij geeft een URL op waar wij naartoe posten, en wij genereren een URL voor jou. Er hoeft geen API-sleutel te worden aangemaakt.
• Het signing secret wordt eenmalig getoond en daarna nooit meer. Rotate signing secret op de pagina van het endpoint geeft je een nieuwe; de oude stopt direct met werken.
• Je inkomende URL werkt als een wachtwoord. Iedereen die deze heeft, kan de automatiseringen van je werkruimte triggeren — stel een shared secret in, en gebruik Regenerate URL als deze lekt. Alleen mensen die monitoring mogen wijzigen, kunnen de URL zien en kopiëren.
• Accept calls to this URL schakelt één inkomende URL uit zonder deze te verwijderen of de andere te raken. Aanroepen ernaartoe worden nog steeds beantwoord en vermeld onder What has arrived als geweigerd, maar er wordt niets uitgevoerd.
• What went out staat onder Recent deliveries, op de pagina van het endpoint en op het tabblad Activity, met wat je endpoint heeft geantwoord. Een mislukte aflevering heeft een knop Retry. What came in staat onder What has arrived, inclusief de aanroepen die we hebben geweigerd en waarom.

TipEen endpoint wordt nooit uitgeschakeld alleen omdat afleveringen mislukken. De rij toont hoeveel recente afleveringen zijn mislukt, dus kijk daar eerst als events niet meer binnenkomen. Je kunt ook meerdere endpoints toevoegen — bijvoorbeeld één voor incidenten en een ander voor domeinen.

Deze integratie verplaatst alleen events. Ze leest of beheert geen servers, DNS of domeinen — dat blijft bij de providerintegraties.

#Problemen oplossen

Er komt niets aan bij mijn endpoint. Als je Send every event here hebt uitgevinkt, is het endpoint alleen een bestemming — controleer of er een automatisering naartoe post, en kijk daarna bij Recent deliveries of er überhaupt iets is verstuurd. Als het endpoint is gemarkeerd als Paused, vink Active — deliver events to this endpoint opnieuw aan.

Een aflevering toont Failed. De rij vermeldt wat je endpoint heeft geantwoord, of waarom het niet bereikbaar was. Herstel de ontvanger en selecteer vervolgens Retry.

Mijn ontvanger weigert de aflevering. Waarschijnlijk verifieert deze de handtekening met het verkeerde secret, of op de verkeerde manier. Als je het secret niet meer hebt, roteer je het en kopieer je het nieuwe in je ontvanger.

Mijn tool triggert InfraNest niet. Controleer of deze naar de exacte inkomende URL stuurt, en dat het shared secret — als je er een hebt ingesteld — correct is meegestuurd. Open de pagina van de URL: What has arrived toont elke aanroep, en een geweigerde aanroep vermeldt waarom. Als de URL opnieuw is gegenereerd, stopt de oude direct met werken.