Glossaire

Le sens court des mots employés dans la documentation de zn-gate. Quand une page explique un mot plus en détail, le mot renvoie vers elle. Vous ne savez pas par où commencer ? Commencez par Installer.

Votre installation

• Agent de code : un programme comme Claude Code, Codex CLI, Cursor ou OpenCode qui lit vos fichiers et exécute des commandes à votre place. Voir Installer.
• Terminal : la fenêtre où vous tapez des commandes. Lancez les commandes d'installation de zn-gate dans votre propre terminal, pas par l'intermédiaire d'un agent.
• Node.js : le programme qui exécute les commandes npm de zn-gate. npx est fourni avec. Vous pouvez le télécharger sur nodejs.org.
• Serveur MCP : un outil que votre agent peut appeler. MCP est le standard par lequel les agents se connectent aux outils. zn-gate peut aussi fonctionner comme tel. Voir Clients et outils MCP.
• Plugin : le module complémentaire de zn-gate pour Claude Code. Il configure les hooks de zn-gate et ses serveurs MCP en une seule étape. Voir Claude Code.
• Trousseau (keychain) : le gestionnaire de mots de passe de votre système d'exploitation. zn-gate peut y conserver une clé d'API facultative. Voir Connect.

Secrets

• Secret : une valeur qui donne accès à quelque chose, comme une clé d'API, un jeton ou un mot de passe.
• Fichier .env : un fichier d'un projet qui contient des secrets et d'autres réglages de votre application.
• Coffre chiffré (vault) : un espace chiffré sur votre machine où zn-gate garde les vraies valeurs de vos secrets. Voir Scrubber et coffre de secrets.
• Marqueur : un substitut d'un secret, par exemple __ZN_STRIPE_KEY__. Votre agent voit le marqueur. La vraie valeur reste dans le coffre. Voir Scrubber et coffre de secrets.
• Masquer (redact) : remplacer un secret dans un texte par un marqueur ou une étiquette, pour que personne qui lit le texte ne voie la valeur. Voir Masquage des secrets.
• Shadow (env shadow) : déplacer les valeurs secrètes d'un fichier .env dans le coffre et laisser des marqueurs à leur place. Voir Scrubber et coffre de secrets.
• Scrubber : la partie de zn-gate qui remplace les secrets par des marqueurs dans ce que votre agent lit, exécute et envoie. Les valeurs restent dans le coffre. Voir Scrubber et coffre de secrets.

Vérifications et protection

• Hook : une petite vérification que votre agent exécute avant ou après avoir lu un fichier, lancé une commande ou reçu votre prompt. zn-gate utilise des hooks pour bloquer ou pour masquer. Voir Comment fonctionne zn-gate.
• Proxy (shield) : une couche placée entre votre agent et un serveur MCP, qui vérifie ce qui y passe. Voir Protéger les serveurs MCP.
• Mode shadow (--shadow) : une façon de déployer zn-gate où les décisions sont journalisées, mais où rien n'est bloqué ni modifié. Ce n'est pas la même chose que env shadow, décrit plus haut. Voir Comment fonctionne zn-gate.
• Injection de prompt : du texte qui cherche à faire ignorer vos instructions à un agent, par exemple caché dans un fichier ou une page web. Voir Modèle de menace.
• Classifieur : un modèle qui range les textes en groupes, par exemple sûr ou tentative d'injection.
• Galvanize : les vérifications d'injection de prompt de zn. Elles s'exécutent en local sous forme de règles, et le classifieur ouvert Galvanize 2 est disponible comme second avis facultatif. Voir Galvanize 2.
• Vérification dans le cloud : une seconde vérification facultative, par le classifieur Galvanize 2 sur usezn.com, du texte envoyé à l'outil analyze_prompt de zn-gate. Elle est désactivée tant que vous ne l'activez pas. Voir Ce qui quitte votre machine.

Commandes et journaux

• Auto-test (zn-gate test) : exécute les exemples intégrés de zn-gate.
• Reach (zn-gate reach) : un rapport en lecture seule de ce à quoi vos agents de code peuvent accéder sur cette machine. Il montre des noms, jamais des valeurs. Voir Reach.
• Audit (zn-gate audit) : lit les fichiers de configuration d'agents d'un dépôt, sans rien exécuter, et indique ce qui s'exécuterait. Voir Audit.
• Scan (zn-gate scan) : parcourt les prompts, le Markdown, les skills et les fichiers de configuration d'un dossier à la recherche de secrets divulgués et de pièges d'injection de prompt. Voir Scan.
• Evidence (le journal d'audit local) : un enregistrement de chaque décision de shield sur votre machine. Chaque entrée est chaînée à la précédente, ce qui permet de détecter les modifications. Voir Journal d'audit local.