Node n8n Miravig — Documentation

En bref

Le node Miravig détecte les données sensibles dans vos workflows n8n avant qu'elles ne partent vers un LLM, et peut les masquer automatiquement — avec le même moteur de détection que l'extension Chrome et la web app Miravig. Analyse 100% locale, aucune donnée ne transite par nos serveurs.

Détection : toujours gratuite et illimitée. Masquage automatique et glossaire métier personnalisé : réservés à un abonnement Miravig actif.

Installation

Important avant d'installer : ce node est distribué en package communautaire n8n, installable uniquement sur une instance n8n auto-hébergée (Docker, VPS, ou installation locale).

Dans n8n : Settings → Community Nodes → Install, puis entrez n8n-nodes-miravig.

Page du package sur npm (code source, changelog) : npmjs.com/package/n8n-nodes-miravig.

n8n affichera un écran d'avertissement standard sur les packages communautaires non vérifiés.

Les deux opérations : Mask et Unmask

Le node Miravig propose un seul type de node avec un paramètre Operation :

Mask — à placer avant votre appel LLM. Détecte les données sensibles, les masque si activé.
Unmask — à placer après votre appel LLM. Restaure les vraies valeurs du glossaire métier dans la réponse.

Une chaîne typique :

Déclencheur → [vos données] → Miravig (Mask) → [nœud LLM] → Miravig (Unmask) → [suite du workflow]

Ce qui est masqué, et comment — la distinction la plus importante à comprendre

Catégories natives (email, IBAN, identifiants nationaux, etc.) — masquage à sens unique

Quand Miravig détecte une donnée sensible native (email, IBAN, numéro de sécurité sociale, etc.), elle est remplacée par un jeton générique qui n'est jamais restauré.

Le node Unmask ne fait donc rien sur ces catégories.

Précision de la détection : au-delà d'une simple vérification de format, la plupart des identifiants nationaux sont validés par un vrai calcul de checksum officiel.

Checksum réel vérifié	Format + contexte uniquement	Non couvert
France (SIREN/SIRET, NIR), Espagne (DNI/NIE), Portugal (NIF), Allemagne (Steuer-ID), Italie (Codice Fiscale), Suisse (AHV/AVS), Canada (SIN), Belgique, Autriche, Suède, Norvège, Finlande, Pays-Bas, Pologne (PESEL), République tchèque, Slovaquie, Croatie (OIB), Irlande (PPS), Islande (Kennitala), Roumanie (CNP), Bulgarie (EGN), Slovénie (EMŠO), Lituanie, Estonie — 24 pays au total	États-Unis (SSN), Royaume-Uni (NINO), Danemark, Lettonie — aucune formule de contrôle publique fiable sur les numéros récents, confiance plafonnée à `medium` en conséquence	Hongrie, Chypre, Malte, Luxembourg — aucun mécanisme de checksum public identifié à ce jour

Pour les identifiants sans checksum, la détection reste fiable mais s'appuie davantage sur le contexte.

Glossaire métier — masquage réversible, à vous de le configurer

Le glossaire métier vous permet de faire masquer vos propres termes sensibles — ceux-ci sont remplacés par des jetons numérotés et peuvent être restaurés par le node Unmask.

Règle impérative : collez exactement le même glossaire dans le node Mask et dans le node Unmask.

Il n'existe aucune synchronisation automatique entre les deux — c'est un choix de conception délibéré.

Vos propres variables n8n et Make — jamais touchées

Les expressions natives de n8n et de Make sont explicitement reconnues et ne sont jamais confondues avec une donnée sensible.

Un point d'attention si vous utilisez un nœud LLM entre Mask et Unmask

Certains nœuds n8n (notamment Basic LLM Chain) reconstruisent entièrement leur donnée de sortie à partir de la réponse du modèle.

Ce n'est pas une panne silencieuse : si l'empreinte est absente, le node Unmask vous le signale explicitement.

Pour garder la vérification active, ajoutez un node "Edit Fields" juste après votre nœud LLM.

{{ $('Miravig (Mask)').item.json.miravig }}

(remplacez Miravig (Mask) par le nom exact que porte votre node Mask dans le workflow)

Comportement en cas de détection

Trois options, à régler dans le paramètre "Behavior on Detection" :

Pass Through and Annotate (par défaut) — le workflow continue normalement.
Stop Workflow — le workflow s'arrête si une donnée sensible est détectée.
Route Flagged Items to a Secondary Output (optionnel, désactivé par défaut).

Licence et facturation

	Gratuit	Abonnement actif
Détection de données sensibles	Illimitée	Illimitée
Masquage automatique	✕	✓
Glossaire métier	✕	✓

La clé de licence est la même que celle de votre compte Miravig (extension et web app) — aucun nouvel abonnement séparé si vous êtes déjà client. Configurez-la dans la credential "Miravig License" du node, champ "License Key".

Panne réseau ou Worker temporairement injoignable : votre masquage continue de fonctionner normalement, sur la base de votre dernier statut de licence confirmé.

→ Voir la page tarifs

FAQ

Pourquoi je ne trouve pas le node dans n8n Cloud ?

Le node n'est pas encore certifié par n8n — voir la section Installation ci-dessus.

Mes données de prompt sont-elles envoyées à Miravig ?

Non. Toute l'analyse et le masquage se font localement dans votre instance n8n.

Puis-je utiliser une seule licence sur plusieurs instances n8n ?

Oui. Le pool de 3 activations inclus dans votre abonnement (le même que celui utilisé pour vos appareils) est partagé librement entre appareils et instances n8n, sans distinction technique entre les deux — vous pouvez par exemple dédier vos 3 activations à 3 instances n8n si vous le souhaitez. Au-delà de 3 activations, voir notre page tarifs.

Le node vérifie-t-il aussi la qualité de mes prompts (variables oubliées, format JSON, etc.) ?

Non, ce node se concentre exclusivement sur la détection de données sensibles. Ces vérifications existent séparément, gratuitement, sur notre outil web n8n-checker.html.