React2Shell Detector

Scanner Heurístico para Vulnerabilidades de Componentes de Servidor React (RSC) — incluindo comportamento estilo React2Shell (CVE-2025-55182)

Visão Geral

react2shell_detector.py é um scanner de segurança seguro e não invasivo projetado para detectar sistemas potencialmente expostos a vulnerabilidades de desserialização de Componentes de Servidor React (RSC) — incluindo a classe de problemas React2Shell que afeta React 19 e certas configurações de servidor Next.js.

Esta ferramenta não realiza exploração e depende de um motor heurístico de múltiplos sinais:

• Detecção de recursos RSC
• Identificação de cabeçalhos e frameworks
• Inferência de versão Next.js
• Descoberta de endpoints RSC
• Comportamento de digest/parser
• Sondagem RSC no lado do servidor (modo seguro)

É adequado para:

• Equipes de Segurança de Aplicações
• Testadores de penetração
• Caçadores de bugs
• Portões de segurança CI/CD e SDLC
• Laboratórios de pesquisa em segurança

Aviso Importante

Este scanner realiza apenas sondagens RSC benignas.
Utilize-o apenas em sistemas que você possui ou para os quais está explicitamente autorizado a testar.

A varredura não autorizada pode violar leis ou políticas organizacionais.

Características

• Escanear uma URL ou alvos em massa a partir de uma lista .txt
• Varredura multi-thread
• Exportação JSON para CI / dashboards
• Detecta:
  • Exposição de content-type RSC
  • Impressões digitais de versão Next.js e React
  • Comportamento de endpoint RSC
  • Anomalias de digest / parser
  • Padrões de 5xx induzidos por RSC
• Pontuação de confiança (low → very_high)
• Interface CLI limpa
• Projetado para integração em programas AppSec

Instalação

Clone o repositório:

git clone https://github.com/<yourname>/react2shell-detector.git
cd react2shell-detector

Uso

python react2shell_detector.py -u https://example.com

ou

python react2shell_detector.py -f targets.txt

ou

python react2shell_detector.py -f targets.txt -t 20