Connecter n8n

Connectez n8n à InfraNest pour que les deux outils puissent déclencher des actions l’un chez l’autre — pour quiconque crée des workflows dans n8n et souhaite les lier à ses alertes d’infrastructure.

#Vue d’ensemble

• Démarrez un workflow n8n lorsqu’un domaine expire, qu’un moniteur tombe ou qu’un certificat est sur le point d’arriver à échéance.
• Laissez un workflow n8n ouvrir une fenêtre de maintenance, mettre en pause un moniteur ou résoudre un incident dans InfraNest.
• Les deux sens fonctionnent avec une URL que vous copiez entre les deux outils, que votre n8n soit hébergé dans le cloud ou auto-hébergé.

#Avant de commencer

1. Dans n8n, ajoutez un nœud Webhook à un workflow.
2. Copiez son Production URL — pas la Test URL. L’URL de test n’écoute que tant que l’éditeur est ouvert, donc les envois s’arrêtent dès que vous le fermez.

NoteSi vous auto-hébergez n8n, cette adresse doit être accessible depuis Internet pour qu’InfraNest puisse lui livrer des données.

#Envoyer les événements InfraNest vers n8n

1. Allez dans Integrations → n8n et sélectionnez Add endpoint. Avant toute configuration, ce bouton se trouve sur la carte Set up n8n ; ensuite, il se trouve sous Where events go dans l’onglet Connections & settings.

2. Collez le Production URL dans Endpoint URL. Laissez Send every event here coché, afin que chaque événement soit envoyé dès le départ, puis sélectionnez Create.

3. Copiez le signing secret affiché une seule fois après l’enregistrement, si vous souhaitez vérifier que les envois proviennent bien d’InfraNest.

4. Sur la page de l’endpoint, choisissez un événement dans la liste à côté de Send test event, puis sélectionnez Send test event. Votre workflow peut ensuite être construit à partir d’une charge utile réelle.

5. Choisissez ce qui est envoyé : sous Automations that post here, la page de l’endpoint liste l’automatisation Send everything to … qu’elle a démarrée. Ouvrez-la pour la restreindre aux événements qui vous intéressent — ou, si vous avez décoché la case, choisissez un point de départ sous Or start from a ready-made automation: ou créez votre propre règle.

#Laisser n8n déclencher InfraNest

1. Allez dans Integrations → Custom webhook et sélectionnez Add incoming URL (sous URLs we give you dans l’onglet Connections & settings, une fois qu’une configuration y existe). Les URL entrantes n’appartiennent à aucun outil en particulier, elles se trouvent donc là : sur la page n8n, Open incoming URLs vous y amène.
2. Donnez-lui un Name que vous reconnaîtrez plus tard — vous le choisirez par nom en écrivant la règle.
3. Définissez éventuellement un Shared secret (optional), afin qu’une URL divulguée ne suffise pas à elle seule à déclencher quoi que ce soit.

4. Copiez Your URL dans un nœud HTTP Request de votre workflow, configuré en POST, avec le corps envoyé en JSON. Si vous avez défini un secret, ajoutez-le comme en-tête X-InfraNest-Secret.
5. De retour dans InfraNest, démarrez une automatisation depuis Let another tool trigger an automation (ou avec le déclencheur Incoming webhook) et ajoutez ce qui doit se produire — ouvrir une fenêtre de maintenance, mettre en pause un moniteur, résoudre un incident. Ce que le workflow a envoyé est disponible dans la règle sous la forme {{payload.your_field}}.

#Astuces

TipVous pouvez ajouter plusieurs endpoints — par exemple un workflow pour les incidents et un autre pour les domaines.

#Bon à savoir

• Le signing secret n’est affiché qu’une seule fois. Rotate signing secret sur la page de l’endpoint vous en donne un nouveau ; l’ancien cesse immédiatement de fonctionner.
• Votre URL entrante fonctionne comme un mot de passe. Quiconque la détient peut déclencher les automatisations de votre espace de travail, donc définissez un secret partagé et utilisez Regenerate URL en cas de fuite.
• What went out est listé sous Recent deliveries, sur la page de l’endpoint et dans l’onglet Activity de la page n8n, avec la réponse de n8n. Un envoi en échec dispose d’un bouton Retry.
• What came in est listé sous What has arrived sur la page de l’URL entrante, y compris les appels qu’InfraNest a refusés et pourquoi.
• Pour savoir ce que contient un envoi et comment vérifier sa signature, consultez Connecter un webhook personnalisé.

#Dépannage

Les envois s’arrêtent quand vous quittez l’éditeur n8n. C’est la Test URL. Remplacez l’endpoint par le Production URL du nœud et activez le workflow.

Rien n’arrive, et n8n est auto-hébergé. InfraNest doit pouvoir l’atteindre depuis Internet — vérifiez que l’adresse se résout publiquement et n’est pas derrière un VPN, une règle de pare-feu locale uniquement ou une liste d’autorisation. Le journal d’envoi sur la page n8n affiche l’erreur reçue.

Votre workflow ne déclenche pas InfraNest. Vérifiez que le nœud HTTP Request envoie bien vers l’URL entrante exacte, et que le secret partagé — si vous en avez défini un — est envoyé comme en-tête X-InfraNest-Secret. Ouvrez ensuite la page de l’URL entrante : What has arrived liste chaque appel, et un appel refusé en indique la raison. Envoyez le corps en JSON — tout autre format arrive vide.