Webhooks

Les webhooks permettent à InfraNest d'envoyer des mises à jour en temps réel sur votre infrastructure directement vers vos propres systèmes, afin que vos outils puissent réagir automatiquement au lieu de devoir vérifier manuellement.

Vue d'ensemble

• Les webhooks notifient un point de terminaison que vous contrôlez chaque fois qu'un événement se produit dans InfraNest — comme l'expiration d'un domaine ou une alerte de moniteur.
• Chaque envoi est signé afin que vous puissiez confirmer qu'il provient bien d'InfraNest.
• Les envois échoués sont journalisés et renvoyés automatiquement.

Ajouter un webhook

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

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

Choisir les événements à recevoir

Vous pouvez abonner un webhook à des événements tels que :

• L'expiration d'un domaine
• Un changement de statut de domaine ou de serveur
• Une alerte de moniteur
• Une modification des enregistrements DNS
• Le cycle de vie du drop-catch (expiration prochaine, disponible, enregistré, échoué)

Vérifier les envois

1. Chaque webhook est envoyé sous forme de requête POST, signée avec votre secret via un HMAC dans l'en-tête X-InfraNest-Signature-V2, et horodatée avec X-InfraNest-Timestamp.
2. Utilisez ces en-têtes de votre côté pour confirmer que la requête provient bien d'InfraNest.
3. Les envois de test et les événements réels sont signés de la même manière, vous pouvez donc tester votre configuration en toute sécurité avant de vous y fier.

WarningL'ancien en-tête X-InfraNest-Signature cessera d'être envoyé après le 30 avril 2027. Faites basculer votre récepteur vers X-InfraNest-Signature-V2 avant cette date.

NoteSi un envoi échoue, InfraNest le journalise et le renvoie automatiquement — vous n'avez pas besoin de le renvoyer vous-même.

Autres connexions entrantes

InfraNest accepte également quelques connexions entrantes que vos propres outils appellent, chacune sécurisée par son propre jeton. Exemples :

• Deploy hooks — déclenchez un déploiement depuis votre système CI.
• Mises à jour d'IP dynamique — envoyées depuis votre routeur (voir Set up Dynamic IP).