Cet article explique la différence entre les deux façons dont InfraNest communique avec d'autres outils, et vous aide à choisir la bonne selon ce que vous voulez faire.
Vue d'ensemble
- Un point de terminaison entrant permet à un autre outil de déclencher quelque chose dans InfraNest.
- Un webhook sortant permet à InfraNest d'informer un autre outil qu'un événement s'est produit.
- Savoir quelle direction vous voulez fait gagner du temps — la configuration de chacun se trouve à un endroit différent.
Lequel vous faut-il ?
| Point de terminaison entrant | Webhook sortant | |
|---|---|---|
| Direction | autre outil → InfraNest | InfraNest → autre outil |
| Vous transmettez | une URL générée par InfraNest | une URL fournie par l'autre outil |
| Utilisez-le pour | laisser autre chose démarrer une automatisation | informer autre chose qu'un événement s'est produit |
| Configuration dans | l'intégration, ou votre automatisation | Paramètres → Webhooks |
En résumé : un point de terminaison entrant est une sonnette que quelqu'un d'autre appuie. Un webhook sortant, c'est nous qui sonnons chez eux.
Configurer un point de terminaison entrant
- Ouvrez l'intégration ou l'automatisation où vous voulez qu'un autre outil puisse démarrer des actions.
- Créez le point de terminaison — InfraNest génère une URL privée pour vous.
- Donnez un nom au point de terminaison afin de savoir en un coup d'œil à quel outil il appartient.
- Copiez l'URL et collez-la dans les paramètres de l'autre outil, partout où une URL à appeler est demandée.
- Utilisez ce que l'autre système envoie comme données de déclenchement pour la règle de votre automatisation.
Comme les points de terminaison sont nommés, vous pouvez en désactiver un seul sans affecter les autres.
WarningL'URL elle-même constitue l'identifiant d'accès. Toute personne qui la possède peut déclencher cette automatisation, alors traitez-la comme un mot de passe — et régénérez-la si jamais elle fuit.
Configurer un webhook sortant
- Allez dans Paramètres → Webhooks.
- Choisissez Ajouter pour créer un nouveau webhook.
- Collez l'URL que l'autre outil vous a fournie.
- Choisissez les événements que vous voulez qu'InfraNest envoie — par exemple un moniteur qui tombe en panne, un domaine qui se renouvelle, ou un domaine surveillé qui devient disponible.
- Enregistrez vos modifications.
Chaque envoi est signé et journalisé, ce qui vous permet de vérifier ce qui a été envoyé et s'il est arrivé. Consultez l'article Webhooks pour plus de détails.
Toujours pas sûr de ce qu'il vous faut ?
Demandez-vous quel côté démarre la conversation :
- « Quand X se produit dans mon autre outil, faire quelque chose dans InfraNest » → utilisez un point de terminaison entrant.
- « Quand X se produit dans InfraNest, informer mon autre outil » → utilisez un webhook sortant.
- « Les deux » → il vous en faudra un de chaque ; ils fonctionnent indépendamment l'un de l'autre.
Conseils
NoteCes deux fonctionnalités sont totalement indépendantes en interne — configurer l'une n'a aucun effet sur l'autre, donc vous pouvez très bien n'en utiliser qu'une, les deux, ou aucune.
Cet article vous a-t-il été utile ?