Prise en main

Ce qui quitte votre machine

Rien, par défaut. Ce que zn-gate évalue localement exactement, ce qu'il peut envoyer, et les paramètres qui le contrôlent.

Voir le .md

Rien, par défaut. Tout ce que fait zn-gate s'exécute sur votre machine. Le cloud est facultatif, désactivé tant que vous ne l'activez pas, et ne reçoit jamais que du texte de prompt dont les secrets ont été masqués localement au préalable.

Par type de données (zn-gate 1.5.1)

Données Évaluées Envoyées quelque part ?
Sortie d'outil (check_tool_result, shield) Localement Jamais, quelle que soit la configuration
Arguments d'appel d'outil (check_tool_call, shield) Localement Jamais, quelle que soit la configuration
Descriptions des outils et paramètres MCP (shield) Localement Jamais, quelle que soit la configuration
Prompts (analyze_prompt, zn-gate analyze, analyze() en Python) Localement Uniquement si vous définissez à la fois ZN_CLOUD=1 et ZN_API_KEY. Les secrets sont masqués localement avant l'envoi.
Journal d'audit local (~/.zn/evidence.jsonl) Écrit localement Jamais
Valeurs secrètes du coffre (Scrubber, npm) Chiffrées localement Jamais vers zn. zn ne transmet une valeur qu'à un programme que vous avez autorisé (zn run) ou à une requête vers un hôte que vous avez autorisé (secrets_http_request, en-têtes uniquement par défaut). Ce qu'un programme autorisé fait de cette valeur relève de ce programme, et un coffre déverrouillé répond à tout programme de votre utilisateur système (limites)
Journal d'audit du coffre (zn vault log) Écrit localement, jamais les valeurs Jamais

En Python, evaluate, guard, check_tool_call, check_tool_result, sanitize_tool_result, redact_secrets ainsi que les intégrations LangChain, CrewAI, LlamaIndex et Promptfoo sont toujours locaux. La seule fonction capable d'atteindre le réseau est analyze(), sous les deux mêmes conditions.

Les paramètres qui le contrôlent

  • ZN_API_KEY seul n'active rien.
  • ZN_CLOUD=1 combiné à ZN_API_KEY permet à l'analyse des prompts de demander aussi au modèle cloud un second avis.
  • ZN_LOCAL_ONLY=true (ou --local-only) impose le mode local uniquement, même avec ZN_CLOUD=1.

Vérifiez votre configuration à tout moment :

npx -y zn-gate status

L'outil MCP zn_status fournit les mêmes informations à votre agent. Tous les paramètres : Configuration.

Quand le cloud est activé

Avec ZN_CLOUD=1 et une clé, un prompt est d'abord vérifié par les règles locales. Si elles le bloquent, rien n'est envoyé. Sinon, le texte, avec les secrets remplacés par des espaces réservés tels que [REDACTED_AWS_KEY], est envoyé à api.usezn.com pour un second avis du modèle Galvanize 2. Si le cloud est injoignable, zn-gate renvoie le résultat local. Conservation et traitement des données reçues par le cloud : politique de confidentialité.

Versions antérieures

zn-gate 1.4.0 et antérieures (npm) : avec ZN_API_KEY défini, les sorties d'outil et les arguments d'appel d'outil non bloqués localement étaient envoyés à api.usezn.com sans masquage. La version 1.4.1 supprime ce chemin. Si vous avez utilisé la 1.4.0 avec ZN_API_KEY, mettez à jour et envisagez de révoquer tout identifiant qui aurait pu apparaître dans une sortie d'outil. Détails dans le CHANGELOG.

Python 1.4.0 et antérieures : seuls analyze() et zn-gate analyze envoyaient du texte, lorsque ZN_API_KEY était défini, sans masquage.