Skip to main content
Versões

Novidades do zn-gate 1.15.0: ZCode protegido no Windows, exclusões escondidas bloqueadas, mais pedidos de identidade detectados, um zn run mais seguro

John Silver10 min de leitura

O zn-gate 1.15.0 faz o plugin do ZCode proteger as chamadas de ferramentas no Windows, dificulta esconder um comando destrutivo da verificação que roda antes de o seu agente executá-lo, amplia a verificação opcional de downloads enviados por pipe, detecta mais resultados de ferramentas que tentam fazer o seu agente enviar seus dados, confere se o executor de hooks é o que foi instalado antes de executá-lo, fecha uma lacuna no zn run e corrige mensagens que estavam pouco claras ou ausentes. O zn-gate continua não precisando de conta e não envia nada por padrão. Atualize com npm install -g zn-gate@1.15.0 e pip install -U zn-gate.

Visão geral das novidades do zn-gate 1.15: um hub com cinco itens, em ordem. O launcher verifica o que executa: o launcher de hooks do zn só executa o hook runner se ele corresponder ao SHA-256 registrado na instalação. Sem fallback para o PATH. Exclusões ocultas detectadas: rm -rf escondido em aspas ANSI-C ou em one-liners python -c / node -e é bloqueado. ZCode protegido no Windows: o hook do plugin agora roda no Windows, cerca de 3x mais rápido na primeira chamada, e responde antes do timeout do ZCode. Mais pedidos de identidade detectados: mais resultados de ferramentas que mandam seu agente enviar o seu e-mail são sinalizados. Mais seguro por padrão: correções de dependências do gateway em Rust (zip, wasmtime) e verificações mais rígidas da pasta temporária para o zn run.

O ZCode está protegido no Windows agora?

Sim, a partir desta versão. Nas versões anteriores, os hooks do plugin do ZCode iniciavam o /bin/sh pelo caminho completo, que o Windows não tem, então o hook nunca rodava e o ZCode executava toda chamada de ferramenta sem o zn. O zn-gate check informava o plugin como não protegido, mas nada impedia as chamadas. Agora todo evento do plugin também tem um hook para Windows:

  • Ele roda. O hook inicia o Node.js diretamente (um pequeno scripts/zn-hook.cmd procura na pasta de instalação usual) e recorre a uma versão em PowerShell do launcher quando o Node.js está em outro lugar. Se não encontra um Node.js utilizável, bloqueia a chamada.
  • Ele responde a tempo. O ZCode deixa uma chamada rodar quando o hook dela estoura o tempo limite. O plugin agora dá 5 minutos aos seus hooks em vez de 30 segundos, e o hook bloqueia a chamada por conta própria 2 minutos depois de o ZCode tê-lo iniciado, também quando o zn-gate está travado. Nos nossos testes em uma máquina Windows de 2 CPUs com todas as CPUs ocupadas, uma verificação comum levou até 131 segundos e um zn-gate travado foi bloqueado em no máximo 154 segundos, então o timeout de 5 minutos deixa folga. Em uma máquina tão ocupada que o hook leve mais de 5 minutos, o ZCode deixa a chamada rodar. O zn hooks install zcode grava o mesmo timeout e o mesmo prazo: execute-o de novo para atualizar uma instalação existente.
  • Ele é cerca de três vezes mais rápido. Em uma máquina nova com Windows Server 2022, 2 vCPUs e o Defender ativado, a primeira chamada de hook da máquina leva 0,7 s em vez de 2,0 s (mediana de duas execuções), e uma chamada posterior 0,3 s em vez de 0,9 s.
  • Ele executa apenas os arquivos do próprio plugin. Funciona a partir de pastas de usuário cujos nomes têm espaços, &, parênteses, ^ ou %, e nunca executa um arquivo de mesmo nome que esteja no projeto.

O zn-gate check executa ali o hook do Windows e não informa mais um hook como "could not be started" quando ele respondeu e terminou antes de ler toda a sua entrada. Depois de atualizar, instale o plugin de novo no ZCode (Settings, Plugins).

Quais exclusões escondidas o zn-gate detecta agora?

A verificação de comandos destrutivos bloqueia a exclusão recursiva da sua pasta pessoal, da raiz do sistema de arquivos ou de uma pasta do sistema antes de o agente executá-la. A 1.15.0 lê mais duas formas de escrever uma:

  • Aspas ANSI-C: $'\x72m' -rf ~, rm -rf $'\x7e' e $'\162m' -rf / são bloqueados. Um $'...' literal que apenas é impresso, como em echo $'\x72m -rf ~', continua permitido.
  • One-liners de interpretadores: o código passado a python -c, node -e, perl -e e ruby -e (também atrás de sudo ou env) é lido. Um one-liner que exclui essas pastas de forma recursiva (shutil.rmtree, fs.rmSync com recursive, remove_tree, FileUtils.rm_rf, unlink glob) é bloqueado como rm_root_home.

Veja Comandos destrutivos para a lista completa.

Quais downloads enviados por pipe são bloqueados?

A regra pipe_to_shell vem desligada por padrão. Ative-a com hooks.blockDestructiveCommands em ~/.zn/config.json (por exemplo ["rm_root_home", "disk_overwrite", "pipe_to_shell"], ou true para as seis regras) ou com ZN_BLOCK_DESTRUCTIVE=1. Com ela ativada, a 1.15.0 também bloqueia:

  • Um download enviado por pipe a python, node, perl ou ruby que lê o programa a partir do pipe, como curl ... | python3 ou | sudo python3 -, é bloqueado como pipe_to_shell. | python3 -m json.tool e | python3 script.py continuam permitidos.
  • No PowerShell 7, uma linha que começa com um pipe continua o comando da linha de cima, então um download como iwr https://example.com/i.ps1 seguido de uma linha | iex é bloqueado. Uma linha seguinte que envia por pipe a algo inofensivo, como | ConvertFrom-Json, continua permitida.

Mais pedidos de identidade detectados

O texto de um resultado de ferramenta pode mandar o seu agente colocar seus dados em uma requisição. As regras de pedido de identidade (pi:identity_request e pi:identity_request_multi) agora detectam mais disso: "the user email" sem o apóstrofo, "their email" em um cabeçalho X- personalizado ou na requisição seguinte, uma instrução que quebra para uma segunda linha e uma instrução para executar whoami ou git config user.email e colocar o resultado em um cabeçalho, parâmetro de URL, cookie, campo de formulário ou requisição. Documentação de API que pede um endereço de e-mail "em toda requisição", em um cabeçalho User-Agent ou From, em um link mailto, no corpo de uma requisição ou em um formulário não é sinalizada, e frases que dizem para não enviar os dados também não. Como antes, essas regras são avisos por padrão e bloqueiam no modo estrito.

O launcher de hooks verifica o que executa

No macOS e no Linux, e para o Claude Code no Windows (que executa o mesmo launcher pelo Git Bash), o launcher de hooks do zn agora só executa o executor de hooks do zn-gate enquanto esse arquivo ainda tiver o SHA-256 registrado na instalação, e não recorre mais a um zn encontrado no PATH. Um executor que foi editado ou trocado por um stub é bloqueado, com uma mensagem para executar zn hooks install <agent> de novo, e o zn-gate check o informa. A verificação cobre o arquivo do executor, não os demais arquivos do pacote. Os hooks PowerShell embutidos do Codex CLI, do Cursor, do Gemini CLI e do Antigravity no Windows não mudaram.

