Reconator es un framework automatizado de reconocimiento. Añade un objetivo — solo o en lote — y el trabajador ejecuta ~17 módulos de reconocimiento contra él (enumeración de subdominios, dirbrute, minería de JS/enlaces, huella de WAF, verificación de takeover, triaje GF, y más). El panel muestra la salida por módulo a medida que llega.

Stack

Inicio rápido — Docker Compose

git clone https://github.com/gokulapap/Reconator
cd Reconator
cp .env.example .env       # opcional: añadir claves de Telegram / webhook / API key
docker compose up --build

Inicio rápido — Heroku

O mediante CLI (usa el stack de contenedores heroku.yml — una sola imagen sirve la interfaz + API, el dyno worker ejecuta la cola):

heroku create my-reconator --stack=container
heroku addons:create heroku-postgresql:essential-0
heroku config:set ADMIN_API_KEY=$(openssl rand -hex 32)   # recomendado
heroku config:set TELEGRAM_API_KEY=... TELEGRAM_CHAT_ID=...   # opcional
git push heroku master
heroku ps:scale web=1 worker=1

Desarrollo local

# api
cd backend && pip install -r requirements.txt
uvicorn app.main:app --reload

# worker (terminal separada)
python -m app.worker

# web (terminal separada)
cd frontend && npm install && npm run dev   # proxys /api → :8000

# pruebas + lint
cd backend && pytest && ruff check .

Características

• Añadido masivo — pega hasta 500 dominios; informe de error/conflicto por fila
• Etiquetas + filtrado — etiqueta objetivos, filtra la lista por etiqueta
• Selección de módulos — programa solo los módulos que quieras por objetivo
• Cancelar + reescanear — detiene un objetivo en ejecución entre módulos; reescanear con un clic
• Resultados por módulo — la salida de cada verificación es su propia fila, con estado, tiempo, errores
• Búsqueda + resaltado en salida — filtra enormes volcados de subdominios en el lugar
• Exportación CSV / JSON — extrae toda la cola de la API
• Panel en vivo — conteos, duración promedio de escaneo, actividad reciente
• Autenticación opcional por clave API — establece ADMIN_API_KEY, todas las mutaciones requieren X-API-Key
• Límite de tasa — slowapi limita escrituras (por defecto: 20/min individual, 5/min masivo)
• Métricas Prometheus — tasa de solicitudes, latencia, conteos de escaneo, profundidad de cola
• Telegram + webhook fan-out — abstracción de notificador, ambos pueden ejecutarse juntos
• Interfaz clara + oscura — preferencia almacenada por navegador

Superficie de la API

OpenAPI en /docs.

Configuración

Cambios respecto a v1

• Flask → FastAPI; vectores de inyección SQL eliminados (SQLAlchemy parametrizado)
• HTML incrustado → panel React + shadcn/ui
• Único blob base64 en BD → filas por módulo con estado / marcas de tiempo / errores
• Bucle de sondeo cron.py → worker con bloqueo de filas, apagado elegante, cancelación
• Buildpacks manuales de Heroku → stack de contenedores mediante heroku.yml
• Añadido: autenticación por clave API, límite de tasa, IDs de solicitud, Prometheus, hook de Sentry, importación masiva, etiquetas, reescanear, cancelar, notificador webhook, exportación CSV/JSON

Aviso legal

Solo para pruebas autorizadas. Úselo en sistemas que posea o tenga permiso de evaluar. Publicado bajo GPL-3.0.