n8n koppelen

Koppel n8n om automatisch workflows te starten vanuit InfraNest-gebeurtenissen, en laat die workflows ook actie ondernemen terug in InfraNest — handig voor iedereen die wil dat wijzigingen aan domeinen, monitors of certificaten geautomatiseerde stappen in gang zetten zonder handmatig werk.

Overzicht

• Start een n8n-workflow als een domein verloopt, een monitor down gaat of een certificaat bijna verloopt.
• Laat een n8n-workflow een onderhoudsvenster openen, een monitor pauzeren of een incident oplossen in InfraNest.
• Beide richtingen gebruiken een URL die je tussen de twee tools kopieert, en werken 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 afleveringen stoppen zodra je hem sluit.

NoteAls je n8n self-hosted draait, moet dat adres vanaf internet bereikbaar zijn, anders kan InfraNest er niet naartoe leveren.

InfraNest-gebeurtenissen naar n8n sturen

1. Ga naar Integrations → n8n.
2. Selecteer Add endpoint en plak de Production URL. Laat Send every event here aangevinkt staan, zodat elke gebeurtenis vanaf het begin wordt verstuurd.
3. Kopieer het signing secret dat één keer wordt getoond na het opslaan, als je wilt verifiëren dat afleveringen echt van InfraNest kwamen.
4. Selecteer Send test event en kies de gebeurtenis die het moet nabootsen, zodat je workflow gebouwd kan worden op basis van een echte payload.
5. Kies wat er verstuurd wordt: de endpointpagina toont de Send everything to …-automatisering die hiermee gestart is. Open deze om hem te beperken tot de gebeurtenissen die je interesseren — of, als je het vakje hebt uitgevinkt, kies een startpunt onder Start an automation that posts to n8n of bouw je eigen regel.

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 shared secret in, zodat een gelekte URL op zich 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

• Je kunt meer dan één endpoint toevoegen — bijvoorbeeld één workflow voor incidenten en een andere voor domeinen.
• Beide richtingen houden een afleveringslogboek bij op het tabblad Activity van de integratiepagina, zodat je kunt zien wat er is uitgegaan en wat er is aangekomen.

WarningHet signing secret wordt één keer getoond en daarna nooit meer. Je kunt het later vernieuwen; het oude werkt dan onmiddellijk niet meer. Je inkomende URL werkt als een wachtwoord — iedereen die hem heeft kan de automatiseringen van je organisatie activeren, dus stel een shared secret in en genereer de URL opnieuw als hij uitlekt.

Problemen oplossen

Afleveringen stoppen zodra je de n8n-editor verlaat. Dat is de Test URL. Verander het endpoint naar de Production URL van de node en activeer de workflow.

Er komt niets binnen, en n8n is self-hosted. InfraNest moet het vanaf internet kunnen bereiken — controleer of het adres publiek oplosbaar is en niet achter een VPN, een lokale firewallregel of een allowlist zit. Het afleveringslogboek op de n8n-pagina toont de ontvangen fout.

Je workflow activeert InfraNest niet. Controleer of de HTTP Request-node precies naar de incoming URL post, en dat het shared secret — als je er een hebt ingesteld — wordt verstuurd als de X-InfraNest-Secret-header.