Strumento CLI Python per l'analisi rapida degli IOC (IP, Domini, CVE) tramite 6 API gratuite di Threat Intel. Output: Excel, JSON, CSV con codifica a colori. Utilizza: VT, Shodan, AbuseIPDB.
Analizza IP, domini, hash e CVE su 6 API gratuite di threat intelligence — senza dover passare da una scheda del browser all'altra.
Avvio rapido · Utilizzo · Architettura · Chiavi API · Screenshot · Contribuire
🚀 Con orgoglio presente nel repository ufficiale Awesome OSINT.
🧠 Un contributo di ThreatLens è presente nell'XERJ Corpus Hub.
ThreatLens è un unico strumento da riga di comando che unifica le ricerche di threat intelligence sulle più affidabili fonti OSINT gratuite. Invece di incollare un IP in cinque siti web diversi, ThreatLens li interroga tutti in parallelo, normalizza i risultati e ti fornisce un verdetto chiaro — nel terminale, oppure in un report Excel/JSON/CSV curato e codificato a colori.
Pensato per analisti SOC, responder agli incidenti, threat hunter e chiunque voglia un arricchimento rapido e affidabile degli IOC senza uscire dalla shell.
|
Perché ThreatLens
|
Non adatto a
|
| Funzionalità | Dettagli |
|---|---|
| 🎯 Tipi di IOC | IP, Dominio, URL, Hash di file (MD5 / SHA1 / SHA256), CVE |
| 🔌 API integrate | AbuseIPDB, VirusTotal, AlienVault OTX, Shodan, URLScan.io, NVD, CISA KEV, EPSS |
| 📄 Analisi dei log | Estrazione automatica degli IOC da file di testo/log, più supporto nativo per Zeek, Suricata eve.json, Sysmon (JSON) e JSONL generico |
| 🧭 Schede decisionali CVE | Raccomandazione deterministica e spiegabile Patch / Isola / Monitora / Non interessato per ogni CVE, basata su CISA KEV, EPSS, CVSS e sull'esposizione correlata degli asset |
| 🗂️ Inventario degli asset | Importa un CSV di host/IP con criticità e stato di esposizione a Internet; correlato con i risultati delle CVE |
| 📤 Esportazione SIEM | Esportazione opzionale verso Splunk HEC, Elastic _bulk e Microsoft Sentinel (moderna Logs Ingestion API) |
| 🧾 Pacchetti di evidenze | Esportazione ZIP di un'indagine con un manifest SHA-256 per una catena di custodia di base |
| 📊 Report | Excel (con codifica a colori), JSON, CSV |
| 💾 Cache locale | Cache SQLite con TTL configurabile — evita di interrogare nuovamente IOC già noti, più un feed CISA KEV in cache (TTL 24h) |
| 🔐 Controlli sulla privacy | Modalità standard, passiva, solo provider approvati e solo locale; i parametri di query sensibili degli URL vengono rimossi prima delle ricerche esterne |
| 👁️ Watchlist degli IOC | Watchlist locale SQLite con scadenza, scansioni manuali e tracciamento delle modifiche per verdetti e segnali di rischio |
| 🧠 Memoria delle indagini | Cerca osservazioni IOC salvate, confronta la cronologia di verdetti/fonti, trova IOC co-occorrenti in indagini precedenti e gestisci conservazione/esportazione locale |
| 🛡️ Sicurezza | Blocco dei redirect, allow-listing degli host, oscuramento delle API key nei log, neutralizzazione delle formule nei fogli di calcolo, limiti DoS per CSV/log |
| 🔒 Lockfile | requirements.lock con hash SHA-256 per installazioni riproducibili |
| 💻 Esperienza CLI | Barre di avanzamento Rich, tabelle colorate e un riepilogo dei verdetti chiaro |
| 🧩 Architettura | Enricher/parser/esportatori modulari, modelli tipizzati, rigorosa separazione delle responsabilità |
| ✅ Testato | 192 test unitari e di integrazione con pytest; CI tramite GitHub Actions |
| ⚡ Resiliente | Un'API o una destinazione SIEM che fallisce non blocca mai le altre — gli errori sono isolati e registrati |
# 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 (ricerche CVE) funziona subito senza chiave API. Ogni altra API offre un piano gratuito per cui la registrazione richiede meno di 2 minuti — vedi Chiavi API qui sotto.
pip install --require-hashes -r requirements.lock
| Ricerca di base di un singolo IOC |
| Combina e abbina i tipi di IOC in un'unica esecuzione |
| Indaga in blocco direttamente dai log grezzi |
| Output leggibile dalle macchine per le pipeline |
| Limita l'arricchimento alle fonti selezionate |
| Excel + JSON + CSV in un'unica esecuzione |
| Arricchimento CVE tramite NIST NVD (gratuito, senza chiave) |
| Registrazione completa di richiesta/risposta per la risoluzione dei problemi |
| Patch / Isola / Monitora / Raccomandazione di non interessato |
| Acquisizione log SOC → esportazione SIEM |