Webhooks

Les webhooks permettent à InfraNest de vous envoyer automatiquement des mises à jour concernant votre infrastructure, afin que vos propres outils et systèmes puissent réagir sans vérification manuelle de votre part.

Aperçu

• Les webhooks transmettent les événements d'InfraNest en temps réel vers une URL de votre choix.
• Utilisez-les pour déclencher des automatisations, des alertes ou des workflows personnalisés dans vos propres systèmes.
• Chaque webhook est fourni avec un secret afin que vous puissiez confirmer que les messages proviennent bien d'InfraNest.

Ajouter un webhook

1. Allez dans Intégrations et ajoutez un point de terminaison.
2. Saisissez l'URL à laquelle envoyer les événements, une description, et choisissez les événements qu'il doit recevoir.

3. Sélectionnez Enregistrer. InfraNest génère un secret que vous utiliserez pour vérifier les requêtes.

Événements

Vous pouvez vous abonner à des événements tels que l'expiration d'un domaine, un changement de statut d'un domaine ou d'un serveur, une alerte de moniteur, des modifications d'enregistrements DNS, et le cycle de vie du drop-catch (libération imminente, disponible, enregistré, échoué).

Vérifier les livraisons

Chaque webhook est envoyé sous forme de requête POST, signée avec votre secret et horodatée, afin que vous puissiez confirmer qu'elle provient bien d'InfraNest. Les livraisons sont enregistrées et automatiquement retentées en cas d'échec.

NoteGardez votre secret de webhook confidentiel — toute personne qui le possède pourrait envoyer de fausses requêtes qui semblent provenir d'InfraNest.

Autres connexions entrantes

InfraNest accepte également quelques connexions entrantes appelées par vos propres outils, chacune avec son propre jeton. Par exemple, les deploy hooks vous permettent de déclencher un déploiement depuis votre système CI, et les mises à jour d'IP dynamique permettent à votre routeur de maintenir une adresse IP à jour (voir IPs dynamiques).

TipSi un webhook cesse de recevoir des événements, consultez d'abord le journal des livraisons — la plupart des échecs y sont enregistrés avec suffisamment de détails pour identifier rapidement le problème.