Een aangepaste webhook verbinden

Verbind elke tool die webverzoeken kan versturen of ontvangen met InfraNest, zelfs als we er geen kant-en-klare integratie voor hebben. Dit is voor iedereen die events naar zijn eigen systeem wil sturen, of een andere tool InfraNest wil laten aansturen.

Overzicht

• Events kunnen naar een URL gaan die je zelf beheert, en een URL die wij genereren laat elke tool hier een automatisering activeren.
• Je kunt één richting instellen, of allebei — versturen en ontvangen zijn onafhankelijk van elkaar.
• Voor geen van beide richtingen is een inloggegeven of API-sleutel nodig.

Welke richting heb je nodig?

• Als er iets gebeurt in InfraNest en je wilt dat jouw systeem daarvan op de hoogte wordt gesteld, moet je events naar buiten sturen.
• Als er iets gebeurt in jouw systeem en je wilt dat InfraNest daarop reageert, moet je iets InfraNest laten activeren.

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

Events naar buiten sturen

1. Ga naar Integraties → Custom webhook.
2. Selecteer onder Where events go de optie Add endpoint en plak de URL waarop jouw eigen systeem luistert.
3. Kopieer het ondertekeningsgeheim dat één keer wordt getoond na het opslaan, en geef dit aan je ontvanger zodat die kan verifiëren dat het verzoek echt van InfraNest komt.
4. Selecteer Send test event en kies een event om na te bootsen, zodat je kunt bevestigen dat je ontvanger het accepteert voordat je erop vertrouwt.
5. Kies wat er wordt verstuurd: kies onder Start an automation that posts to Custom webhook een startpunt of schrijf je eigen regel.

NoteHet toevoegen van het endpoint stuurt op zichzelf niets — het geeft alleen aan waarnaartoe verstuurd moet worden. Een automatisering bepaalt wat er wordt verstuurd, daarom is stap 5 belangrijk. Eén regel kan alle events dekken, of je kunt hem beperken tot de events die je belangrijk vindt.

Iets InfraNest laten activeren

1. Ga naar Integraties → Custom webhook → URLs we give you en selecteer Add incoming URL.
2. Geef het een naam die je later herkent — je kiest hem op naam wanneer je de regel schrijft.
3. Stel eventueel een Shared secret in (Optional). Met een ingesteld gedeeld geheim accepteert InfraNest alleen aanroepen die dit in de request-header meesturen, zodat een gelekte URL alleen niet voldoende is.
4. Kopieer Your URL en plak deze in de andere tool, ingesteld om verzoeken te versturen.
5. Gebruik 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.

Goed om te weten

• Er is geen inloggegeven nodig. Jij geeft een URL op waar InfraNest naartoe post, en InfraNest genereert een URL voor jou. Er is geen API-token om aan te maken.
• Het ondertekeningsgeheim wordt één keer getoond en daarna nooit meer. Je kunt het later roteren; het oude geheim stopt onmiddellijk met werken.
• Je inkomende URL werkt als een wachtwoord. Iedereen die deze bezit, kan de automatiseringen van je organisatie activeren — stel een gedeeld geheim in en gebruik Regenerate URL als hij lekt.
• Accept calls to this URL schakelt één inkomende URL uit zonder deze te verwijderen of de andere te beïnvloeden.
• Beide richtingen houden een bezorglog bij onder Recent deliveries, zodat je kunt zien wat er is verstuurd, wat er is aangekomen en wat jouw endpoint heeft geantwoord.
• Je kunt meerdere endpoints toevoegen — bijvoorbeeld één voor incidenten en één voor domeinen.
• Deze integratie verplaatst alleen events. Ze leest of beheert geen servers, DNS of domeinen — dat blijft bij de providerintegraties.

WarningJe inkomende URL werkt als een wachtwoord — iedereen die deze bezit, kan automatiseringen in je account activeren. Gebruik bij een lek meteen Regenerate URL.

Problemen oplossen

Er komt niets binnen op mijn endpoint. Het endpoint alleen is slechts een bestemming. Controleer of een automatisering er daadwerkelijk naar post, en bekijk dan Recent deliveries om te zien of InfraNest überhaupt iets heeft verstuurd.

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

Mijn tool activeert InfraNest niet. Controleer of deze verzoeken naar exact de juiste inkomende URL stuurt, en dat het gedeelde geheim — als je er een hebt ingesteld — correct wordt meegestuurd. Als de URL opnieuw is gegenereerd, stopt de oude direct met werken.