Outil CLI Python pour l'analyse rapide d'IOC (IPs, Domaines, CVE) via 6 API gratuites de Threat Intel. Sorties : Excel coloré, JSON, CSV. Utilise : VT, Shodan, AbuseIPDB.
Enquêtez sur des IP, domaines, hachages et CVE à travers 6 API gratuites de renseignement sur les menaces — sans jongler entre les onglets du navigateur.
Démarrage rapide · Utilisation · Architecture · Clés API · Captures d'écran · Contribution
🚀 Fièrement mis en avant dans le dépôt officiel Awesome OSINT.
🧠 Une contribution ThreatLens est mise en avant dans le XERJ Corpus Hub.
ThreatLens est un outil en ligne de commande unique qui unifie les recherches de renseignement sur les menaces à travers les sources OSINT gratuites les plus fiables. Au lieu de coller une IP dans cinq sites web différents, ThreatLens les interroge toutes en parallèle, normalise les résultats et vous donne un verdict clair — dans le terminal, ou dans un rapport Excel/JSON/CSV soigné et codé par couleurs.
Conçu pour les analystes SOC, les intervenants en cas d'incident, les chasseurs de menaces et toute personne souhaitant un enrichissement rapide et fiable des IOC sans quitter le shell.
|
Pourquoi ThreatLens
|
Pas adapté pour
|
| Fonctionnalité | Détails |
|---|---|
| 🎯 Types d'IOC | IP, domaine, URL, empreinte de fichier (MD5 / SHA1 / SHA256), CVE |
| 🔌 API intégrées | AbuseIPDB, VirusTotal, AlienVault OTX, Shodan, URLScan.io, NVD, CISA KEV, EPSS |
| 📄 Analyse de journaux | Extraction automatique des IOC depuis des fichiers texte/journaux, plus prise en charge native de Zeek, Suricata eve.json, Sysmon (JSON) et JSONL générique |
| 🧭 Cartes de décision CVE | Recommandation déterministe et explicable Patch / Isoler / Surveiller / Non affecté par CVE, fondée sur CISA KEV, EPSS, CVSS et l'exposition corrélée des actifs |
| 🗂️ Inventaire des actifs | Import d'un CSV d'hôtes/IP avec criticité et statut exposé à Internet ; corrélé aux résultats CVE |
| 📤 Export SIEM | Export optionnel vers Splunk HEC, Elastic _bulk et Microsoft Sentinel (API moderne Logs Ingestion) |
| 🧾 Packs de preuves | Export ZIP d'une investigation avec un manifeste SHA-256 pour une chaîne de possession de base |
| 📊 Rapports | Excel (code couleur), JSON, CSV |
| 💾 Cache local | Cache SQLite avec TTL configurable — évite de réinterroger les IOC connus, plus un flux CISA KEV mis en cache (TTL 24h) |
| 🔐 Contrôles de confidentialité | Modes standard, passif, fournisseurs approuvés uniquement et local uniquement ; les paramètres de requête d'URL sensibles sont supprimés avant les recherches externes |
| 👁️ Liste de surveillance des IOC | Liste de surveillance SQLite locale avec expiration, analyses manuelles et suivi des changements pour les verdicts et signaux de risque |
| 🧠 Mémoire d'investigation | Recherche des observations d'IOC enregistrées, comparaison de l'historique des verdicts/sources, détection des IOC co-occurrents dans des investigations antérieures, et gestion de la rétention/export local |
| 🛡️ Sécurité | Blocage des redirections, liste blanche d'hôtes, masquage des clés API dans les journaux, neutralisation des formules de tableur, limites DoS pour CSV/journaux |
| 🔒 Fichier de verrouillage | requirements.lock avec hachages SHA-256 pour des installations reproductibles |
| 💻 Expérience CLI | Barres de progression Rich, tableaux colorés et un résumé de verdict clair |
| 🧩 Architecture | Enrichisseurs/analyseurs/exportateurs modulaires, modèles typés, séparation stricte des responsabilités |
| ✅ Testé | 192 tests unitaires et d'intégration avec pytest ; CI via GitHub Actions |
| ⚡ Résilient | Une API ou une destination SIEM défaillante ne bloque jamais les autres — les erreurs sont isolées et journalisées |
# 1. Clone & install
git clone https://github.com/AbdaullahAG/threatlens.git
cd threatlens
pip install -r requirements.txt
# 2. Configure your API keys
cp config/keys.env.example config/keys.env
# → edit config/keys.env and fill in your keys
# 3. Run your first scan
python main.py -i 45.33.32.156
💡 NVD (recherches de CVE) fonctionne immédiatement sans clé API. Toutes les autres API proposent un niveau gratuit dont l'inscription prend moins de 2 minutes — voir Clés API ci-dessous.
pip install --require-hashes -r requirements.lock
| Recherche simple d'un seul IOC |
| Combiner et associer les types d'IOC en une seule exécution |
| Enquête en masse directement à partir de journaux bruts |
| Sortie lisible par machine pour les pipelines |
| Limiter l'enrichissement aux sources sélectionnées |
| Excel + JSON + CSV en une seule exécution |
| Enrichissement CVE via NIST NVD (gratuit, sans clé) |
| Journalisation complète des requêtes/réponses pour le dépannage |
|