Connecter (vérification cloud facultative)

npx -y zn-gate connect

(ou zn-gate connect si vous l’avez installé avec npm i -g zn-gate).

zn-gate fonctionne entièrement sur votre ordinateur, n’exige aucun compte et n’envoie rien par défaut. Cette commande est facultative. Elle ajoute une seule chose : quand vous ou votre agent utilisez l’outil analyze_prompt (ou zn-gate analyze), le texte, dont les secrets détectés ont d’abord été masqués, est aussi vérifié par le classifieur Galvanize 2 sur usezn.com. Les hooks, la protection des fichiers et des secrets, le shield et toutes les autres commandes restent locaux et ne l’utilisent jamais.

Ce que fait zn-gate connect

1. Elle ne s’exécute que dans un terminal où vous tapez vous-même. Si un agent d’IA l’a lancée, elle refuse.
2. Elle vous dit ce qui va changer et vous demande de confirmer.
3. Elle ouvre usezn.com/connect dans votre navigateur. Créez un compte gratuit (ou connectez-vous) et créez-y une clé d’API réservée à l’analyse. La page de connexion le fait pour vous.
4. De retour dans le terminal, collez la clé à l’invite masquée. Rien de ce que vous tapez n’est affiché, et la clé n’est jamais prise sur la ligne de commande ni dans une variable d’environnement.
5. Elle vérifie la clé une fois avec https://api.usezn.com. Seule la clé est envoyée, dans un en-tête de la requête, à cette unique adresse, par une connexion TLS vérifiée.
6. Elle enregistre la clé et affiche ses quatre derniers caractères pour que vous puissiez la reconnaître.

Quelles clés elle accepte

connect n’accepte qu’une clé limitée à l’analyse de texte. Une telle clé ne peut pas lire votre consommation, lister, créer ou révoquer d’autres clés, ni utiliser le tableau de bord : une copie divulguée ne permet donc pas grand-chose. Une clé à accès complet est refusée, avec un renvoi vers la page de connexion. Une clé que le serveur rejette, ou qui n’a pas pu être vérifiée (pas de réponse, une erreur), est refusée elle aussi. Dans tous ces cas, rien n’est enregistré.

Où la clé est conservée

Uniquement à l’un de ces endroits, jamais dans un fichier :

• Le trousseau de votre système : le Trousseau d’accès de macOS, le Gestionnaire d’identifiants de Windows ou le Secret Service de Linux (GNOME Keyring, KWallet).
• Le coffre zn, quand votre système n’a pas de trousseau et que le coffre est déverrouillé (zn unlock). Le coffre la chiffre.

Si aucun des deux n’est disponible (par exemple Linux sans session de bureau), rien n’est enregistré et zn-gate connect le dit. Vous pouvez toujours définir vous-même ZN_CLOUD=1 et ZN_API_KEY dans votre shell.

~/.zn/config.json note seulement que vous vous êtes connecté, où la clé est conservée et ses quatre derniers caractères. Il ne contient jamais la clé. La vérification cloud ne s’active à partir de cette note que si la clé enregistrée se termine par ces quatre caractères : une note écrite à la main ne fait donc rien. Une clé enregistrée n’est jamais envoyée qu’à https://api.usezn.com : --url et ZN_API_URL sont ignorés pour elle. Si la note existe mais que la clé enregistrée est illisible, les prompts sont vérifiés localement et zn-gate le signale une fois.

Les hooks de zn refusent les moyens directs pour votre agent de lire la clé enregistrée, comme les commandes qui demandent au trousseau du système les entrées de zn ou le code qui la charge par les modules de zn. Les commandes connect et disconnect elles-mêmes sont refusées quand un agent les lance, et zn masque le format de la clé (zn_ suivi de 48 caractères) dans ce que voit l’agent.

C’est une barrière, pas un mur de coffre-fort : un programme qui s’exécute sous votre identité peut toujours demander la clé au trousseau, comme pour n’importe quelle entrée du trousseau. C’est pourquoi connect n’accepte qu’une clé limitée à l’analyse de texte, et pourquoi vous pouvez la révoquer à tout moment.

Voir et changer l’état

• zn-gate status indique si une clé est connectée et d’où elle vient (ZN_API_KEY, --key, le trousseau ou le coffre), jamais la clé. Il indique aussi le moteur de détection et si la vérification cloud facultative est activée.
• zn-gate connect --reconnect remplace la clé enregistrée.
• zn-gate disconnect supprime la clé de cet ordinateur et désactive la vérification cloud.
• Une clé donnée dans --key ou ZN_API_KEY n’est utilisée à la place de celle qui est enregistrée que si vous définissez aussi ZN_CLOUD=1 ; sinon, la clé enregistrée est utilisée et ZN_API_KEY et ZN_API_URL sont ignorés. ZN_LOCAL_ONLY=true ou --local-only désactive la vérification cloud même si vous êtes connecté.

Se déconnecter et révoquer la clé

Si une clé est enregistrée, zn-gate disconnect demande s’il faut aussi la révoquer sur usezn.com, pour qu’elle cesse de fonctionner partout. La réponse par défaut est non, et seul un oui explicite envoie quelque chose : une requête avec la clé vers https://api.usezn.com, par la même connexion vérifiée que celle de connect.

• La copie locale est supprimée dans tous les cas, même si la requête échoue. Si elle échoue, la commande le dit et vous renvoie vers usezn.com/api-keys, où vous pouvez révoquer la clé vous-même.
• zn-gate disconnect --revoke saute la question, et --no-revoke ne révoque jamais et ne fait aucun appel réseau.
• Si la clé enregistrée est illisible, rien n’est supprimé. --no-revoke supprime alors seulement la copie locale.
• Comme connect, la commande ne s’exécute que dans votre propre terminal. Sans terminal, ou depuis un agent d’IA, elle refuse et ne change rien : rien n’est donc révoqué.

Si quelque chose échoue

• Elle refuse de s’exécuter : elle ne s’exécute que dans un terminal où vous tapez vous-même. Ouvrez votre propre terminal et lancez-la là, pas par un agent d’IA ni un script.
• La clé est refusée : utilisez la page de connexion pour créer une clé réservée à l’analyse, puis relancez zn-gate connect.
• La clé n’a pas pu être vérifiée (pas de réponse, une erreur) : vérifiez votre connexion et réessayez.
• Elle dit que rien n’a été enregistré faute de trousseau : déverrouillez le coffre avec zn unlock et relancez zn-gate connect, ou définissez vous-même ZN_CLOUD=1 et ZN_API_KEY dans votre shell.
• Vous voulez arrêter : lancez zn-gate disconnect.

Ce qui est envoyé

Uniquement le texte des appels à analyze_prompt et zn-gate analyze, après que zn-gate a retiré les secrets qu’il détecte (les données personnelles ne sont pas retirées sur ce chemin), et la clé dans un en-tête de la requête. La sortie des outils, les arguments des appels d’outils et les descriptions d’outils ne sont jamais envoyés. Voir Ce qui quitte votre machine.