06

Gouvernance & Standards

Les règles qui évitent les incidents

Module 066 min de lectureMis à jour le 20 novembre 2026

La gouvernance n’est pas un document que l’on écrit pour rassurer. C’est ce qui reste quand la personne qui a construit le workflow s’en va, quand une clé fuite, ou quand un client demande la suppression de ses données.

Nous allons parler de nommage, de secrets, de sauvegardes, de droits et de journal. Pas pour ajouter de la bureaucratie, mais pour réduire le nombre de choses qui peuvent mal tourner sans que personne ne le voie. Une règle utile tient en une phrase et se vérifie.

Le Scénario Catastrophe :
Le freelance part. Le workflow critique plante. Personne ne sait ce qu’il fait, il n’y a pas de documentation, et la clé API est sur le compte personnel Gmail de l’ancien stagiaire.

La gouvernance commence par une question simple : que se passe-t-il si je disparais demain ? Si la réponse est « personne ne peut reprendre », le problème n’est pas la personne qui part, c’est l’organisation qui n’a rien prévu. Les règles qui suivent ne demandent pas de comité ni d’outil coûteux. Elles demandent une décision écrite, un endroit où la trouver, et une personne qui vérifie de temps en temps.

A. Conventions de Nommage (Naming)

La première règle de la maintenance : tout doit être lisible sans ouvrir le code.

Workflows

[ENV] - [DEPT] - [ACTION]

  • PROD - SALES - Enrich Leads
  • DEV - MKT - Sync Newsletter
  • TEST - IT - Sandbox Stripe

Nodes (Nœuds)

[Verbe] [Objet]

  • Create Airtable Record
  • Get User Email
  • Format Date
  • HTTP Request 2 ❌

Le nommage n’est pas cosmétique. Il permet de retrouver un workflow dans une liste, de comprendre une alerte à deux heures du matin et d’éviter de modifier la production en croyant toucher au test. Le préfixe d’environnement est la partie la plus utile : il rend visible le risque avant l’ouverture du workflow. Le reste peut être imparfait, tant qu’il est cohérent.

B. La Documentation "Sticky Note"

Dans n8n/Make, ajoutez une "Note" visible au début du workflow avec ce template :

# Titre du Workflow **Owner:** @Geoffroy **Last Updated:** 2025-02-02 **But:** Synchroniser les nouveaux clients Stripe vers Airtable. **Inputs:** Webhook Stripe (payment.succeeded) **Outputs:** Ligne Airtable + Notif Slack **Dépendances:** API Stripe, Table 'Clients'

C. Checklists de Sécurité & RGPD

🔐 Gestion des Secrets

  • ❌ Jamais de clé API dans le JSON du workflow.
  • ✅ Utiliser le système "Credentials" de n8n.
  • ✅ Utiliser des Variables d’Environnement pour les URL/Tokens globaux.
  • ✅ Créer des clés API "Service Account" (pas liées à une personne physique).

🇪🇺 Checklist RGPD

  • Minimisation : Ne transférez que les champs nécessaires (pas tout le JSON User).
  • Droit à l’oubli : Si un user est supprimé en base, avez-vous un workflow pour le supprimer de Mailchimp/Slack ?
  • Hébergement : Vos serveurs n8n/Supabase sont-ils en UE ?

Le moindre privilège, en pratique : une clé API qui peut lire, écrire et supprimer toutes les données n’est pas nécessaire pour un workflow qui ne fait que lire un champ. Créez une clé par usage, limitée aux droits utiles, et révoquez-la quand le workflow change. Le jour où la clé fuite, le périmètre du dégât dépend de ce que vous lui avez donné, pas de la chance.

Une sauvegarde non testée n’est pas une sauvegarde. Vérifiez trois choses : où sont les copies, qui peut les restaurer, et combien de temps prend la restauration. Une copie sur le même disque que la production ne protège pas d’une panne matérielle. Une copie jamais restaurée ne protège pas d’une erreur de manipulation.

D. Patterns de Robustesse

Warning Node

Si une branche critique échoue (ex: Paiement), ne la laissez pas "juste" planter. Activez l’option "On Error" (poursuite sur la sortie d’erreur) et connectez un nœud d’alerte.

Idempotence

Si le workflow tourne 2 fois par erreur, que se passe-t-il ?
Bonne pratique : "Upsert" (Update si existe, Create sinon) au lieu de "Create".

Un workflow robuste a trois issues : il continue quand l’erreur est récupérable, il alerte quand elle ne l’est pas, et il conserve la donnée pour rejouer plus tard. Une erreur silencieuse est plus dangereuse qu’une erreur bruyante. Le minimum est un nœud d’erreur qui envoie un message avec l’identifiant de l’exécution, le nom du workflow et la donnée d’entrée. Sans cela, la panne est découverte par le client.

E. Registre des traitements et note de cadrage

Trois réflexes que la check-list C ne couvrait pas : tenez un registre des traitements (quoi, pourquoi, combien de temps), signez un contrat de sous-traitance (DPA) avec chaque outil qui touche des données perso, et fixez des durées de conservation (exemple : prospects 3 ans max en France). Ceci est de l’information, pas du conseil juridique : en cas de doute, faites valider par un pro.

note de cadrage : 5 lignes avant tout workflow
1. Données manipulées (champs exacts, pas "tout le JSON")
2. Base légale (contrat, consentement, intérêt légitime)
3. Hébergement (pays, UE ou non)
4. Durée de conservation et suppression (droit à l'oubli)
5. Owner et date de revue

F. Gouverner l’IA et les changements

Un workflow qui appelle un modèle n’est pas un workflow comme les autres : la sortie varie, le fournisseur change, le coût dépend de l’usage. Quatre artefacts suffisent à le tenir.

Inventaire des modèles

Pour chaque appel : fournisseur, modèle, version, température, taille de contexte, coût unitaire, données envoyées. Sans cet inventaire, une dépréciation devient un incident.

Approbations

Lister les actions irréversibles : paiement, suppression, envoi client, changement de droit. Elles passent par une confirmation humaine ou une file de validation, jamais par la seule confiance du modèle.

Évaluations

Un jeu de cas figé, relu à chaque changement de prompt ou de modèle. Mesurer exactitude, taux d’escalade, latence et coût par exécution. Un prompt sans test est une opinion.

Versionnement et revue

Export JSON dans Git, revue avant mise en production, environnement de test séparé. Le workflow doit pouvoir revenir à la version précédente en une commande.

checklist avant production
[ ] owner, documentation et note de cadrage à jour
[ ] secrets dans le coffre, aucune clé dans le JSON
[ ] environnement de test séparé et jeu de cas d'évaluation
[ ] erreurs, retries et coupe-circuit testés en les déclenchant
[ ] sauvegarde et restauration essayées, pas seulement planifiées
[ ] journal d'audit conservé et coût par exécution mesuré
[ ] procédure d'incident : qui appelle, qui décide, comment on revient
Le test de la panne : débranchez le fournisseur de modèle, puis rejouez un cas réel. Si l’outil ne dit pas clairement ce qui s’est passé et quoi faire, la gouvernance est sur le papier, pas dans le système.