Reconator è un framework di ricognizione automatizzato. Aggiungi un target — singolo o in blocco — e il worker esegue ~17 moduli di ricognizione contro di esso (enumerazione sottodomini, dirbrute, estrazione JS/link, fingerprint WAF, controllo takeover, triage GF e altro). La dashboard mostra l'output per modulo non appena arriva.

Stack

Avvio rapido — Docker Compose

git clone https://github.com/gokulapap/Reconator
cd Reconator
cp .env.example .env       # opzionale: aggiungi chiavi Telegram / webhook / API key
docker compose up --build

Avvio rapido — Heroku

Oppure via CLI (usa lo stack container heroku.yml — una singola immagine serve UI + API, il dyno worker esegue la coda):

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

Sviluppo locale

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

# worker (terminale separato)
python -m app.worker

# web (terminale separato)
cd frontend && npm install && npm run dev   # proxy /api → :8000

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

Funzionalità

• Aggiunta in blocco — incolla fino a 500 domini; report di errori/conflitti per riga
• Tag e filtri — tagga i target, filtra l'elenco per tag
• Selezione moduli — pianifica solo i moduli desiderati per target
• Annulla e riscansiona — ferma un target in esecuzione tra i moduli; riscansiona con un clic
• Risultati per modulo — l'output di ogni controllo è una riga separata, con stato, tempi, errori
• Ricerca ed evidenziazione nell'output — filtra enormi dump di sottodomini sul posto
• Esportazione CSV / JSON — estrai l'intera coda dall'API
• Dashboard in tempo reale — conteggi, durata media scansione, attività recente
• Autenticazione opzionale con chiave API — imposta ADMIN_API_KEY, tutte le mutazioni richiedono X-API-Key
• Limitazione della frequenza — slowapi limita le scritture (default: 20/min singolo, 5/min blocco)
• Metriche Prometheus — frequenza richieste, latenza, conteggi scansione, profondità coda
• Notifiche Telegram e webhook — astrazione del notificatore, entrambi possono funzionare insieme
• Interfaccia chiara e scura — preferenza salvata per browser

API disponibili

OpenAPI su /docs.

Configurazione

Novità rispetto a v1

• Flask → FastAPI; vettori di SQL injection eliminati (SQLAlchemy parametrizzato)
• HTML incorporato → dashboard React + shadcn/ui
• Singolo blob base64 nel DB → righe per modulo con stato/timestamp/errori
• Loop di polling cron.py → worker con blocco delle righe, arresto graduale, cancellazione
• Buildpack Heroku manuali → stack container tramite heroku.yml
• Aggiunti: autenticazione con chiave API, limitazione della frequenza, ID richiesta, Prometheus, hook Sentry, import bulk, tag, riscansione, cancellazione, notificatore webhook, esportazione CSV/JSON

Dichiarazione di non responsabilità

Solo per test autorizzati. Utilizza su sistemi di tua proprietà o per i quali hai il permesso di valutare. Rilasciato sotto licenza GPL-3.0.