Webhook n8n : vérifier que la demande est légitime

Un webhook permet à un service externe de déclencher un workflow n8n. Cette simplicité peut devenir un risque si toute personne connaissant l’adresse peut lancer une action métier. Avant de connecter un paiement, un formulaire ou une mise à jour client, il faut vérifier l’émetteur, le contenu reçu et les conséquences autorisées.

Ne pas confondre adresse et autorisation

Une URL difficile à deviner n’est pas une preuve d’identité. Elle peut apparaître dans un journal, un export ou une capture. Le point d’entrée doit utiliser le mécanisme d’authentification adapté au service qui l’appelle et transmettre les informations par une connexion protégée.

La documentation du nœud Webhook de n8n décrit notamment Basic Auth, Header Auth et JWT Auth. Elle propose également une liste d’adresses IP autorisées. Ces options doivent être choisies selon l’intégration ; elles ne valident pas automatiquement toutes les signatures propres aux fournisseurs.

Vérifier la signature lorsqu’elle existe

Certains services signent leurs événements avec un secret et des règles précises. Appliquez leur procédure officielle, notamment sur le corps brut si elle l’exige, avant toute action sensible. Une transformation préalable du message peut empêcher une comparaison correcte.

Un secret partagé dans un en-tête n’apporte pas exactement les mêmes garanties qu’une signature du contenu. Ne substituez pas l’un à l’autre sans comprendre le protocole. Prévoyez aussi la rotation du secret et une manière de tester le refus d’une requête invalide.

Contrôler le contenu même authentifié

Un appel provenant du bon service peut contenir un événement inattendu, incomplet ou ancien. Vérifiez les champs nécessaires, les types et le périmètre. Un identifiant transmis ne doit pas autoriser l’accès à n’importe quel dossier de votre entreprise.

Dans un exemple fictif, une notification de paiement indique un numéro de commande. Le workflow vérifie que cette commande existe et que son état permet la transition avant de déclencher une livraison. Il ne considère pas la simple présence d’un champ « payé » comme une preuve suffisante.

Prévoir les répétitions légitimes

Les services peuvent renvoyer un événement si la réponse tarde ou semble perdue. Conservez son identifiant et rendez le traitement répétable sans doubler la conséquence métier. Une authentification correcte n’empêche pas deux expéditions ou deux créations de dossier.

Les contrôles d’erreurs et doublons dans n8n complètent donc la sécurité du point d’entrée. Testez une même demande plusieurs fois, une demande invalide et une panne au milieu du traitement. La reprise doit connaître ce qui a déjà été réalisé.

Limiter et surveiller les effets

Le compte utilisé par le workflow ne doit disposer que des droits nécessaires. Ne renvoyez pas de secrets ou de détails internes dans les erreurs publiques. Conservez une trace limitée permettant de comprendre les refus et les échecs, sans journaliser inutilement des données sensibles.

Dans un projet d’automatisation, le webhook est une porte d’entrée opérationnelle. La réussite ne consiste pas seulement à recevoir un événement : elle consiste à accepter les bons événements, refuser les autres et garantir qu’une demande autorisée produit une conséquence maîtrisée.