Reconator est un framework automatisé de reconnaissance. Ajoutez une cible — seule ou en masse — et le worker exécute environ 17 modules de reconnaissance (enum de sous-domaines, dirbrute, exploration JS/liens, empreinte WAF, vérification de prise de contrôle, tri GF, etc.). Le tableau de bord affiche les résultats par module dès leur arrivée.

Stack

Démarrage rapide — Docker Compose

git clone https://github.com/gokulapap/Reconator
cd Reconator
cp .env.example .env       # optionnel : ajouter les clés Telegram / webhook / clé API
docker compose up --build

Démarrage rapide — Heroku

Ou via CLI (utilise le stack de conteneurs heroku.yml — une seule image sert l'UI + l'API, le dyno worker exécute la file d'attente) :

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

Développement local

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

# worker (terminal séparé)
python -m app.worker

# web (terminal séparé)
cd frontend && npm install && npm run dev   # proxy /api → :8000

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

Fonctionnalités

• Ajout en masse — collez jusqu'à 500 domaines ; rapport d'erreur/conflit par ligne
• Étiquettes + filtrage — étiquetez des cibles, filtrez la liste par étiquette
• Sélection de modules — planifiez uniquement les modules souhaités par cible
• Annulation + re-scann — arrêtez une cible en cours entre les modules ; re-scann en un clic
• Résultats par module — la sortie de chaque vérification est sa propre ligne, avec statut, timing, erreurs
• Recherche + surbrillance dans les résultats — filtrez les énormes listes de sous-domaines sur place
• Export CSV / JSON — extrayez toute la file d'attente de l'API
• Tableau de bord en direct — compteurs, durée moyenne de scan, activité récente
• Authentification par clé API optionnelle — définissez ADMIN_API_KEY, toutes les mutations nécessitent X-API-Key
• Limitation de débit — slowapi limite les écritures (par défaut : 20/min simple, 5/min en masse)
• Métriques Prometheus — taux de requêtes, latence, nombre de scans, profondeur de la file
• Diffusion Telegram + webhook — abstraction du notifieur, les deux peuvent fonctionner ensemble
• Interface claire + sombre — préférence stockée par navigateur

Endpoints de l'API

OpenAPI sur /docs.

Configuration

Ce qui a changé depuis la v1

• Flask → FastAPI ; vecteurs d'injection SQL éliminés (SQLAlchemy paramétré)
• HTML intégré → tableau de bord React + shadcn/ui
• Blob base64 unique dans la DB → lignes par module avec statut / timestamps / erreurs
• Boucle de polling cron.py → worker avec verrouillage de ligne, arrêt gracieux, annulation
• Buildpacks Heroku manuels → stack de conteneurs via heroku.yml
• Ajouté : auth par clé API, limitation de débit, IDs de requête, Prometheus, hook Sentry, import en masse, étiquettes, re-scann, annulation, notifieur webhook, export CSV/JSON

Avertissement

Uniquement pour des tests autorisés. Utilisez sur des systèmes que vous possédez ou pour lesquels vous avez la permission de tester. Publié sous GPL-3.0.