مجموعة أدوات أمنية خلوية GTK4 وCLI تضم 57 وحدة لواجهة الهواء لشبكات 2G GSM و3G UMTS و4G LTE و5G NR، والشبكة الأساسية، وهوية SIM، والتتبع الترددي، وتحليل الهجمات.
مجموعة أدوات أمنية خلوية GTK4 لنظام Linux، مع واجهة سطر أوامر كاملة خلفها. وحدات shell تغطي 2G/GSM و3G/UMTS و4G/LTE و5G/NR، بالإضافة إلى التحليل السلبي عبر عمليات الالتقاط وأطقم CVE لكل جيل.
كل وحدة هي سكربت مستقل. واجهة المستخدم الرسومية هي عرض فوقها، وليست حاوية — لا شيء مقفل خلف الواجهة.
تطوير مبكر، وصريح بشأن ذلك. لم يتم تشغيل أي وحدة في هذه الشجرة ضد راديو حقيقي. لا يوجد SDR على الجهاز الذي بُنيت عليه، لذا فإن كل مسار عبر الأثير مكتوب ومراجَع ولكن غير مُختبَر. يوضح قسم ما يعمل فعليًا بالضبط أيها يعمل وأيها لا، ويستحق القراءة قبل الإبلاغ عن خطأ.
أدوات الاتصالات الخلوية مقسّمة حسب الطبقة وحسب الجيل. gr-gsm هو 2G. srsRAN
هو 4G/5G. Osmocom هو المكدس الذي تحته. يقوم Wireshark بتفكيك ما
التقطته لكنه لن يلتقطه، ولا تشترك أي منها في عرض هدف موحّد.
هذه الشجرة واسعة عن قصد: مكتب واحد، مشغّل واحد، مكان واحد حيث يلتقي مسح خلية، وفك ترميز NAS، ورسالة Diameter، وتدقيق شفرات في نفس ملف TSV.
والشيء الآخر الذي تفعله بشكل مختلف: معظم الأدوات تخبرك أنها نجحت. هذه
الأداة مبنية لتخبرك عندما لم تنجح. كل وحدة لديها --selftest، والوحدات
المقيّدة بالعتاد تسمّي الراديو المفقود بدلاً من إرجاع
نتيجة فارغة، والوحدة التي لا تستطيع أداء عملها تخرج بقيمة غير صفرية بدلاً من
الإبلاغ عن النجاح.
لا توجد بوابة موافقة في أي وحدة. لا شيء يرفض لأن علمًا أو
متغير بيئة لم يُضبط أولاً. الخيارات المتقاعدة --i-have-a-lab-and-authorisation
و--ack-isolated-lab وLTE_ARMED وNR_ARMED وMAP_ARMED وFEMT_S1_ARMED
وSBA_ARMED وBEXP_TX_ARMED وNRJ_TX_ARMED وJAMD_LAB_AUTHORISED مقبولة
ومتجاهَلة، لذا تستمر سطور الأوامر القديمة في العمل. يطبع bash modules/00_deps.sh --preflight حالة الجهاز في صفحة واحدة.
ابنِ واجهة المستخدم الرسومية:
cd native
meson setup builddir
meson compile -C builddir
ثم، من جذر المشروع:
sudo ./imsisting.sh # CLI menu
./imsisting.sh --list # module list
./imsisting.sh --index # the module index as TSV
./imsisting.sh --gui # launch the GUI
./imsisting.sh --tui # launch the TUI (modules listed by their menu keys)
أو شغّل الملف التنفيذي المبني مباشرةً:
./native/builddir/imsisting-gui
الاختصارات. يتضمن المستودع أغلفة bin/ بحيث يمكنك كتابة imsisting،
imsisting-gui، imsisting-tui دون المسار الكامل. أضفها إلى PATH الخاص بك:
export PATH="$PWD/bin:$PATH" # add to ~/.bashrc or ~/.profile
imsisting --list # works from any directory
imsisting-gui # launch the GUI
imsisting-tui # launch the TUI
تطلب واجهة المستخدم الرسومية كلمة المرور الخاصة بك لكل إجراء عبر pkexec، وليس مرة واحدة عند بدء التشغيل.
المطلوبة: GTK4 (4.14+)، meson، ninja، مترجم C، python3.
# Debian / Ubuntu
sudo apt install build-essential meson ninja-build libgtk-4-dev \
python3 python3-numpy python3-scipy
# Arch
sudo pacman -S base-devel meson ninja gtk4 python python-numpy python-scipy
اختياري لكن تستخدمه وحدات معينة: gnuradio + gr-gsm، srsRAN،
Open5GS/free5GC، tshark، pcsc-tools، gpsd، python3-cryptography.
يُبلّغ 00_deps عمّا هو موجود وما هو مفقود، ويميّز بين أداة
مثبّتة وحزمة مكتملة فعليًا.
يمنحك فك التشفير هوية؛ وتمنحك الجداول المرجعية مالكًا. إنها عامة لكنها غير مرفقة، لأنها مئات الآلاف من الصفوف وتصبح قديمة — شغّل أداة الجلب مرة واحدة لكل نسخة مسحوبة:
tools/fetch-reference-data.sh # ~2 500 PLMNs, ~6 300 ISPCs, ~67 000 PENs
tools/fetch-reference-data.sh --check # what is present, without downloading
تُفرّق عمليات البحث بين ثلاث حالات، ولا يدمجها صندوق الأدوات أبدًا: ok (المشغّل)، وabsent (تمت قراءة السجل ولا يحتوي على مثل هذا الصف — وهذا هو الاكتشاف)، وsilent (الجدول غير موجود على هذا الجهاز — الإجابة غير مرصودة، وليست سلبية). يُبلّغ 02_cell_recon --status-tsv عن السجل تحت plmn_register؛ ويطبع 26_ss7_map --ispc قيمة owner_state عند كل بحث.
data/opops/ هو النصف الخاص: جداول يوفّرها المشغّل بادئات العناوين العالمية، وكتل هوية الخلايا، ونطاقات عناوين النواة، وهويات SMSC. تُشحن الشجرة مع المُحمّل والمخطط، ولا تُشحن المحتويات أبدًا، وتُبلّغ عن ملف مفقود بوصفه silent بدلًا من إجابة فارغة.
تفتح واجهة المستخدم الرسومية على لوحة المعلومات — كل وحدة كبطاقة، مجمّعة حسب الفئة. انقر على بطاقة لتفتح الوحدة كتبويب خاص بها. ستة تبويبات دائمة:
| التبويب | ما هو |
|---|---|
| لوحة المعلومات | كل وحدة كبطاقة، مجمّعة حسب الفئة. القائمة الرئيسية. |
| حركة المرور المباشرة | عرض GSMTAP مباشر (أدناه). يبدأ الاستماع عند فتحه. |
| سجل القضايا | القضايا، والخلايا المحددة، والأدلة/الالتقاطات، والخط الزمني، وتنبيهات IDS، وعُقد الاستشعار السلبية، وتقارير HTML/JSON/TSV. تحتفظ صفحة الأدلة بمتصفح الغنائم ومعاينتها لكل وحدة. |
| الخريطة | خريطة دائمة واحدة لكل ما حدده صندوق الأدوات: الخلايا، وحلقات TA، والإطارات المحددة جغرافيًا والمناطق من loot/map/layers/*.tsv، مرسومة فوق خريطة أساس Natural Earth مرفقة. التحريك والتكبير وتبديل الطبقات. |
| الأسطول | العُقد البعيدة وما قاسه كل منها: الفئة، والنقل، والدور، والقدرات، وآخر ظهور، ومقدار تأخره عن تدفق أحداثه. افحص عقدة، واجمع نافذة تدفق، وانسخها إلى القضية، أو أرسل وحدة لتعمل هناك. |
| الإحصاءات | أعداد الوحدات والجمع، وسطر صحة، وأين تكثر الشجرة. |
| الإشعارات | ما قررت الشجرة إخبارك به، من الأقدم أولًا. |
| المساعدة | كيف تترابط الشجرة وكيف تُدار. |
| الإعدادات | حقائق البيئة، بالإضافة إلى إجراءات فحص التبعيات وSDR. |
| سير العمل | السلاسل المحفوظة، تُشغَّل من اللوحة. |
تظهر تبويبات الوحدات إلى جانب هذه ويمكن إغلاقها؛ أما التبويبات الدائمة فلا يمكن إغلاقها.
يبدّل الإعدادات ← الواجهة ← السمة المكتب بأكمله بين لوحتين: Night، لوحة الأزرق والأسود التي رُسم بها التطبيق، وEmber، المكتب نفسه بدرجة حرارة واحدة أعلى — أسطح شبه سوداء بميل دافئ ولمسة جمر واحدة.
بعد تغيير المولّد:
tools/gen-theme.py # write native/resources/theme-ember.css
tools/check-theme.sh # packaged? generated? in step with the base sheet?
cd native && ninja -C builddir
tools/check-theme.sh موجود لأن السمة التي لا تكون مُحزَّمة تفشل
بصمت: يرسم GTK الورقة الأساسية ولا تزال القائمة المنسدلة تقرأ "Ember". يؤكد
--selftest الخاص بواجهة الرسوميات الشيء نفسه (gui-theme-ember PASS packaged).
لا يلزم أن يجري المسح على الجهاز الذي أمامك. يمكن توجيه أي وحدة تقرأ الهواء إلى عقدة مسجّلة، وتجيب العقدة بما قاسته فعليًا:
modules/02_cell_recon.sh --node desk # survey through the node, store rows here
modules/03_gsmtap.sh --node desk # fetch its newest capture and decode it
modules/17_pcap_analysis.sh --node desk # list the captures that node holds
modules/18_imsi_exposure.sh --node desk # audit the node's newest capture
tools/node_source.py support # what each transport can answer
tools/node_source.py cells desk # the node's cells, in the store's table
tools/node_source.py events desk # the node's spool, as event rows
tools/node_source.py captures desk # the node's capture store
تصل عمليات الالتقاط المُجلَبة إلى captures/nodes/<name>/، لذا يعمل كل فعل موجود على مسار محلي بعد ذلك ويحتفظ المخزن بكلا الملفين.