Scanner React2Shell – com PoC

CVE-2025-55182 – PoC de RCE em React Server Components
Cliente de exploração educacional para o laboratório React2Shell da Hidden Investigations.

Este repositório contém uma ferramenta de exploração de prova de conceito (PoC) para um único host da vulnerabilidade React2Shell (CVE-2025-55182), direcionada a aplicações React Server Components / Next.js mal configuradas.

Ela foi projetada para ser usada apenas contra o laboratório React2Shell da Hidden Investigations oficial ou sistemas que você possua / administre explicitamente.

---

⚠️ Aviso Legal e Ético

Este projeto é fornecido estritamente para pesquisa educacional e de segurança defensiva:

• Use esta ferramenta somente em:
  • O laboratório React2Shell da Hidden Investigations oficial, ou
  • Sistemas que você possua ou para os quais tenha permissão explícita por escrito para testar.
• Não aponte isto para sites aleatórios, sistemas em produção ou infraestrutura que você não controla.
• Os autores e a Hidden Investigations não se responsabilizam por uso indevido ou danos.

Ao usar esta ferramenta, você concorda em seguir todas as leis e regulamentos aplicáveis.

---

Recursos

• 🔥 Cliente de exploração React2Shell para CVE-2025-55182
• 🎯 Focado em um único host (sem varredura em massa)
• 📡 Suporte para caminhos personalizados e listas de caminhos
• 🧪 Modo de verificação segura (sem comandos de SO, apenas uma sonda de detecção)
• 🪟 Modo compatível com Windows (whoami por padrão)
• 🛡️ Auxiliares de bypass de WAF:
  • Campo multipart de lixo (--waf-bypass, --waf-bypass-size)
  • Ajuste de layout do Vercel (--vercel-waf-bypass)
• 🔐 Opções de TLS (--insecure, cabeçalhos personalizados)
• 🧾 Saída JSON (-o/--output, --all-results)
• 🧘 Saída limpa no modo silencioso (perfeito para canalizar para outras ferramentas)

---

Requisitos

• Python: 3.8+ (testado com Python 3.10+)
• Dependências:
  • requests

Instale as dependências com:

pip install -r requirements.txt

---

Instalação

1. Clone o repositório da Hidden Investigations:

git clone https://github.com/hidden-investigations/react2shell-poc.git
cd react2shell-poc

2. (Opcional, mas recomendado) Crie um virtualenv:

python3 -m venv venv
source venv/bin/activate   # On Windows: venv\Scripts\activate

3. Instale os requisitos:

pip install -r requirements.txt

4. Execute a ferramenta:

python3 react2shell-scanner.py -h

---

Uso

Ajuda básica:

python3 react2shell-scanner.py -h

A ferramenta requer uma URL de destino:

python3 react2shell-scanner.py -t http://localhost:3000 -c "id"
# or
python3 react2shell-scanner.py --url http://localhost:3000 -c "id"

Se você executá-la sem -t/--target ou -u/--url, ela exibe uma mensagem de ajuda com a marca e encerra.

---

Opções de Linha de Comando

Alvo e caminhos

Opção	Descrição	Padrão
-t, --target	URL ou domínio de destino (obrigatório, a menos que --url seja usado)	Nenhum
-u, --url	Alias para --target (flag estilo Assetnote)	Nenhum
--path	Caminho a testar (pode ser usado várias vezes, ex.: /, /_next)	/
--path-file	Arquivo contendo caminhos a testar (um por linha)	Nenhum

Nota: Este PoC é apenas para um único host. A opção -l/--list está presente, mas intencionalmente desabilitada.

---

Comportamento de exploração / payload

Opção	Descrição	Padrão
-c, --command	Comando a executar no alvo (quando a exploração tem sucesso)	id
--safe-check	Usar um payload SAFE_CHECK (sem comando de SO, apenas uma string de marcação)	off
--windows	Ajustar padrões para alvos Windows (ex.: usar whoami quando o comando é id)	off
--waf-bypass	Antepor um grande campo multipart de lixo ao corpo da requisição para evasão de WAF	off
--waf-bypass-size KB	Tamanho do campo de lixo em KB ao usar --waf-bypass	128
--vercel-waf-bypass	Usar um layout multipart alternativo para ajustar o comportamento do WAF da Vercel (PoC simplificado)	off

---

Opções de HTTP / TLS

Opção	Descrição	Padrão
--timeout SECONDS	Tempo limite da requisição em segundos	15 (ou 20 se --waf-bypass e nenhum timeout definido)
-k, --insecure	Desabilitar verificação SSL (como curl -k)	off
-H, --header	Cabeçalho personalizado, ex.: -H "X-Forwarded-For: 127.0.0.1" (repetível)	Nenhum

---

Opções de saída / UX

Opção	Descrição	Padrão
-o, --output FILE	Escrever os resultados JSON em FILE	Nenhum
--all-results	Ao usar --output, incluir também resultados não vulneráveis	off
-v, --verbose	Modo verboso – mostrar o status HTTP e o cabeçalho X-Action-Redirect	off
-q, --quiet	Modo silencioso – imprime apenas a saída normalizada do comando em caso de sucesso	off
--no-color	Desabilitar saída colorida no terminal	off

Exemplo de modo silencioso (saída agradável, multilinha):

python3 react2shell-scanner.py --url http://localhost:3000 -q -c "ls -la"

Output:

total 12
drwxr-xr-x    1 root     root            10 Dec 13 21:13 .
drwxr-xr-x    1 root     root             0 Dec 13 21:13 ..
drwxr-xr-x    1 nextjs   nodejs          12 Dec 13 21:13 .next
drwxr-xr-x    1 nextjs   nodejs         396 Dec 13 21:13 node_modules
-rw-r--r--    1 nextjs   nodejs         733 Dec 13 21:13 package.json
drwxr-xr-x    1 root     root            12 Dec 13 19:13 public
-rw-r--r--    1 nextjs   nodejs        5661 Dec 13 21:13 server.js

---

Flags de varredura em massa (intencionalmente desabilitadas)

As seguintes flags existem para espelhar a CLI da Assetnote, mas não são implementadas neste PoC para evitar o uso indevido em varredura em massa:

Opção	Status
-l, --list	Não implementado
--threads N	Não implementado

Se você usar -l/--list, a ferramenta exibirá um aviso e encerrará, sugerindo que use o react2shell-scanner original da Assetnote para varredura segura em larga escala.

---

Exemplos

Execute contra o laboratório local:

python3 react2shell-scanner.py --url http://localhost:3000 -c "whoami"

Use o bypass de WAF com um campo de lixo maior: