Intégrez et sensibilisez-vous à la sécurité des services externes (API, Webhooks)

Au chapitre précédent, vous avez restreint l'accès des bénévoles grâce à une Interface. Mais cette restriction ne concerne que les personnes. L'automatisation n8n de CulturaLab, elle, lit toute la base Airtable et envoie des données à l'outil de billetterie à chaque nouvelle inscription. Si la clé qui lui ouvre la base se retrouve entre de mauvaises mains, tous les filtres de l'Interface deviennent inutiles.

Ce chapitre vous apprend à repérer ces risques. Vous verrez comment n8n échange avec les autres outils, comment vérifier les données qu'il transmet, puis à quoi ressemble un workflow sécurisé. L'objectif n'est pas de devenir développeur, mais de savoir poser les bonnes questions avant la mise en production. 

Comprenez comment n8n échange avec les autres outils

n8n propose des nœuds prêts à l'emploi pour les outils les plus courants, dont Airtable. Quand un outil n'a pas de nœud dédié, comme l'outil de billetterie de CulturaLab, on utilise le nœud HTTP Request. Il envoie une requête à l'API de l'outil, avec l'adresse de l'endpoint, la clé d'API et les données à transmettre.

Dans les deux cas, n8n doit présenter une clé d'API pour accéder à l'outil. Cette clé est donc enregistrée quelque part dans le workflow. Si elle y est écrite en clair, toute personne qui ouvre le workflow, ou qui en reçoit une copie, peut la lire et s'en servir pour accéder à toute la base Airtable, sans passer par l'Interface. Vous verrez plus loin dans ce chapitre où ranger cette clé pour éviter ce risque.

Deux modes d'échange coexistent dans le workflow d'inscription de CulturaLab :

  • avec une API, n8n va chercher l'information : il interroge Airtable pour récupérer la fiche de l'adhérent. On parle de mode pull ;

  • avec un webhook, c'est l'autre outil qui envoie l'information : le formulaire d'inscription prévient n8n dès qu'un adhérent s'inscrit à un événement. On parle de mode push.

API (pull)

Webhook (push)

Qui prend l'initiative ?

n8n appelle l'outil

L'outil appelle n8n

Exemple chez CulturaLab

n8n lit la fiche de l'adhérent dans Airtable

Le formulaire signale une nouvelle inscription

Ce qu'il faut protéger

La clé d'API que n8n présente

L'adresse du webhook, que n'importe qui pourrait appeler

Ce dernier point est souvent oublié. Un webhook est une adresse ouverte sur Internet. Si elle n'est pas protégée, quelqu'un qui la connaît peut envoyer de fausses inscriptions à n8n, qui les traitera comme des vraies.

Contrôlez les données transmises

Quand n8n envoie une inscription à l'outil de billetterie, il faut indiquer quel champ d'Airtable correspond à quel champ de la billetterie. Cette correspondance s'appelle le mapping. C'est aussi à cette étape que s'applique le principe de minimisation vu au chapitre précédent : la billetterie n'a besoin que de quelques informations.

Voici le mapping attendu pour CulturaLab :

Champ Airtable

Champ de la billetterie

À transmettre ?

Prénom + Nom

Nom complet

Oui, en combinant les deux champs

E-mail

E-mail

Oui

Événement choisi

Événement

Oui

Téléphone, adresse, date de naissance

—

Non, la billetterie n'en a pas besoin

Notes internes

—

Non, jamais

Le réflexe le plus risqué consiste à transmettre la fiche entière « pour ne rien oublier ». L'outil de billetterie conserve alors une copie complète des données des adhérents, qu'il faudra supprimer aussi.

Repérez un workflow sécurisé

Un workflow peut fonctionner parfaitement et rester mal protégé. Pour juger de sa sécurité, regardez-le sous quatre angles :

  • le stockage des clés : où la clé d'API est-elle enregistrée ?

  • l'authentification : quels droits la clé donne-t-elle, et sur quoi ?

  • la protection du webhook : qui peut appeler l'adresse du webhook ?

  • les effets : que se passe-t-il si la clé fuite ?

Le tableau suivant compare deux versions du workflow d'inscription de CulturaLab :

Workflow non sécurisé

Workflow sécurisé

Stockage des clés

La clé est écrite en clair dans l'URL ou dans les paramètres du nœud HTTP Request.

La clé est enregistrée dans les Credentials de n8n, le coffre-fort intégré à l'outil.

Authentification

Un jeton Airtable avec tous les droits, sur toutes les bases du compte.

Un jeton limité à la base CulturaLab et aux seules actions nécessaires.

Protection du webhook

L'adresse du webhook accepte toutes les requêtes.

Le webhook exige un jeton secret, et vérifie si possible une signature HMAC envoyée par l'outil.

Effets en cas de fuite

Accès complet à toutes les bases, sans que personne le remarque.

Accès limité à une base, et la clé peut être révoquée puis remplacée.

La première ligne est la plus importante. L'OWASP, l'organisation de référence en sécurité des applications web, le répète dans ses recommandations : une clé ne doit jamais être écrite directement dans un workflow ou dans du code. Un workflow n8n s'exporte, se duplique et se partage facilement ; une clé écrite en clair voyage avec lui. Pour découvrir l'OWASP et ses recommandations, vous pouvez suivre le cours Sécurisez vos applications web avec le Top 10 OWASP. 

La signature HMAC mérite un mot d'explication. Certains outils signent chaque message qu'ils envoient au webhook avec une clé secrète partagée. n8n recalcule la signature à la réception : si elle ne correspond pas, le message ne vient pas du bon expéditeur. Vous n'aurez pas à la configurer dans ce cours, mais vous devez savoir la demander.

À vous de jouer

Avant de brancher le workflow d'inscription sur la billetterie, la présidente de CulturaLab vous demande un avis écrit : peut-on le mettre en production tel quel ? Pour vous aider, voici deux configurations fictives envisagées pour l'automatisation. Elles sont décrites ci-dessous : vous n'avez pas besoin d'ouvrir ou de configurer un workflow n8n.

Configuration A
  • Une fausse clé est écrite en clair dans l'URL du nœud HTTP Request. Le jeton Airtable possède tous les droits sur toutes les bases.

  • Le webhook accepte les requêtes sans authentification.

  • L'automatisation transmet toute la fiche de l'adhérent à la billetterie.

  • Aucun renouvellement ni aucune révocation des clés ne sont prévus.

Configuration B
  • La clé est enregistrée dans les Credentials de n8n. Le jeton Airtable est limité à la lecture de la base CulturaLab, seule action nécessaire pour cet exemple.

  • Le webhook exige un jeton secret dans l'en-tête de chaque requête.

  • L'automatisation transmet uniquement le nom complet, l'e-mail et l'événement choisi.

  • Les clés sont renouvelées à une fréquence fixée selon les risques et les règles de l'association. Elles sont révoquées immédiatement en cas de fuite ou de départ d'une personne qui y avait accès.

Pour rédiger votre avis :

  1. Ouvrez votre copie de la base CulturaLab et consultez les tables Adhérents, Événements et Outils. Repérez les champs utiles à l'inscription et ceux qu'il n'est pas nécessaire de transmettre à la billetterie.

  2. À partir des deux descriptions ci-dessus, comparez les configurations A et B : stockage de la clé, droits du jeton Airtable, protection du webhook, données transmises et renouvellement des clés. Ces informations de sécurité viennent du scénario, pas de la base.

  3. Repérez les 5 contrôles présents dans la configuration B et absents de la configuration A. Pour chacun, expliquez le risque ou la conséquence d'une fuite.

  4. Rédigez une note de 10 à 15 lignes pour la présidente : quelle configuration recommandez-vous, pourquoi, et quelles vérifications restent à faire avant la mise en production ?

Cette note constitue la troisième pièce de votre dossier de gouvernance.

En résumé

  • n8n échange avec les autres outils de deux façons : il va chercher les données par API (pull) ou les reçoit par webhook (push).

  • Le mapping ne transmet que les champs nécessaires et se vérifie sur une inscription de test.

  • Une clé d'API ne s'écrit jamais en clair dans un workflow : elle se range dans les Credentials, avec des droits limités, et se renouvelle régulièrement.

  • Un webhook est une adresse ouverte : il doit exiger un jeton secret.

  • Une clé configurée n'est pas une clé sécurisée.

Vous savez désormais repérer les failles d'un workflow. Dans le dernier chapitre de cette partie, vous rassemblerez toutes les vérifications du dossier de gouvernance dans un audit final, pour décider si la solution de CulturaLab peut être mise en production.

Et si vous obteniez un diplôme OpenClassrooms ?
  • Formations jusqu’à 100 % financées
  • Date de début flexible
  • Projets professionnalisants
  • Mentorat individuel
Trouvez la formation et le financement faits pour vous