Connecter n8n

Connectez n8n à InfraNest pour réagir automatiquement aux événements d'infrastructure, et pour laisser vos propres workflows contrôler InfraNest en retour. C'est fait pour toute personne qui souhaite que les alertes et les corrections de routine s'exécutent d'elles-mêmes plutôt que d'être traitées manuellement.

Aperçu

• Démarrez un workflow n8n au moment même où un domaine arrive à expiration, un moniteur tombe en panne, ou un certificat est sur le point d'expirer.
• 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 en copiant une adresse web entre les deux outils — sans aucune programmation.
• Fonctionne de la même manière, 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 sa Production URL — pas la Test URL. L'URL de test n'écoute que tant que l'éditeur est ouvert, donc les livraisons 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 y livrer.

Envoyer les événements InfraNest vers n8n

1. Allez dans Integrations → n8n.
2. Sélectionnez Add endpoint et collez la Production URL.
3. Copiez le secret de signature affiché une seule fois après l'enregistrement, si vous souhaitez vérifier que les livraisons proviennent bien d'InfraNest.
4. Sélectionnez Send test event et choisissez l'événement qu'il doit imiter, afin que votre workflow puisse être construit à partir d'une charge utile réelle.
5. Choisissez ce qui est envoyé : sous Start an automation that posts to n8n, choisissez un point de départ comme Send everything to my system, ou créez votre propre règle.

WarningL'ajout du point de terminaison n'envoie rien en soi — il indique à InfraNest où envoyer. Une automatisation décide ce qui est envoyé, c'est pourquoi l'étape 5 est importante. Une règle peut couvrir chaque événement, ou vous pouvez la restreindre à ceux qui vous intéressent.

Laisser n8n déclencher InfraNest

1. Allez dans Integrations → Custom webhook → URLs we give you et sélectionnez Add incoming URL.
2. Donnez-lui un nom que vous reconnaîtrez plus tard — vous le choisissez par nom lors de la rédaction de la règle.
3. Définissez éventuellement un secret partagé, afin qu'une URL divulguée seule ne suffise pas à déclencher quoi que ce soit.
4. Copiez Your URL dans un nœud HTTP Request de votre workflow, configuré en POST.
5. De retour dans InfraNest, utilisez Start an automation n8n can trigger et ajoutez ce qui doit se produire — ouvrir une fenêtre de maintenance, mettre en pause un moniteur, résoudre un incident.

Astuces

• Le secret de signature est affiché une seule fois et jamais plus. Vous pouvez le régénérer plus tard ; l'ancien cesse de fonctionner immédiatement.
• Votre URL entrante fonctionne comme un mot de passe. Toute personne qui la détient peut déclencher les automatisations de votre organisation, alors définissez un secret partagé et régénérez l'URL si elle est divulguée.
• Les deux sens conservent un journal de livraison sur la page d'intégration, afin que vous puissiez voir ce qui a été envoyé et ce qui est arrivé.
• Vous pouvez ajouter plusieurs points de terminaison — par exemple un workflow pour les incidents et un autre pour les domaines.

Dépannage

Les livraisons s'arrêtent lorsque vous quittez l'éditeur n8n. C'est la Test URL. Remplacez le point de terminaison par la 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 blanche. Le journal de livraison sur la page n8n affiche l'erreur reçue.

Votre workflow ne déclenche pas InfraNest. Confirmez 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é dans l'en-tête X-InfraNest-Secret.