O que mudou no zn run e no gateway em Rust?

  • zn run e pastas temporárias: o zn run recusa um comando permitido que resolve para um arquivo em uma pasta temporária. Dois casos escapavam. Primeiro, a pasta temporária era tomada de TMPDIR, TEMP e TMP, que o agente pode definir para o comando, então apontá-las para outro lugar deixava um arquivo plantado na pasta temporária do sistema rodar com o segredo. As pastas temporárias do sistema (/tmp, /var/tmp, /dev/shm, as pastas temporárias por usuário do macOS e, no Windows, a pasta temporária do perfil do usuário e a do sistema) agora são sempre verificadas. Segundo, no Windows, uma pasta temporária citada em uma forma e uma entrada do PATH em outra (o nome longo, o nome curto 8.3, uma unidade subst ou um caminho \\?\) não coincidiam; agora coincidem, e a verificação de arquivos dentro do projeto compara as mesmas formas.
  • Publicação no PyPI: o pacote Python agora é publicado com o pypa/gh-action-pypi-publish 1.14.3, que não confia mais no certificado raiz da emSign que o GHSA-5xjx-3w67-w9x9 informa como comprometido. Os arquivos no PyPI da 1.14.1 e da 1.15.0-rc.1 coincidem com o SHA256SUMS assinado nas suas versões do GitHub.
  • Dependências do gateway em Rust: o gateway é compilado com zip 9.3.0 e wasmtime 48.0.8, que corrigem o RUSTSEC-2026-0429 (o zip 8.6.0 podia abortar o processo diante de uma entrada de arquivo que é um symlink com tamanho declarado grande; o gateway nunca extrai arquivos) e o RUSTSEC-2026-0422, o RUSTSEC-2026-0423 e o RUSTSEC-2026-0424 (verificações entre componentes WebAssembly).

Correções

  • Init guiado sem internet: o zn-gate init agora diz "no internet connection: npm could not reach the registry" e o que fazer em seguida, em vez de culpar as permissões da pasta global do npm. A etapa de instalação do npm desiste depois de cerca de 30 segundos e nunca espera mais de 3 minutos. No Windows, quando essa etapa estoura o tempo, o próprio npm agora é interrompido.
  • OpenCode: quando o hook do zn não consegue iniciar (por exemplo, o Node.js com o qual foi instalado sumiu), a chamada bloqueada diz isso em palavras simples e dá o passo de reparo (zn-gate check e depois zn hooks install opencode), em vez de um erro bruto.
  • O mesmo próximo passo em todo lugar: quando uma verificação estoura o tempo ou falha, todo agente agora diz para tentar de novo e, se continuar acontecendo, para executar zn-gate check.
  • ZCode: quando a verificação da saída de uma ferramenta estoura o tempo, ou a saída é grande demais para ser verificada (mais de 32 MiB), o ZCode agora recebe um aviso de que a saída não foi retida, em vez de um bloqueio ou de uma mensagem de que foi retida, já que a ferramenta já tinha rodado.
  • zn-gate check: ele lê os hooks do plugin do ZCode do sistema em que roda, e não avalia o hook do outro sistema nem toma um caminho do Windows como C:/Windows/... por um programa procurado pelo nome.
  • Disco cheio: os hooks não deixam mais um arquivo de bloqueio vazio ao lado do log de evidências, o que fazia cada chamada de hook seguinte esperar meio segundo.
  • zn-gate stats: somente os dias cujas contagens compartilhadas foram realmente enviadas são informados como enviados; um dia que falhou no envio é tentado de novo na execução seguinte.
  • Pacote Python: um resultado de ferramenta que contém o mesmo objeto muitas vezes não é mais bloqueado com a regra size:items. ZN_STRICT e ZN_BLOCK_TRUNCATED avisam quando definidas com um valor diferente de 1, o que as deixa desligadas. Com on_block="ignore", as integrações com LangChain e LlamaIndex agora registram um aviso, com a regra e o local onde aconteceu, quando deixam algo passar. O aviso de uma chamada à nuvem que falhou diz o que deu errado e que as regras locais foram usadas.

A lista completa está no changelog.

Como atualizo?

npm install -g zn-gate@1.15.0
pip install -U zn-gate
npx -y zn-gate@1.15.0 check

A atualização renova os launchers de hooks que ela gravou, também no Windows. Se o seu gerenciador de pacotes pula scripts de instalação (npm install --ignore-scripts, pnpm ou bun), execute zn hooks install <agent> de novo para cada agente que você usa; até lá os hooks bloqueiam as chamadas de ferramentas e avisam para fazer isso (com o pnpm eles continuam executando o executor de hooks da versão instalada antes, sem mensagem). O check mostra quais agentes precisam disso. Se você usa o plugin do Claude Code, execute claude plugin update zn-gate@usezn e inicie uma nova sessão. Se você usa o plugin do ZCode no Windows, instale-o de novo no ZCode (Settings, Plugins).

Compartilhar