أداة Python CLI لتحليل مؤشرات الاختراق (IOC) بسرعة (عناوين IP، النطاقات، ثغرات CVE) باستخدام 6 واجهات برمجة تطبيقات مجانية للاستخبارات حول التهديدات. المخرجات: ملفات Excel وJSON وCSV ملوّنة. تستخدم: VT وShodan وAbuseIPDB.
حقّق في عناوين IP والنطاقات والتجزئات وثغرات CVE عبر 6 واجهات برمجية مجانية لاستخبارات التهديدات — دون التنقل بين علامات تبويب المتصفح.
البدء السريع · الاستخدام · البنية · مفاتيح API · لقطات الشاشة · المساهمة
🚀 مذكور بفخر في مستودع Awesome OSINT الرسمي.
🧠 إحدى مساهمات ThreatLens مذكورة في XERJ Corpus Hub.
ThreatLens أداة سطر أوامر واحدة توحّد عمليات البحث في استخبارات التهديدات عبر أكثر مصادر OSINT المجانية موثوقية. فبدلاً من لصق عنوان IP في خمسة مواقع مختلفة، تستعلم ThreatLens عنها جميعًا بالتوازي، وتوحّد النتائج، وتمنحك حكمًا واضحًا — في الطرفية، أو في تقرير Excel/JSON/CSV منسّق ومرمّز بالألوان.
صُمّمت لمحللي SOC، والمستجيبين للحوادث، وصائدي التهديدات، وكل من يريد إثراءً سريعًا وموثوقًا لمؤشرات الاختراق (IOC) دون مغادرة الصدفة.
|
لماذا ThreatLens
|
غير مخصص لـ
|
| الميزة | التفاصيل |
|---|---|
| 🎯 أنواع مؤشرات الاختراق (IOC) | IP، نطاق، URL، تجزئة ملف (MD5 / SHA1 / SHA256)، CVE |
| 🔌 واجهات API المدمجة | AbuseIPDB، VirusTotal، AlienVault OTX، Shodan، URLScan.io، NVD، CISA KEV، EPSS |
| 📄 تحليل السجلات | استخراج تلقائي لمؤشرات الاختراق من النصوص العادية/ملفات السجلات، بالإضافة إلى دعم أصلي لـ Zeek، Suricata eve.json، Sysmon (JSON)، وJSONL العام |
| 🧭 بطاقات قرار CVE | توصية حتمية وقابلة للتفسير Patch / Isolate / Monitor / Not affected لكل CVE، مدفوعة بـ CISA KEV وEPSS وCVSS وتعرض الأصول المرتبط |
| 🗂️ جرد الأصول | استيراد ملف CSV للأجهزة/عناوين IP مع درجة الأهمية وحالة التعرض للإنترنت؛ مرتبط بنتائج CVE |
| 📤 تصدير SIEM | تصدير اختياري إلى Splunk HEC، Elastic _bulk، وMicrosoft Sentinel (واجهة Logs Ingestion API الحديثة) |
| 🧾 حزم الأدلة | تصدير ZIP لتحقيق مع بيان SHA-256 لسلسلة الحفظ الأساسية |
| 📊 التقارير | Excel (مرمّز بالألوان)، JSON، CSV |
| 💾 التخزين المؤقت المحلي | ذاكرة تخزين مؤقت SQLite مع TTL قابل للتكوين — تخطي إعادة الاستعلام عن مؤشرات الاختراق المعروفة، بالإضافة إلى تغذية CISA KEV المخزنة مؤقتًا (TTL 24 ساعة) |
| 🔐 ضوابط الخصوصية | أوضاع قياسية وسلبية ومعتمدة على المزودين المعتمدين فقط ومحلية فقط؛ تُزال معاملات استعلام URL الحساسة قبل الاستعلامات الخارجية |
| 👁️ قائمة مراقبة مؤشرات الاختراق | قائمة مراقبة محلية SQLite مع انتهاء الصلاحية والفحوصات اليدوية وتتبع التغييرات للحكم وإشارات المخاطر |
| 🧠 ذاكرة التحقيق | البحث في ملاحظات مؤشرات الاختراق المحفوظة، ومقارنة سجل الحكم/المصدر، والعثور على مؤشرات اختراق تظهر معًا في تحقيقات سابقة، وإدارة الاحتفاظ المحلي/التصدير |
| 🛡️ الأمان | حظر إعادة التوجيه، والقائمة المسموح بها للمضيفين، وتنقيح مفاتيح API في السجلات، وتحويل صيغ جداول البيانات إلى صيغة محايدة، وحدود DoS للسجلات/CSV |
| 🔒 ملف القفل | requirements.lock مع تجزئات SHA-256 لعمليات تثبيت قابلة للتكرار |
| 💻 تجربة CLI | أشرطة تقدم غنية، وجداول ملونة، وملخص حكم واضح |
| 🧩 البنية | مُثريات/محللات/مُصدِّرات معيارية، ونماذج مُصنَّفة، وفصل صارم للمسؤوليات |
| ✅ مُختبَر | 192 اختبار وحدة وتكامل باستخدام pytest؛ التكامل المستمر عبر GitHub Actions |
| ⚡ مرن | فشل واجهة API واحدة أو وجهة SIEM واحدة لا يعيق البقية أبدًا — تُعزل الأخطاء وتُسجَّل |
# 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 (عمليات البحث عن CVE) بشكل جاهز دون الحاجة إلى مفتاح API. كل واجهة API أخرى توفّر خطة مجانية لا يستغرق التسجيل فيها أكثر من دقيقتين — راجع مفاتيح API أدناه.
pip install --require-hashes -r requirements.lock
| بحث أساسي عن مؤشر اختراق واحد |
| مزج ومطابقة أنواع IOC في تشغيل واحد |
| تحقّق بشكل جماعي مباشرةً من السجلات الخام |
| مخرجات قابلة للقراءة آليًا لخطوط الأنابيب |
| تقييد الإثراء بمصادر محددة |
| Excel + JSON + CSV في تشغيل واحد |
| إثراء CVE عبر NIST NVD (مجاني، بدون مفتاح) |
| تسجيل كامل للطلبات والاستجابات لأغراض استكشاف الأخطاء وإصلاحها |
| تطبيق الترقيع / العزل / المراقبة / توصية "غير متأثر" |
| استقبال سجلات SOC → تصدير إلى SIEM |
| ملف ZIP مع بيان SHA-256 لسلسلة الحفظ |