Connecter un webhook personnalisé

Connectez n'importe quel outil capable d'envoyer ou de recevoir des requêtes web à InfraNest, même si nous n'avons pas d'intégration prête à l'emploi pour celui-ci. Ceci s'adresse à toute personne souhaitant que des événements soient envoyés vers son propre système, ou souhaitant qu'un autre outil pilote InfraNest.

Vue d'ensemble

• Les événements peuvent partir vers une URL que vous possédez, et une URL que nous générons permet à n'importe quel outil de déclencher une automatisation ici.
• Vous pouvez configurer un seul sens, ou les deux — l'envoi et la réception sont indépendants.
• Aucun identifiant ni clé d'API n'est nécessaire dans un sens comme dans l'autre.

De quel sens avez-vous besoin ?

• Si quelque chose se produit dans InfraNest et que vous voulez que votre système en soit informé, vous devez envoyer des événements vers l'extérieur.
• Si quelque chose se produit dans votre système et que vous voulez qu'InfraNest réagisse, vous devez 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 — c'est pourquoi elles se trouvent ici, 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 Intégrations → Custom webhook.
2. Sous Where events go, sélectionnez Add endpoint et collez l'URL sur laquelle votre propre système écoute.
3. Copiez le secret de signature affiché une seule fois après l'enregistrement, et transmettez-le à votre récepteur afin qu'il puisse vérifier que la requête provient bien d'InfraNest.
4. Sélectionnez Send test event et choisissez un événement à imiter, afin de confirmer que votre récepteur l'accepte avant de vous y fier.
5. Choisissez ce qui est envoyé : sous Start an automation that posts to Custom webhook, choisissez un point de départ ou rédigez votre propre règle.

NoteAjouter l'endpoint n'envoie rien en soi — cela indique seulement où envoyer. Une automatisation détermine ce qui est envoyé, c'est pourquoi l'étape 5 est importante. Une règle peut couvrir tous les événements, ou vous pouvez la restreindre à ceux qui vous intéressent.

Laisser quelque chose déclencher InfraNest

1. Allez dans Intégrations → Custom webhook → URLs we give you et sélectionnez Add incoming URL.
2. Donnez-lui un Name que vous reconnaîtrez plus tard — vous la choisirez par son nom lors de la rédaction de la règle.
3. Définissez éventuellement un Shared secret (Optional). Si un secret est défini, InfraNest n'accepte que les appels qui l'envoient dans l'en-tête de la requête, de sorte qu'une URL divulguée seule ne suffit pas.
4. Copiez Your URL et collez-la dans l'autre outil, configuré pour envoyer des requêtes.
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 un moniteur en pause, résoudre un incident.

Bon à savoir

• Aucun identifiant n'est nécessaire. Vous fournissez une URL vers laquelle InfraNest publie, et InfraNest génère une URL pour vous. Il n'y a aucun jeton d'API à créer.
• Le secret de signature est affiché une seule fois et jamais plus. Vous pouvez le régénérer plus tard ; l'ancien cesse immédiatement de fonctionner.
• Votre 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.
• Accept calls to this URL désactive une URL entrante sans la supprimer ni affecter les autres.
• Les deux sens conservent un journal de livraison sous Recent deliveries, ce qui vous permet de 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.

WarningVotre URL entrante agit comme un mot de passe — quiconque la possède peut déclencher des automatisations dans votre compte. En cas de fuite, utilisez immédiatement Regenerate URL.

Dépannage

Rien n'arrive à mon endpoint. L'endpoint seul n'est qu'une destination. Vérifiez qu'une automatisation y publie effectivement, puis consultez Recent deliveries pour voir si InfraNest a envoyé quoi que ce soit.

Mon récepteur 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 — régénérez-le et copiez le nouveau dans votre récepteur.

Mon outil ne déclenche pas InfraNest. Vérifiez qu'il envoie bien les requêtes vers l'URL entrante exacte, et que le secret partagé — si vous en avez défini un — est correctement inclus. Si l'URL a été régénérée, l'ancienne cesse immédiatement de fonctionner.