Glossário

O significado curto das palavras usadas na documentação do zn-gate. Quando uma página explica uma palavra com mais detalhes, a palavra leva até ela. Não sabe por onde começar? Comece por Instalar.

Sua configuração

• Agente de código: um programa como Claude Code, Codex CLI, Cursor ou OpenCode que lê os seus arquivos e executa comandos por você. Veja Instalar.
• Terminal: a janela onde você digita comandos. Execute os comandos de instalação do zn-gate no seu próprio terminal, não por meio de um agente.
• Node.js: o programa que executa os comandos npm do zn-gate. O npx vem junto. Você pode baixá-lo em nodejs.org.
• Servidor MCP: uma ferramenta que o seu agente pode chamar. MCP é o padrão pelo qual os agentes se conectam a ferramentas. O zn-gate também pode funcionar como um. Veja Clientes e ferramentas MCP.
• Plugin: o complemento do zn-gate para o Claude Code. Ele configura os hooks do zn-gate e seus servidores MCP em uma única etapa. Veja Claude Code.
• Chaveiro (keychain): o armazenamento de senhas do seu sistema operacional. O zn-gate pode guardar ali uma chave de API opcional. Veja Connect.

Segredos

• Segredo: um valor que dá acesso a algo, como uma chave de API, um token ou uma senha.
• Arquivo .env: um arquivo de um projeto que guarda segredos e outras configurações do seu aplicativo.
• Cofre criptografado (vault): um armazenamento criptografado na sua máquina onde o zn-gate guarda os valores reais dos seus segredos. Veja Scrubber e cofre de segredos.
• Marcador: um substituto de um segredo, como __ZN_STRIPE_KEY__. O seu agente vê o marcador. O valor real fica no cofre. Veja Scrubber e cofre de segredos.
• Ocultar (redact): trocar um segredo em um texto por um marcador ou um rótulo, para que ninguém que leia o texto veja o valor. Veja Ocultação de segredos.
• Shadow (env shadow): mover os valores secretos de um arquivo .env para o cofre e deixar marcadores no lugar. Veja Scrubber e cofre de segredos.
• Scrubber: a parte do zn-gate que troca segredos por marcadores no que o seu agente lê, executa e envia. Os valores ficam no cofre. Veja Scrubber e cofre de segredos.

Verificações e proteção

• Hook: uma pequena verificação que o seu agente executa antes ou depois de ler um arquivo, rodar um comando ou receber o seu prompt. O zn-gate usa hooks para bloquear ou ocultar. Veja Como o zn-gate funciona.
• Proxy (shield): uma camada que fica entre o seu agente e um servidor MCP e verifica o que passa por ela. Veja Proteger servidores MCP.
• Modo shadow (--shadow): uma forma de implantar o zn-gate em que as decisões são registradas, mas nada é bloqueado nem alterado. Não é o mesmo que env shadow, descrito acima. Veja Como o zn-gate funciona.
• Injeção de prompt: texto que tenta fazer um agente ignorar as suas instruções, por exemplo escondido dentro de um arquivo ou de uma página web. Veja Modelo de ameaças.
• Classificador: um modelo que separa textos em grupos, como seguro ou tentativa de injeção.
• Galvanize: as verificações de injeção de prompt do zn. Elas rodam localmente como regras, e o classificador aberto Galvanize 2 está disponível como segunda opinião opcional. Veja Galvanize 2.
• Verificação na nuvem: uma segunda verificação opcional, pelo classificador Galvanize 2 em usezn.com, do texto enviado à ferramenta analyze_prompt do zn-gate. Fica desativada até você ativá-la. Veja O que sai da sua máquina.

Comandos e registros

• Autoteste (zn-gate test): executa os exemplos incluídos no zn-gate.
• Reach (zn-gate reach): um relatório somente leitura do que os seus agentes de código conseguem acessar nesta máquina. Mostra nomes, nunca valores. Veja Reach.
• Audit (zn-gate audit): lê os arquivos de configuração de agentes de um repositório, sem executar nada, e informa o que seria executado. Veja Audit.
• Scan (zn-gate scan): examina os prompts, o Markdown, as skills e os arquivos de configuração de uma pasta em busca de segredos vazados e de armadilhas de injeção de prompt. Veja Scan.
• Evidence (o registro de auditoria local): um registro de cada decisão do shield na sua máquina. Cada entrada é encadeada à anterior, então alterações podem ser detectadas. Veja Registro de auditoria local.