Primeiros passos
O que sai da sua máquina
Nada, por padrão. Exatamente o que o zn-gate avalia localmente, o que pode enviar e as configurações que controlam isso.
Nada, por padrão. Tudo o que o zn-gate faz roda na sua máquina. A nuvem é opcional, desligada até você ativá-la, e só recebe texto de prompt que foi previamente redigido localmente para remover segredos.
Por tipo de dado (zn-gate 1.5.1)
| Dado | Avaliado | Enviado para algum lugar? |
|---|---|---|
Saída de ferramenta (check_tool_result, shield) |
Localmente | Nunca, em nenhuma configuração |
Argumentos de chamada de ferramenta (check_tool_call, shield) |
Localmente | Nunca, em nenhuma configuração |
Descrições de ferramentas e parâmetros MCP (shield) |
Localmente | Nunca, em nenhuma configuração |
Prompts (analyze_prompt, zn-gate analyze, analyze() em Python) |
Localmente | Somente se você definir ambos ZN_CLOUD=1 e ZN_API_KEY. Os segredos são redigidos localmente antes do envio. |
Log de auditoria local (~/.zn/evidence.jsonl) |
Gravado localmente | Nunca |
| Valores de segredos no cofre (Scrubber, npm) | Criptografados localmente | Nunca para a zn. A zn preenche um valor apenas em um programa que você autorizou (zn run) ou em uma requisição para um host que você autorizou (secrets_http_request, somente cabeçalhos por padrão). O que um programa autorizado faz com o valor depende desse programa, e um cofre desbloqueado responde a qualquer programa do seu usuário do sistema operacional (limites) |
Log de auditoria do cofre (zn vault log) |
Gravado localmente, nunca os valores | Nunca |
Em Python, evaluate, guard, check_tool_call, check_tool_result, sanitize_tool_result, redact_secrets e as integrações com LangChain, CrewAI, LlamaIndex e Promptfoo são sempre locais. A única função que pode acessar a rede é analyze(), sob as mesmas duas condições.
As configurações que controlam isso
ZN_API_KEYsozinho não ativa nada.ZN_CLOUD=1junto comZN_API_KEYfaz com que a análise de prompts também peça ao modelo da nuvem uma segunda opinião.ZN_LOCAL_ONLY=true(ou--local-only) força o modo somente local, mesmo comZN_CLOUD=1.
Verifique sua configuração a qualquer momento:
npx -y zn-gate statusA ferramenta MCP zn_status retorna as mesmas informações para o seu agente. Todas as configurações: Configuração.
Quando a nuvem está ativa
Com ZN_CLOUD=1 e uma chave, um prompt é primeiro verificado pelas regras locais. Se elas o bloquearem, nada é enviado. Caso contrário, o texto, com os segredos substituídos por marcadores como [REDACTED_AWS_KEY], é enviado para api.usezn.com para uma segunda opinião do modelo Galvanize 2. Se a nuvem não puder ser acessada, o zn-gate retorna o resultado local. Retenção e processamento do que a nuvem recebe: política de privacidade.
Versões anteriores
zn-gate 1.4.0 e anteriores (npm): com ZN_API_KEY definida, a saída de ferramentas e os argumentos de chamadas de ferramentas que não eram bloqueados localmente eram enviados para api.usezn.com sem redação. A 1.4.1 remove esse caminho. Se você usou a 1.4.0 com ZN_API_KEY, atualize e considere rotacionar qualquer credencial que possa ter aparecido na saída de ferramentas. Detalhes no CHANGELOG.
Python 1.4.0 e anteriores: somente analyze() e zn-gate analyze enviavam texto, quando ZN_API_KEY estava definida, sem redação.