SubMon

Algunos dicen que el bug bounty no solo se trata de encontrar bugs, sino de ser el "primero" en encontrarlos. Estoy construyendo esta herramienta para notificar a los cazadores cuando aparecen nuevos subdominios.

Funcionalidades

• Puedes agregar tu objetivo favorito: nombre + dominio.
• Luego puedes hacer clic en scan o schedule un escaneo.
• Cuando el escaneo termina, recibirás una alerta de discord.
• Si configuras el programador, recibirás una notificación de discord cada vez que encuentre nuevos subdominios.

• Aquí puedes ver el resultado del último escaneo: qué subdominio es nuevo, cuál falta.
• También verás el título de ese subdominio, aunque podría no ser preciso.

Stack Tecnológico

Backend: FastAPI

• ORM: SQLModel
• Validación de datos: Pydantic
• Base de datos SQL: SQLite

Frontend: React

• ViteVibe coding

Herramientas de escaneo

• subfinder
• dnsx
• httpx

Pruébalo tú mismo

• Crear un Webhook de Discord

Instalación Manual

cd backend

# instalar herramientas
go install -v github.com/projectdiscovery/subfinder/v2/cmd/subfinder@latest
go install -v github.com/projectdiscovery/dnsx/cmd/dnsx@latest
go install -v github.com/projectdiscovery/httpx/cmd/httpx@latest

# añadir GOPATH/bin al PATH
export PATH=$PATH:$(go env GOPATH)/bin
# guarda el comando anterior en `~/.bashrc`
source ~/.bashrc  # o ~/.zshrc

# variables de entorno opcionales para el backend
export DB_NAME="database.db"
export DISCORD_WEBHOOK_URL="YOUR-DISCORD-WEBHOOK"

# crea un entorno virtual
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# ejecuta el servicio fastapi
python -m app.main

# ejecuta el worker en una nueva terminal
python -m app.services.worker

# consulta la documentación Swagger
http://localhost:8000/docs

# consulta ReDoc
http://localhost:8000/redoc

cd frontend

# ejecuta el frontend
npm i
npm install node
npm run dev

Docker Compose (recomendado)

Desde la raíz del proyecto:

# opcional: crea un archivo env y configura el webhook de Discord para alertas
cp .env.example .env
# luego edita .env y configura DISCORD_WEBHOOK_URL

# construye e inicia frontend + backend + worker
docker compose up --build -d

Abre:

• Frontend: http://localhost:5173
• Documentación de la API: http://localhost:8000/docs

# detener servicios
docker compose down

Flujo de trabajo

flowchart TD
    U[User / Frontend] -->|Scan Target| A[FastAPI Backend]
    U -->|Schedule Scan| A

    A -->|Create or update ScanRun = queued| DB[(SQLite)]
    W[Worker Loop] -->|Poll queued jobs + enqueue due schedules| DB
    W -->|Pick next queued ScanRun| S[Scanner Pipeline]

    S --> SF[subfinder]
    SF --> DX[dnsx]
    DX --> HX[httpx]
    HX --> D[Diff with existing subdomains]

    D -->|Insert new subdomain| DB
    D -->|Mark missing subdomain| DB
    D -->|Send new findings| DIS[Discord Webhook]

    S -->|success / failed| W
    W -->|Update ScanRun status| DB

1. El frontend activa los endpoints de escaneo o programación.
2. La API almacena el estado en ScanRun (queued, running, success, failed).
3. El worker recorre los trabajos en cola y programados.
4. El escáner ejecuta subfinder -> dnsx -> httpx, compara los resultados, actualiza la base de datos y envía alertas de Discord para nuevos subdominios.

• Notas de lanzamiento