Connecter un webhook personnalisé

Connectez n’importe quel outil capable d’envoyer ou de recevoir des requêtes web à InfraNest, sans attendre une intégration native. Ceci s’adresse à toute personne souhaitant relier des systèmes personnalisés ou moins courants à InfraNest.

Vue d’ensemble

• Envoyez les événements InfraNest vers une URL que votre système écoute.
• Laissez un autre outil déclencher des actions dans InfraNest à l’aide d’une URL que nous générons pour vous.
• Les deux directions sont indépendantes — configurez l’une, les deux, ou aucune.

De quelle direction avez-vous besoin ?

• « Quand quelque chose se produit dans InfraNest, prévenir mon système » → envoyer des événements vers l’extérieur.
• « Quand quelque chose se produit dans mon système, faire quelque chose dans InfraNest » → laisser quelque chose déclencher InfraNest.

Les URL entrantes ne sont liées à aucun outil en particulier — tout ce qui peut envoyer une requête peut en utiliser une — elles se trouvent donc sur la page Custom webhook, et les pages Zapier, Make et n8n y renvoient.

Envoyer des événements vers l’extérieur

1. Allez dans Integrations → Custom webhook.
2. Sous Where events go, sélectionnez Add endpoint et collez l’URL que votre propre système écoute. Laissez Send every event here coché, afin que chaque événement soit envoyé dès le départ.
3. Copiez le secret de signature affiché une seule fois après l’enregistrement, et transmettez-le à votre destinataire afin qu’il puisse vérifier que la requête provient bien de nous.
4. Sélectionnez Send test event et choisissez un événement à imiter, afin de confirmer que votre destinataire l’accepte avant d’en dépendre.
5. Choisissez ce qui est envoyé : 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 Start an automation that posts to Custom webhook ou créez votre propre règle.

Laisser quelque chose déclencher InfraNest

1. Allez dans Integrations → Custom webhook → URLs we give you et sélectionnez Add incoming URL.
2. Donnez-lui un Name que vous reconnaîtrez plus tard — vous le sélectionnez par son nom lors de la rédaction de la règle.
3. Définissez éventuellement un Shared secret (optional). Une fois défini, nous n’acceptons que les appels qui l’envoient dans l’en-tête X-InfraNest-Secret, de sorte qu’une URL divulguée seule ne suffit pas.
4. Copiez Your URL et collez-la dans l’autre outil, configuré en POST.
5. De retour dans InfraNest, utilisez Start an automation Custom webhook can trigger et ajoutez ce qui doit se produire — ouvrir une fenêtre de maintenance, mettre en pause un moniteur, résoudre un incident.

NoteAucun identifiant n’est nécessaire pour cette intégration. Vous fournissez une URL vers laquelle nous publions, et nous générons une URL pour vous — il n’y a aucune clé d’API à créer.

WarningVotre URL entrante fonctionne comme un mot de passe. Quiconque la possède peut déclencher les automatisations de votre organisation. Définissez un secret partagé, et utilisez Regenerate URL en cas de fuite.

Astuces

• Le secret de signature n’est affiché qu’une seule fois et jamais plus. Vous pouvez le renouveler plus tard ; l’ancien cesse de fonctionner immédiatement.
• Accept calls to this URL désactive une URL entrante sans la supprimer ni toucher aux autres.
• Les deux directions conservent un journal des livraisons sous Recent deliveries, afin que vous puissiez voir ce qui a été envoyé, ce qui est arrivé, et ce que votre endpoint a répondu.
• Vous pouvez ajouter plusieurs endpoints — par exemple un pour les incidents et un autre pour les domaines.
• Cette intégration ne fait que transmettre des événements. Elle ne lit ni ne gère les serveurs, le DNS ou les domaines — cela reste du ressort des intégrations fournisseurs.

Dépannage

Rien n’arrive à mon endpoint. Si vous avez décoché Send every event here, l’endpoint seul n’est qu’une destination — vérifiez qu’une automatisation y publie, puis consultez Recent deliveries pour voir si quelque chose a été envoyé.

Mon destinataire rejette la livraison. Il vérifie la signature avec le mauvais secret. Le secret de signature est affiché une seule fois lors de l’enregistrement de l’endpoint — renouvelez-le et copiez le nouveau dans votre destinataire.

Mon outil ne déclenche pas InfraNest. Vérifiez qu’il envoie bien une requête POST 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. Si l’URL a été régénérée, l’ancienne cesse de fonctionner immédiatement.