Verbind n8n

Verbind n8n met InfraNest zodat beide tools acties in elkaar kunnen starten — voor iedereen die workflows bouwt in n8n en deze wil koppelen aan infrastructuurmeldingen.

#Overzicht

• Start een n8n-workflow wanneer een domein verloopt, een monitor uitvalt of een certificaat bijna verloopt.
• Laat een n8n-workflow een onderhoudsvenster openen, een monitor pauzeren of een incident oplossen in InfraNest.
• Beide richtingen werken met een URL die je tussen de twee tools kopieert, 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 is, dus leveringen stoppen zodra je hem sluit.

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

#Stuur InfraNest-gebeurtenissen naar n8n

1. Ga naar Integrations → n8n en selecteer Add endpoint. Voordat er iets is ingesteld, staat dit op de kaart Set up n8n; daarna onder Where events go op het tabblad Connections & settings.

2. Plak de Production URL in Endpoint URL. Laat Send every event here aangevinkt, zodat elke gebeurtenis vanaf het begin wordt verstuurd, en selecteer Create.

3. Kopieer het signing secret dat eenmalig wordt getoond na het opslaan, als je wilt verifiëren dat leveringen echt van InfraNest komen.

4. Kies op de pagina van het endpoint een gebeurtenis in de lijst naast Send test event, en selecteer vervolgens Send test event. Je kunt je workflow dan bouwen op basis van een echte payload.

5. Kies wat er wordt verstuurd: onder Automations that post here toont de pagina van het endpoint de automatisering Send everything to … die hij is gestart. Open deze om hem te beperken tot de gebeurtenissen die je interesseren — of, als je het vakje hebt uitgevinkt, kies een startpunt onder Or start from a ready-made automation: of bouw je eigen regel.

#Laat n8n InfraNest activeren

1. Ga naar Integrations → Custom webhook en selecteer Add incoming URL (onder URLs we give you op het tabblad Connections & settings, zodra daar iets is ingesteld). Inkomende URL's horen bij geen enkele specifieke tool, dus ze staan daar: op de n8n-pagina brengt Open incoming URLs je ernaartoe.
2. Geef het een Name die je later herkent — je kiest hem op naam bij het schrijven van de regel.
3. Stel eventueel een Shared secret (optional) in, zodat een gelekte URL op zichzelf niet genoeg is om iets te activeren.

4. Kopieer Your URL naar een HTTP Request-node in je workflow, ingesteld op POST, met de body verstuurd als JSON. Als je een secret hebt ingesteld, voeg deze toe als de header X-InfraNest-Secret.
5. Start terug 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. Wat de workflow heeft verstuurd, is beschikbaar in de regel als {{payload.your_field}}.

#Tips

TipJe kunt meer dan één endpoint toevoegen — bijvoorbeeld één workflow voor incidenten en een andere voor domeinen.

#Goed om te weten

• 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 hem heeft, kan de automatiseringen van je workspace activeren, dus stel een shared secret in en gebruik Regenerate URL als hij lekt.
• What went out staat vermeld onder Recent deliveries, op de pagina van het endpoint en op het tabblad Activity van de n8n-pagina, met wat n8n antwoordde. Een mislukte levering heeft een knop Retry.
• What came in staat vermeld onder What has arrived op de pagina van de inkomende URL, inclusief oproepen die InfraNest heeft geweigerd en waarom.
• Voor wat een levering bevat en hoe je de handtekening controleert, zie Een aangepaste webhook verbinden.

#Problemen oplossen

Leveringen 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 adres kunnen bereiken vanaf internet — controleer dat het adres publiek oplosbaar is en niet achter een VPN, een alleen-lokale firewallregel of een allowlist staat. Het leveringslogboek op de n8n-pagina toont de ontvangen fout.

Je workflow activeert InfraNest niet. Controleer dat de HTTP Request-node naar de exacte inkomende URL post, en dat het shared secret — als je er een hebt ingesteld — wordt verstuurd als de header X-InfraNest-Secret. Open vervolgens de pagina van de inkomende URL: What has arrived toont elke oproep, en een geweigerde oproep vermeldt waarom. Stuur de body als JSON — in elk ander formaat komt hij leeg aan.