RSC Sentinel

Una extensión de Firefox para detectar vulnerabilidades React2Shell (CVE-2025-55182 y CVE-2025-66478) en aplicaciones web.

👁️ Descripción general

RSC Sentinel es una extensión de navegador Firefox para investigadores y educadores de seguridad que desean observar los indicadores de React Server Components (RSC) y Next.js App Router mientras navegan. Se enfoca en la detección pasiva por defecto, resaltando posibles señales sin alterar el comportamiento del sitio. Para evaluaciones autorizadas, también ofrece herramientas manuales opcionales para sondeo activo y ejecución controlada de comandos iniciada por el usuario.

🧩 Características

• Detección Pasiva: Observa automáticamente los indicadores de alto nivel de RSC y App Router durante la navegación normal.
• Sondeo Activo: Permite una solicitud de huella digital iniciada por el usuario para recopilar señales adicionales de manera controlada.
• Ejecución Manual de Comandos: Proporciona un flujo de trabajo de ejecución manual dirigido por el usuario, destinado estrictamente a pruebas autorizadas.

🧠 Cómo Funciona la Detección (Alto Nivel)

RSC Sentinel evalúa una combinación de indicadores de tiempo de ejecución, encabezados de respuesta HTTP y patrones de contenido de respuesta que están comúnmente asociados con el comportamiento de RSC y App Router. Los resultados se presentan como señales y deben interpretarse como indicadores, no como prueba definitiva de vulnerabilidad.

🦊 Instalación (Firefox)

Instale la extensión desde el código fuente usando el flujo de trabajo de complementos temporales de Firefox:

1. Abra Firefox y navegue a about:debugging.
2. Seleccione Este Firefox en la barra lateral izquierda.
3. Haga clic en Cargar complemento temporal.
4. Elija el archivo manifest.json del directorio del proyecto.

La extensión se cargará inmediatamente para la sesión actual del navegador.

▶️ Uso

• Navegue normalmente; la extensión realiza la detección pasiva en segundo plano.
• Abra el popup de la extensión desde la barra de herramientas de Firefox para ver las señales detectadas.
• Use Ejecutar sonda de huella digital para iniciar una sonda manual cuando esté autorizado.
• Revise los resultados en la interfaz del popup, donde se muestran claramente las señales pasivas y activas.

🗂️ Estructura del Proyecto

Ejemplo de diseño para el código fuente de la extensión:

.
├── manifest.json
├── background.js
├── content.js
├── popup.html
├── popup.js
├── images/
│   └── img2.png
│   └── img1.png
└── rules.json

⚠️ Uso Responsable / Advertencia

Esta extensión solo debe usarse en sistemas que posea o donde tenga permiso explícito para realizar pruebas. El mal uso de las herramientas de seguridad puede ser ilegal o poco ético. Use RSC Sentinel de manera responsable y de acuerdo con todas las leyes y políticas aplicables.

📜 Licencia y Descargo de Responsabilidad

Este proyecto es de código abierto y se proporciona con fines educativos y de investigación de seguridad autorizada. El autor no es responsable del mal uso. Siempre realice las pruebas de manera legal, ética y con permiso explícito.