← Voltar para todas as publicações
Publicado em · por Renaud Deraison

O clone executou o hook

Em 10 de novembro, o Git lançou a 2.56.1 e seis backports para corrigir a CVE-2026-111760: um repositório com um caminho extremamente longo pode trocar o arquivo .git de um submódulo por um link simbólico para hooks do atacante, e o git os executa durante um clone recursivo. Agentes de código clonam repositórios com seus submódulos o dia inteiro. No Bromure Agentic Coding, esse hook roda em uma VM com credenciais substitutas e uma rede com negação padrão, a Security Timeline mostra a cadeia de processos do hook até o git clone do agente, e o Rewind home tira da máquina o clone e tudo o que ele deixou.

O agente rodou git clone --recursive. Não aprovou mais nada, não abriu nenhum arquivo e não instalou nenhum pacote. O git executou o hook do repositório enquanto o clone ainda estava em andamento.

Em 10 de novembro, o projeto Git lançou o Git 2.56.1, com backports para as versões 2.55.1, 2.54.1, 2.53.1, 2.52.1, 2.51.3 e 2.50.2. A versão corrige seis vulnerabilidades. O texto do GitHub e o The Hacker News destacam uma delas, a CVE-2026-111760: execução de código durante um clone recursivo.

Antes de gravar um caminho em uma árvore de trabalho, o git verifica se esse caminho não sobrescreve os metadados do próprio git. Um truncamento de inteiro no código que trata o índice permite que um caminho extremamente longo passe por essa verificação com um nome e vá parar no disco com um nome mais curto. Quem escolhe o nome mais curto é o atacante, e ele pode ser .git.

Em um submódulo recém-clonado, .git não é um diretório, e sim um arquivo que aponta para o repositório do submódulo. O git se recusa a substituir um diretório .git por um link simbólico, mas não tem regra equivalente para um arquivo .git. O repositório malicioso o substitui por um link simbólico para um diretório controlado pelo atacante, cheio de hooks e configuração. Quando o clone recursivo chega a esse submódulo, o git usa o diretório do atacante, e o hook roda como o usuário que digitou o comando de clone.

É o terceiro bug desse tipo em três anos. A CVE-2024-32002 usava sistemas de arquivos que não diferenciam maiúsculas de minúsculas para gravar um hook por meio de um link simbólico de submódulo. A CVE-2025-48384 usava um retorno de carro no fim do caminho de um submódulo, e a CISA a incluiu em sua lista de vulnerabilidades exploradas. Cada correção fechou uma forma de colocar um hook no diretório git de um submódulo.

Por enquanto, o GitHub recomenda “evitar clones recursivos de repositórios não confiáveis” até que você tenha atualizado todas as suas cópias do git.

Agentes clonam com submódulos

“Clone este repositório e faça o build funcionar” é um dos pedidos mais comuns a um agente de código. O agente roda git clone, o build falha porque vendor/ ou third_party/ está vazio, e ele roda git submodule update --init --recursive, ou vai direto para git clone --recursive porque o README manda. Os dois caminhos chegam ao código vulnerável.

Agentes também clonam repositórios que ninguém da equipe olhou ainda: a biblioteca que aparece em um stack trace, a reprodução mínima anexada a uma issue, o fork de onde veio um pull request, o “projeto de exemplo” para o qual um post de blog aponta. As equipes costumam deixar os agentes rodarem git clone sem perguntar, já que um clone baixa arquivos e não executa nada. Com esse bug, o hook já rodou quando o clone termina.

Quem inicia o hook é o git, e ele roda como o desenvolvedor, com todo o acesso que o shell do agente tiver. Em um Mac, esse usuário pode ler ~/.ssh, ~/.aws, ~/.config/gh, ~/.npmrc, cada .env de cada checkout e os cookies do navegador.

Depois vem a atualização. Um Mac de desenvolvedor tem várias cópias do git: a das ferramentas de linha de comando da Apple, que a Apple atualiza no próprio ritmo, a do Homebrew, as embutidas no GitHub Desktop e no app GitHub Copilot (o GitHub diz que builds corrigidos “estão sendo preparados”), e as que alguns IDEs trazem. Quando o THN verificou, o Git for Windows ainda não tinha uma versão baseada na 2.56.1. Um agente usa o primeiro git que encontrar no PATH, então é preciso atualizar todos.

