n8n verbinden

Verbind n8n met InfraNest om automatisch te reageren op infrastructuurgebeurtenissen, en om je eigen workflows InfraNest in ruil daarvoor te laten aansturen. Dit is voor iedereen die wil dat meldingen en routinematige fixes zichzelf afhandelen in plaats van handmatig te worden opgepakt.

Overzicht

• Start een n8n-workflow op het moment dat een domein verloopt, een monitor down gaat of een certificaat op het punt staat te verlopen.
• Laat een n8n-workflow een onderhoudsvenster openen, een monitor pauzeren of een incident oplossen in InfraNest.
• Beide richtingen werken door een webadres tussen de twee tools te kopiëren — geen programmeerwerk nodig.
• Werkt op dezelfde manier, of je n8n nu cloud-hosted of self-hosted is.

Voordat je begint

1. Voeg in n8n een Webhook-node toe aan een workflow.
2. Kopieer de Production URL — niet de Test URL. De testURL luistert alleen zolang de editor open staat, dus leveringen stoppen zodra je die sluit.

NoteAls je n8n zelf host, moet dat adres bereikbaar zijn vanaf internet, zodat InfraNest ernaar kan leveren.

InfraNest-gebeurtenissen naar n8n sturen

1. Ga naar Integrations → n8n.
2. Selecteer Add endpoint en plak de Production URL.
3. Kopieer het ondertekeningsgeheim dat één keer na het opslaan wordt getoond, als je wilt verifiëren dat leveringen echt van InfraNest komen.
4. Selecteer Send test event en kies de gebeurtenis die het moet nabootsen, zodat je workflow kan worden gebouwd op basis van een echte payload.
5. Kies wat er wordt verstuurd: onder Start an automation that posts to n8n kies je een startpunt zoals Send everything to my system, of bouw je je eigen regel.

WarningHet toevoegen van het endpoint verstuurt op zichzelf niets — het vertelt InfraNest waarheen te versturen. Een automatisering bepaalt wat er wordt verstuurd, en daarom is stap 5 belangrijk. Eén regel kan elke gebeurtenis afdekken, of je kunt hem beperken tot de gebeurtenissen die je interesseren.

n8n InfraNest laten activeren

1. Ga naar Integrations → Custom webhook → URLs we give you en selecteer Add incoming URL.
2. Geef hem een naam die je later herkent — je kiest hem op naam bij het schrijven van de regel.
3. Stel eventueel een gedeeld geheim in, zodat een uitgelekte URL alleen niet genoeg is om iets te activeren.
4. Kopieer Your URL naar een HTTP Request-node in je workflow, ingesteld op POST.
5. Gebruik terug in InfraNest Start an automation n8n can trigger en voeg toe wat er moet gebeuren — een onderhoudsvenster openen, een monitor pauzeren, een incident oplossen.

Tips

• Het ondertekeningsgeheim wordt één keer getoond en daarna nooit meer. Je kunt het later roteren; het oude stopt onmiddellijk met werken.
• Je binnenkomende URL werkt als een wachtwoord. Iedereen die hem in handen heeft kan de automatiseringen van je organisatie activeren, dus stel een gedeeld geheim in en regenereer de URL als hij uitlekt.
• Beide richtingen houden een leveringslogboek bij op de integratiepagina, zodat je kunt zien wat er is verstuurd en wat er is aangekomen.
• Je kunt meer dan één endpoint toevoegen — bijvoorbeeld één workflow voor incidenten en een andere voor domeinen.

Problemen oplossen

Leveringen stoppen wanneer je de n8n-editor verlaat. Dat is de Test URL. Verwissel het endpoint voor de Production URL van de node en activeer de workflow.

Er komt niets aan, en n8n is self-hosted. InfraNest moet het adres kunnen bereiken vanaf internet — controleer of het adres publiek resolvet en niet achter een VPN, een lokale firewallregel of een allowlist staat. Het leveringslogboek op de n8n-pagina toont de ontvangen foutmelding.

Je workflow activeert InfraNest niet. Bevestig dat de HTTP Request-node naar de exacte binnenkomende URL post, en dat het gedeelde geheim — als je er een hebt ingesteld — wordt verstuurd als de X-InfraNest-Secret-header.