ماسح ثغرات يركز على السلامة أولاً لبروتوكولات ICS/OT.
ماسح ضوئي للثغرات الأمنية يضع السلامة أولاً بروتوكولات ICS/OT. يحدد الأجهزة ويفحصها مقابل ثغرات CVE المعروفة والإعدادات الافتراضية غير الآمنة — بشكل نشط (بفحص قائمة أهداف صريحة ومصرح بها) أو بشكل سلبي (بقراءة SPAN/TAP أو ملف pcap دون إرسال أي شيء) — ويربط النتائج بثغرات CVE، ويمكنه إصدار محتوى كشف قابل للنشر لـ Zeek وSuricata وSigma وSplunk.
الاستخدام المسؤول. يمكن لـ icsScanner إرسال فحوصات نشطة ومحاولات مصادقة إلى أنظمة صناعية حية، حيث قد تؤدي حركة المرور غير المتوقعة إلى تعطيل العمليات الفيزيائية. افحص فقط الأجهزة التي تملكها أو المصرح لك صراحةً باختبارها. الفحوصات النشطة معطلة افتراضيًا (يُبلّغ الوضع الآمن عن البصمة فقط)؛ أما الوضع السلبي (
discover sniff) فلا يرسل أي شيء وهو الخيار الصحيح على شبكات OT الحية. راجع SECURITY.md.
تمتد مجموعة الفحوصات عبر العديد من بروتوكولات ICS/OT. تستهدف معظم الفحوصات بيانات الاعتماد الافتراضية
من المصنع والإعدادات الافتراضية غير الآمنة؛ وتُبنى مرشحات ربط CVE من مصادر ثغرات منظمة — مشروع
ICS Advisory، وMyJVN الياباني، واستشارات CSAF 2.0 الخاصة بـ OT من CISA، وقاعدة بيانات الثغرات
الأوروبية ENISA. الإبلاغ بصيغة JSONL + ملخص نصي، مع تصدير HTML / CSV / SVG. راجع 04-USAGE-GUIDE.md
للدليل الكامل، أو "Running a scan" أدناه للنسخة المختصرة.
وجدت أبحاث الأعمال السابقة فجوات حقيقية في تغطية فحص ثغرات ICS/OT: عائلة إضافات SCADA في Nessus ناضجة لكنها مغلقة/تجارية؛ ومحتوى ICS في Nuclei وMetasploit ضعيف؛ ويغطي nmap NSE البصمة جيدًا لكنه يفتقر إلى فحوصات على مستوى CVE. لا أحد يمتلك طبقة فحص CVE نشطة مفتوحة وقابلة للتوسيع بفعالية وتضع السلامة أولاً لـ ICS. يسد icsScanner هذه الفجوة.
| الملف | الغرض |
|---|---|
00-PROJECT-CHARTER.md | النطاق، والقرارات، والمراحل التدريجية (0–5)، وتقدير الجهد (LOE) |
01-METHODOLOGY-AND-CHECKLISTS.md | منهجية تطوير الفحص النشط الآمن + بوابة "هل هذا فحص آمن؟" |
02-DISCLOSURE-PLAYBOOK.md | عقد disclosure_status لاستهلاك النتائج الواردة من المصادر الأولية بأمان |
03-STYLE-AND-DECISIONS.md | الهوية، والتسمية، وقرار النشر الخاص مؤقتًا |
04-USAGE-GUIDE.md | الدليل الكامل: واجهة سطر الأوامر + واجهة الويب، وصيغ جرد الأهداف/سياسة الفحص، ونموذج السلامة، ومرجع API، واستكشاف الأخطاء وإصلاحها |
lab-notes/gap-survey-and-prior-art.md | مسح الأعمال السابقة بتاريخ 2026-08-12 (Nessus، Nuclei، Metasploit، nmap NSE، geeknik/scada-scanner، ICS Advisory Project) |
lab-notes/check-inventory.md | ربط النتائج الخاصة (كلا المشروعين الشقيقين) بالفحوصات المخطط لها، مع حالة الإفصاح |
lab-notes/default-credentials-sweep.md | سجل مرحلي لعملية مسح بيانات الاعتماد الافتراضية — قصة أصل معظم الفحوصات الـ 98 |
core/ | المحرك — السجل، وتحميل الأهداف/السياسات، وطبقة السلامة/تحديد المعدل، والتسجيل، والإبلاغ |
core/passive.py / core/detect_match.py / core/detections.py | الوضع السلبي بلا إرسال — الالتقاط/التشريح/الجرد، ومطابقة الكشف الأصلية، وقسم تقرير النشاط المرصود |
checks/ | محتوى سجل الفحوصات، منظمًا حسب البروتوكول؛ ويحتوي checks/candidates/ على هياكل مرحلة البحث، غير قابلة للتنفيذ أبدًا |
detection-gen/ | يولّد عمليات كشف قابلة للنشر (توقيع Sigma / Splunk-ESCU / Suricata / Zeek + سياسة ATT&CK-for-ICS) من نفس detection_hints في checks/ |
icsscanner.py | مشغّل واجهة سطر الأوامر — scan النشط وdiscover sniff السلبي؛ راجع أعلاه |
icsscanner-web.py / web/ | واجهة الويب — لوحة تحكم محلية فوق نفس المحرك |
templates/ | ملفات YAML نموذجية لجرد الأهداف وسياسة الفحص |
lab-notes/passive-mode.md | بنية الوضع السلبي + متطلبات نظام TSA (التحجيم من مجموعة بيانات PNNL OT-IDS) |
ثلاث طرق لتشغيله، مصنّفة حسب مقدار تعاملها مع الشبكة. اختر حسب ما تسمح به بيئة الهدف — وضع الإرسال هو التمييز الحرج من ناحية السلامة:
| الوضع | هل يُرسل؟ | استخدمه عندما | الأوامر |
|---|---|---|---|
| سلبي | لا — استقبال فقط، صفر حزم (discover sniff) | بيئة OT حيّة حيث يُحظر الفحص النشط (السلامة، الأجهزة القديمة الهشّة، ضبط التغييرات) | discover sniff (SPAN/TAP/pcap/Zeek-logs)؛ discover passive (ARP-listen + Sparkplug — انظر التحذير أدناه) |
| فحص نشط | نعم — يرسل مجسّات، وعمليات تسجيل دخول اختيارية | الأصول التي تملكها أو لديك إذن كتابي صريح باختبارها | scan (CLI الافتراضي / ملف السياسة / واجهة الويب)؛ discover active (مسح ARP لاكتشاف المضيفين أولاً) |
| التشغيل البيني مع Malcolm | استدعاءات API للقراءة فقط إلى Malcolm الخاص بك | إذا كنت تشغّل بالفعل حزمة Malcolm / Hedgehog السلبية | discover malcolm (قراءة الجرد + الربط؛ --push يعيد إرسال النتائج)؛ discover sniff --push-malcolm (إرسال نتائج تشغيل سلبي) |
كل وضع مفصّل أدناه. scan وdiscover sniff هما الأمران الأساسيان؛ discover active /
discover passive هما مساعدان ثانويان للاكتشاف ضمن الوضعين النشط / السلبي. الوضع الآمن
(بصمة فقط، دون فحوص مدمّرة) هو الافتراضي في كل وضع يمكنه الإرسال.
التفاصيل الكاملة في 04-USAGE-GUIDE.md. النسخة المختصرة — ثلاث طرق للدخول، جميعها تشغّل المحرك نفسه:
# Ad hoc CLI: just point at a target inventory, optionally narrow by protocol/check-id.
python3 icsscanner.py --inventory templates/target-inventory.example.yaml --protocol http
# Policy-file CLI: bundles target inventory + check selection + rate profile + output dir into
# one reusable YAML (00-PROJECT-CHARTER.md § Scope — the decided invocation model). CLI flags
# below still override individual policy fields for a one-off tweak.
python3 icsscanner.py --policy templates/scan-policy.example.yaml
# Web UI: a form + run view at http://127.0.0.1:8807/ — same policy/inventory model, same
# safe-mode default, a two-step confirm click in place of the CLI's interactive prompt.
python3 icsscanner-web.py
انسخ templates/target-inventory.example.yaml (واختياريًا templates/scan-policy.example.yaml)
قبل التعديل — لا تفحص مباشرة من القالب. أدرج فقط الأجهزة التي تملكها أو لديك
إذن كتابي صريح باختبارها. كل هدف هو host: واحد محدد — عنوان IP أو FQDN، وليس أبدًا نطاق
CIDR؛ هذا قرار نطاق متعمد (قوائم أصول صغيرة معروفة، وليس أداة مسح شبكة)، وليس ميزة مفقودة — راجع 04-USAGE-GUIDE.md.
كل فحص يقوم بفعل حقيقي (محاولة تسجيل دخول فعلية، إلخ) هو destructive: true.
الوضع الآمن هو الافتراضي — الفحوصات المدمّرة تكتفي بالإبلاغ عن البصمة ولا تُنفَّذ أبدًا ما لم
تمرر --include-destructive (أو تضبط include_destructive: true في ملف سياسة)، وحتى
عندها يتطلب icsscanner.py إدخال y صريحًا عند مطالبة تأكيد تفاعلية (أو --yes/
-y لتخطيها) قبل حدوث أي شيء فعلي. تفرض واجهة الويب الشيء نفسه كضغطة ثانية صريحة على "Confirm and Run" بدلًا من
مطالبة طرفية — فالإرسال الأول يعرض فقط ما سيتم تشغيله. كما أن واجهة الويب لا تملك
مصادقة وترتبط بـ 127.0.0.1 (محلي فقط) افتراضيًا لهذا السبب — راجع
04-USAGE-GUIDE.md قبل كشفها على نطاق أوسع.
يسرد python3 icsscanner.py --help كل الخيارات. تصل النتائج إلى دليل --output (الافتراضي
./output، وهو مستبعد من git بالفعل) كملف icsscanner-*.jsonl بطابع زمني بالإضافة إلى ملخص نصي مطبوع.
بالنسبة لشبكات OT الحية حيث يُحظر الفحص النشط (لأسباب تتعلق بالسلامة، أو الأجهزة القديمة الهشة، أو
ضبط التغييرات)، يقرأ discover sniff حركة المرور ولا يرسل شيئًا — فمقبس الالتقاط للاستقبال فقط.
يفكك إطارات هوية ICS إلى جرد أصول، ويربط ثغرات CVE، و(مع --detections)
يطابق توقيعات مجموعة الفحوصات نفسها مع حركة المرور لإنتاج قسم النشاط المرصود.
وقد طلبت ذلك إدارة أمن النقل (TSA) لقطاعاتها الخاضعة للتنظيم (خطوط الأنابيب، السكك الحديدية، الطيران).
# Offline: dissect a capture file (no network, no transmit)
python3 icsscanner.py discover sniff --pcap plant-span.pcap --cve --detections --html
# Live: read a SPAN/mirror port or TAP for 300s (RX-only, promiscuous, zero packets sent)
sudo python3 icsscanner.py discover sniff --span eth1 --window 300 --cve --detections --csv