CVE-2026-111760, um único git clone --recursiveO agente clonagit clone --recursive …/repro.git“faça o build funcionar”muitas vezes liberadoA verificação passaum caminho muito longoé verificado com um nome,truncado e gravado como.gitSubmódulo sequestradoseu arquivo .git viraum link para uma pasta dehooks do atacantesub/.git → evil/O hook rodadurante o clone,como o desenvolvedor,iniciado pelo git,não pelo agenteO que o hook pode ler no Mac de um desenvolvedor~/.ssh ~/.aws ~/.config/gh ~/.npmrc */.env cookies do navegadorCópias do git a atualizar: ferramentas de linha de comando da Apple, Homebrew, GitHub Desktop, Copilot, IDEs.
Um clone recursivo de um repositório malicioso. Um caminho longo o bastante para ser truncado passa pela verificação de metadados do git e é gravado como .git, trocando o arquivo .git de um submódulo por um link simbólico para os hooks do atacante. O git os executa durante o clone, como o desenvolvedor.

O mesmo clone no Bromure Agentic Coding

O Bromure Agentic Coding roda Claude Code, Codex, Grok, Kimi e omp em VMs Ubuntu no seu Mac, uma VM por máquina. O shell do agente, o git dele e tudo o que o git inicia rodam dentro dessa VM. As credenciais lá dentro são substitutas, e toda conexão que ela faz passa por um switch virtual e um proxy no Mac.

Pense no pior caso: um git sem correção, um repositório malicioso e um agente que roda git clone --recursive sem perguntar a ninguém. O hook roda, dentro da máquina.

Ele roda em uma VM, longe dos arquivos do seu Mac

O hook roda como ubuntu em um home Linux que guarda os checkouts da máquina, os caches de pacotes e o histórico do shell. A pasta pessoal do seu Mac, as Chaves e os perfis do navegador não estão na VM. A VM só vê as pastas que você escolheu compartilhar com ela.

Quando você inicia uma sessão a partir da URL de um repositório, o clone também roda na máquina. Em máquinas que usam o motor OpenShell, as chamadas de git do próprio Bromure na VM sempre rodam dentro do sandbox convidado, porque, nas palavras do manual, “um repositório pode apontar o git para um programa de sua escolha”.

As credenciais que ele encontra são substitutas

Um hook escrito para roubar credenciais encontra todas nos lugares de sempre, no formato que cada ferramenta espera, e todas são substitutas. Um token ghp_ que o GitHub nunca emitiu, uma ANTHROPIC_API_KEY que começa com sk-ant-api03-brm-, uma chave secreta da AWS falsa. Os valores reais ficam criptografados no Mac, e o proxy só troca um substituto pelo valor real em requisições para os hosts aos quais aquela credencial pertence.

Também não há chave privada para copiar. O SSH_AUTH_SOCK da VM é uma ponte para um agente no Mac. Ele pode listar chaves e pedir assinaturas, e os bytes das chaves nunca entram na VM.

Ele não tem para onde mandá-las

Toda conexão que sai da VM passa pelo Mac. Configure Unmatched traffic do Bromure Firewall como Deny e a máquina alcança os hosts da lista e mais nada. Ou mude a máquina para OpenShell + Sentry: a política inicial permite GitHub, npm e PyPI somente leitura, além dos espelhos do Ubuntu, e nega todo o resto. Um hook que tenta contatar o próprio servidor recebe uma recusa e uma linha vermelha na Security Timeline.

Com Enforce binaries ativado, um atestador de root na VM liga cada conexão ao programa que a abriu, e cada regra nomeia os programas que podem usá-la. A recusa mostra qual regra e qual programa, então um curl iniciado por um hook aparece como curl, não como git.

Se o hook tentar reutilizar um token, não ganha nada com isso. Enviado a qualquer host que não seja o dele, um substituto é pego pelo proxy, que responde HTTP 451, pausa a VM e abre um alerta chamado This environment may have been compromised, com o nome da credencial e dos dois hosts. Enviado ao GitHub, ele não consegue enviar um backdoor para seus outros repositórios: máquinas novas colocam todas as forjas em Prompt before write, então um git push saindo da VM espera você aprová-lo em uma caixa de diálogo no Mac.

O agent watchdog observa a sessão de fora da VM: rajadas de requisições bloqueadas, credenciais fora do lugar, destinos novos depois que a sessão se estabilizou. No modo Quarantine, ele corta a rede e pausa a VM em milissegundos.

Ele só pode mexer nos arquivos que a política permite

No OpenShell, uma filesystem_policy limita o que o agente e cada processo que ele inicia podem ler e gravar, com o Landlock do Linux. Nem o root da VM consegue removê-la. O hook herda isso do git clone do agente, então quando vai procurar em pastas que a política não lista, recebe “permission denied”. Cada recusa é uma linha Guest sandbox na Timeline, e um alarme dispara quando um mesmo programa bate nos limites 20 vezes em um minuto.

