Een aangepaste webhook koppelen

Koppel elke tool die webverzoeken kan versturen of ontvangen aan InfraNest, zonder te wachten op een ingebouwde integratie. Dit is voor iedereen die aangepaste of minder gangbare systemen wil koppelen aan InfraNest.

Overzicht

• Stuur InfraNest-events naar een URL waar jouw systeem naar luistert.
• Laat een andere tool acties in InfraNest activeren met een URL die wij voor je genereren.
• De twee richtingen zijn onafhankelijk — stel er één, beide, of geen van beide in.

Welke richting heb je nodig?

• “Als er iets gebeurt in InfraNest, laat mijn systeem het weten” → stuur events naar buiten.
• “Als er iets gebeurt in mijn systeem, doe iets in InfraNest” → laat iets InfraNest activeren.

Inkomende URL's zijn niet aan één tool gebonden — alles dat een verzoek kan versturen kan er een gebruiken — daarom staan ze op de pagina Custom webhook, en verwijzen de pagina's van Zapier, Make en n8n hiernaar terug.

Events naar buiten versturen

1. Ga naar Integrations → Custom webhook.
2. Selecteer onder Where events go de optie Add endpoint en plak de URL waar jouw eigen systeem naar luistert. Laat Send every event here aangevinkt staan, zodat vanaf het begin elk event wordt verstuurd.
3. Kopieer het ondertekeningsgeheim dat eenmalig wordt getoond na het opslaan, en geef dit aan je ontvanger zodat deze kan verifiëren dat het verzoek echt van ons komt.
4. Selecteer Send test event en kies een event om te simuleren, zodat je kunt bevestigen dat je ontvanger het accepteert voordat je erop vertrouwt.
5. Kies wat er wordt verstuurd: de endpointpagina toont de automatisering Send everything to … die hiermee is gestart. Open deze om het te beperken tot de events die je interesseren — of, als je het vakje hebt uitgevinkt, kies een startpunt onder Start an automation that posts to Custom webhook of maak je eigen regel.

Iets InfraNest laten activeren

1. Ga naar Integrations → Custom webhook → URLs we give you en selecteer Add incoming URL.
2. Geef het een Name die je later herkent — je selecteert hem op naam bij het schrijven van de regel.
3. Stel eventueel een Shared secret (optional) in. Met een geheim ingesteld, accepteren we alleen aanroepen die dit meesturen in de X-InfraNest-Secret-header, zodat een uitgelekte URL op zichzelf niet genoeg is.
4. Kopieer Your URL en plak deze in de andere tool, ingesteld op POST.
5. Gebruik terug in InfraNest Start an automation Custom webhook can trigger en voeg toe wat er moet gebeuren — een onderhoudsvenster openen, een monitor pauzeren, een incident oplossen.

NoteVoor deze integratie is geen inloggegeven nodig. Jij levert een URL aan waar wij naartoe posten, en wij genereren een URL voor jou — er is geen API-sleutel om aan te maken.

WarningJe inkomende URL werkt als een wachtwoord. Iedereen die hem heeft kan de automatiseringen van je organisatie activeren. Stel een shared secret in en gebruik Regenerate URL als hij uitlekt.

Tips

• Het ondertekeningsgeheim wordt eenmalig getoond en daarna nooit meer. Je kunt het later roteren; het oude geheim stopt dan direct met werken.
• Accept calls to this URL schakelt één inkomende URL uit zonder deze te verwijderen of de andere te beïnvloeden.
• Beide richtingen houden een bezorglogboek bij onder Recent deliveries, zodat je kunt zien wat er is verstuurd, wat er is aangekomen en wat jouw endpoint heeft geantwoord.
• Je kunt meer dan één endpoint 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 een automatisering ernaar post, en bekijk dan Recent deliveries om te zien of er überhaupt iets is verstuurd.

Mijn ontvanger wijst de bezorging af. Deze verifieert de handtekening met het verkeerde geheim. Het ondertekeningsgeheim wordt eenmalig getoond wanneer het endpoint wordt opgeslagen — roteer het en kopieer het nieuwe geheim naar je ontvanger.

Mijn tool activeert InfraNest niet. Controleer of deze POST't naar de exacte inkomende URL, en of het shared secret — als je er een hebt ingesteld — wordt meegestuurd als de X-InfraNest-Secret-header. Als de URL opnieuw is gegenereerd, stopt de oude direct met werken.