
Kit de ferramentas forenses e habilidades de agente para investigar o Rails Active Storage/libvips CVE-2026-66066: detecta indicadores de blobs manipulados, janelas de exposição e exfiltração de dados.
Ferramentas e método para responder a duas perguntas sobre uma aplicação Rails e a CVE-2026-66066, a leitura arbitrária de arquivos do Active Storage e libvips conhecida como KindaRails2Shell:
O aviso GHSA-xr9x-r78c-5hrm explicava a vulnerabilidade e nomeava as versões corrigidas, mas não divulgava detalhes suficientes para avaliar essas questões. Este projeto tem como objetivo ajudar nisso.
Este é um repositório de documentação e habilidades, e não uma biblioteca. Nada aqui é instalado na sua aplicação. Um agente o lê e trabalha contra a sua aplicação clonada em outro lugar, e o único script que roda em produção é um único arquivo autocontido que você copia para um contêiner.
O Rails decide que um blob pode ser processado como imagem lendo uma coluna content_type
que um upload direto permite ao cliente definir sem que os bytes jamais sejam examinados.
O libvips então decide o que o arquivo realmente é farejando os magic bytes. Um arquivo
cujos primeiros dez bytes afirmam MATLAB 5.0 é roteado para o carregador MATLAB do libvips,
que o entrega ao libmatio, que despacha com base em um intervalo de bytes diferente e
encontra MAT 7.3, que é HDF5. A Lista de Arquivos Externos do HDF5 permite que os bytes de um conjunto de dados
vivam em outro arquivo nomeado por caminho e deslocamento, então renderizar a "imagem" lê um
arquivo escolhido pelo atacante do servidor e retorna seu conteúdo como pixels. A mesma
confusão, duas vezes, em duas camadas que não conseguem ver os campos uma da outra.
reference/the-attack.md traça toda a cadeia de chamadas, desde a requisição de entrada
até o ponto em que o libmatio abre o arquivo alvo, com as quatro junções
críticas marcadas. reference/the-investigation.md então explica por que o ataque
é investigável: ele deixa três artefatos de força crescente, e
o mais forte deles é a variante renderizada, que mantém os bytes roubados como
valores de pixel no seu próprio armazenamento de objetos.
As duas habilidades rodam em ordem. A primeira produz a janela de exposição; a segunda não pode começar sem ela.
| Habilidade | Pergunta | Produz |
|---|---|---|
kr2s-was-i-vulnerable | Esta aplicação já esteve exposta? | Uma janela de exposição e os fatos que a varredura precisa |
kr2s-was-i-exploited | Alguém a usou, e o que conseguiu? | Uma análise forense escrita |
Ambas são escritas para um agente, e ambas são legíveis por uma pessoa que quer fazer
o trabalho manualmente. Cada uma tem um ponto de entrada SKILL.md e um references/guide.md
contendo o processo real, suas verificações de avaliação e seus modos de falha.
Se você está corrigido e quer saber se deveria se importar, execute a primeira. Seu resultado é uma janela em vez de um sim ou não, porque para a maioria das pessoas lendo isto a resposta no presente é "não, nós corrigimos", e a resposta útil é quais anos uma investigação teria que cobrir.
Clone este repositório e mantenha o clone. As duas habilidades compartilham os documentos de referência
em reference/, e seus guias os leem por caminho relativo ao repositório,
então um diretório de habilidade copiado sozinho para outro lugar vai dar em beco sem saída.
O mais fácil é iniciar seu agente dentro do clone e dizer a ele onde está sua
aplicação. AGENTS.md o orienta a partir daí, incluindo a parte que as pessoas erram,
que é que este repositório é a ferramenta e não o objeto.
Caso contrário, aponte para o arquivo e diga isso, o que funciona em qualquer agente que consiga ler arquivos locais:
Read /path/to/rails-forensics-CVE-2026-66066/skills/kr2s-was-i-vulnerable/SKILL.md
and follow it. My application is at /path/to/my-app.
No Claude Code, você pode, em vez disso, instalá-las para que sejam acionadas por conta própria, criando links simbólicos em vez de copiar, o que mantém os links apontando para o clone:
ln -s "$PWD/skills/kr2s-was-i-vulnerable" ~/.claude/skills/
ln -s "$PWD/skills/kr2s-was-i-exploited" ~/.claude/skills/
Use .claude/skills/ dentro de um projeto em vez de ~/.claude/skills/ se você
preferir restringi-las a uma única aplicação.
De qualquer forma, informe ao agente onde está sua aplicação. As skills deixam explícito que este repositório e a aplicação em investigação são duas raízes diferentes, e que eles podem ler a segunda, mas nunca escrever nela.
AGENTS.md orientation for an agent started in this directory
reference/the-attack.md how the vulnerability works, traced call by call
reference/the-investigation.md why an investigation is possible, and where it runs out
skills/ the two skills
RUNBOOK.md operator's guide to the scanner: flags, verdicts, resuming
lib/crafted_mat_file.rb the detector
bin/ the scanner and three analysis utilities
test/ the test suite
Os dois documentos de referência são a metade em linguagem simples deste repositório e são autónomos. Leia-os se quiser compreender o problema, execute as skills se quiser uma resposta sobre uma aplicação em particular.
bin/kr2s_scan_active_storage_blobs.rb é gerado a partir de lib/ por rake build
e é versionado, pelo que executá-lo em produção não requer passo de build nem um segundo
ficheiro.
lib/crafted_mat_file.rb identifica o ficheiro forjado que este ataque requer. Lê
dois campos de cabeçalho dos primeiros 128 bytes de um objeto e não precisa
de mais nada, razão pela qual a análise consegue classificar um candidato a partir de uma leitura por intervalos
em vez de o descarregar. reference/the-attack.md explica quais campos e
porque nenhum escritor legítimo produz essa combinação.
Este repositório deliberadamente não inclui código que construa ficheiros forjados, nem
ficheiros forjados. Os testes do detetor sintetizam os 128 bytes de cabeçalho de que
necessitam em Ruby puro, que é tudo o que o detetor lê. reference/the-attack.md
descreve a estrutura por completo, pelo que nada está a ser ocultado a um leitor
que tente compreender o ataque. O que está ocultado é um gerador funcional que
poderia ser redirecionado para um caminho arbitrário alterando um único argumento.
Coberto: Active Storage, em aplicações que utilizam o processador de variantes
:vips, onde os registos de variantes eram rastreados.
Não coberto: qualquer outro local onde uma aplicação entregue ficheiros fornecidos pelo utilizador ao
libvips. Outras bibliotecas de upload, clientes diretos de object-store e sistemas
personalizados de avatar ou logótipo necessitam cada um da sua própria análise, e o scanner aqui não
o fará. kr2s-was-i-vulnerable fará com que os enumere, para que sejam nomeados
em vez de silenciosamente omitidos de uma conclusão.
Um resultado limpo desta ferramenta é evidência forte, não prova. Ambas as skills o dizem, repetidamente e especificamente, e o modelo de análise tem uma secção de limitações que não é opcional.
Isto surgiu de uma investigação real na 37signals, que varreu um grande armazenamento Active Storage de produção durante todo o período em que a vulnerabilidade existiu. A ferramenta identificou corretamente os ficheiros de teste carregados pelos investigadores de segurança que reportaram a falha, que é a única evidência externa disponível de que o detetor encontra o que é suposto encontrar.
Descubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.