VM da máquinaO agente rodagit clone --recursive …o hook roda como ubuntuO que o hook encontratokens substitutos: ghp_…, brm-…ponte do agente SSH, sem chavesem home do Mac, sem ChavesGuest sandbox (OpenShell)Landlock: só os caminhos listados,até para o root da VMSeu MacNegação padrãohosts fora da lista negados; comEnforce binaries, nomeia o programaArmadilhassubstituto para host estranho:HTTP 451, VM pausadagit push: Prompt before writeSegredos reais, nas Chavestrocados só em requisições aohost ao qual cada um pertenceVeja e desfaçaNetwork lineageprompt → claude → bash→ git → hook → curl→ recusadoRewind home…o home como era em umainicialização anterior; sem cloneReset diskdisco do sistema clonado de novoa partir da imagem base
O mesmo clone recursivo em uma máquina Bromure. O hook roda na VM, encontra substitutos e nenhuma chave privada, e toda conexão que abre esbarra no firewall ou na política OpenShell no Mac. A sentinela de kernel liga cada conexão ao processo do hook e ao git clone do agente, e o Rewind home remove o clone e tudo o que ele deixou no home.

Você vê qual clone o executou

A transcrição do agente mostra um git clone bem-sucedido. O hook nunca passou por uma chamada de ferramenta, então o agente não tem registro dele.

Em uma máquina com a sentinela de kernel, um pequeno módulo de kernel relata cada execução de programa e cada conexão de dentro do kernel da VM, por um canal que o agente não consegue silenciar. Clique duas vezes na conexão recusada na Security Timeline e a network lineage dela se abre: o prompt que você deu, o raciocínio e a intenção declarada do agente, a chamada de ferramenta (Bash, git clone --recursive …, correspondência exata) e a cadeia de processos de claude passando por bash e git até o hook e o programa que ele iniciou. Other flows from this tool call lista todo o resto a que esse clone se conectou.

Essa linha te dá o repositório, o prompt que mandou o agente até ele e o host que o hook tentou alcançar.

Desfazendo

O clone malicioso, a pasta de hooks via link simbólico e tudo o que o hook gravou em ~/.bashrc ou ~/.config ficam no home da máquina, que é uma imagem de disco própria. O Bromure tira um checkpoint copy-on-write dele na primeira inicialização bem-sucedida de cada dia. Desligue a máquina, abra ⋯ › Rewind home… e escolha um ponto anterior ao clone. Na próxima inicialização, o home volta a ser como era naquele momento. O home atual é guardado como um novo ponto na mesma lista, então você ainda pode voltar a ele para pegar um arquivo.

Se o hook chegou ao disco do sistema com sudo, o Reset disk o clona de novo a partir da imagem base assinada e não mexe no home. Para um repositório em que você não confia nem um pouco, bromure-cli vm run --rm te dá uma máquina descartável que é apagada quando para: clone lá, dê uma olhada e deixe ir.

Um único git para atualizar por máquina

O git do agente é o pacote git do Ubuntu na VM, não o da Apple, do Homebrew ou de um bundle de app. Atualizá-lo é sudo apt install --only-upgrade git na máquina, e cada download de .deb é uma linha Supply chain na Timeline, então você pode conferir quais máquinas baixaram o novo. Quando o Bromure publica uma nova imagem base, cada máquina oferece a atualização na inicialização seguinte, e Yes, upgrade passa o disco do sistema para a nova imagem sem mexer no home.

Nada que valha roubar

O hook encontra tokens substitutos, uma ponte SSH sem bytes de chave e nenhum home do Mac. Um substituto enviado ao host errado pausa a VM.

Nenhum lugar para ir

A negação padrão no Mac recusa o servidor do hook, e um push para o GitHub espera o seu OK em uma caixa de diálogo no Mac.

Uma linha conta a história

A sentinela de kernel liga a conexão recusada ao hook, ao git, ao clone do agente e ao prompt que pediu esse clone.

Volte para antes

O Rewind home tira da máquina o clone e o que ele gravou. O Reset disk restaura o disco do sistema a partir da imagem base.

O que fazer esta semana

  • Atualize o git para a 2.56.1 ou para um backport corrigido em todo lugar onde houver uma cópia: Homebrew, suas máquinas Linux, imagens de CI e qualquer app que traga o git embutido. Fique de olho nas atualizações das ferramentas de linha de comando da Apple, do GitHub Desktop e do app Copilot à medida que saírem.
  • Até lá, não clone repositórios não confiáveis com --recursive nem rode git submodule update --init neles, e tire git clone da lista de comandos que seus agentes rodam sem perguntar.
  • No GitHub Enterprise Server, passe para 3.19.15, 3.20.11, 3.21.9 ou 3.22.4.

Depois, dê aos seus agentes uma máquina onde um hook que roda durante um clone não encontra nada para roubar nem para onde mandar, e onde remover o que ele deixou é questão de voltar no tempo. A configuração da negação padrão, das políticas OpenShell e da sentinela de kernel está no capítulo Sandbox Policy do manual.