
يحلل استخراجات الطب الشرعي لنظامَي iOS وiPadOS إلى تقارير HTML وTSV وخط زمني وKML وLAVA، مع اكتشاف معياري للآثار الرقمية ودعم النسخ الاحتياطية المشفّرة في iTunes.

يقوم iLEAPP بتحليل عمليات الاستخراج الجنائي من iOS وiPadOS وينتج مخرجات بصيغ HTML وTSV والخط الزمني وKML وLAVA. وهو يدعم إصدارات iOS/iPadOS من 11 حتى الإصدارات الحالية.
تصفّح قائمة الأدلة الكاملة القابلة للبحث على leapps.org/artifacts (يمكنك التصفية حسب أداة LEAPP).
نزّل إصدارًا جاهزًا مُسبقًا — لا حاجة إلى تثبيت Python.
| المنصة | التنزيل |
|---|---|
| Windows (Intel/AMD) | iLEAPP-*-windows-x64-portable.zip |
| Windows (ARM) | iLEAPP-*-windows-arm64-portable.zip |
| macOS (Apple Silicon) | iLEAPP-*-macos-arm64.dmg |
| macOS (Intel) | iLEAPP-*-macos-x64.dmg |
| Linux (Intel/AMD) | iLEAPP-*-linux-x64.AppImage |
| Linux (ARM) | iLEAPP-*-linux-arm64.AppImage |
يحتوي كل تنزيل على برنامج واحد، وهو ileapp. ويتيح لك ملف SHA256SUMS.txt الموجود في كل إصدار التحقق من التنزيل.
التوافق مع Linux: بُنيت ملفات AppImage الرسمية على Ubuntu 22.04 وتحتاج إلى glibc 2.35 أو أحدث.
واجهة الرسوميات (GUI) — افتح iLEAPP بالطريقة المعتادة: بالنقر المزدوج على ileapp.exe من ملف zip على
Windows، أو iLEAPP في مجلد Applications على macOS، أو ملف AppImage على Linux. عند تشغيله دون وسائط، تفتح النافذة؛ اختر نوع الإدخال
ومسار المصدر ومجلد المخرجات والوحدات المراد معالجتها.
واجهة سطر الأوامر (CLI) — مرّر وسائط إلى ileapp في الطرفية ليعمل كسطر أوامر بدلًا من ذلك. يجب أن يكون
مجلد المخرجات موجودًا مسبقًا. على Windows، استخدم ileapp.exe من ملف zip.
ileapp.exe -t zip -i C:\path\to\extraction.zip -o C:\path\to\output\
على Linux، شغّل AppImage بالوسائط نفسها. على macOS يكون داخل التطبيق؛ لكتابة ileapp فقط في الطرفية، اربطه بمسار PATH لديك مرة واحدة:
sudo ln -s /Applications/iLEAPP.app/Contents/MacOS/ileapp /usr/local/bin/ileapp
| النوع | الوصف |
|---|---|
fs | مجلد من الملفات المستخرجة بمسارات وأسماء عادية |
zip | أرشيف ZIP يحتوي على ملفات بأسماء عادية |
tar | أرشيف TAR، عادي أو مضغوط بـ xz (.tar.xz) |
gz | أرشيف مضغوط بـ GZIP |
itunes | مجلد نسخ احتياطي iTunes/Finder بمسارات وأسماء مُجزّأة |
file | إدخال ملف واحد |
يتم دعم النسخ الاحتياطية المشفرة لـ iTunes/Finder (-t itunes). ستطلب واجهة الرسومية كلمة مرور قبل المعالجة عند اكتشاف التشفير. في واجهة سطر الأوامر، مرّر كلمة المرور باستخدام --itunes_password (انظر خيارات التحليل الاختيارية أدناه).
تنطبق هذه الخيارات فقط على واجهة سطر الأوامر (ileapp / ileapp.exe عند تمرير الوسائط، أو python ileapp.py). أما واجهة الرسومية (ileapp عند تشغيلها بدون وسائط، أو python ileappGUI.py) فتعرض الإعدادات نفسها عبر واجهتها بدلاً من أعلام سطر الأوامر.
شغّل ileapp --help (أو python ileapp.py --help من المصدر) للحصول على المرجع المدمج.
هذه الوسائط الثلاثة مطلوبة لتشغيل تحليل عادي:
| الوسيط | الصيغة الطويلة | الوصف |
|---|---|---|
-t | نوع الإدخال: fs أو tar أو zip أو gz أو itunes أو file | |
-i | --input_path | المسار إلى ملف الإدخال أو المجلد |
-o | --output_path | المسار إلى مجلد الإخراج (يجب أن يكون موجودًا مسبقًا) |
مثال:
ileapp -t zip -i /path/to/extraction.zip -o /path/to/output/
| المعامل | الصيغة الطويلة | الوصف |
|---|---|---|
-w | --wrap_text | مرّر هذا العلم لـتعطيل التفاف النص في ملفات الإخراج |
-m | --load_profile | مسار ملف تعريف iLEAPP (.ilprofile) لتقييد الوحدات التي تعمل |
-d | --load_case_data | مسار ملف بيانات حالة LEAPP (.lcasedata) |
--custom_output_folder | اسم مخصص للمجلد الفرعي لإخراج التقرير | |
--custom_artifacts_path | مجلد إضافي لتحميل وحدات القطع الأثرية منه (مثل scripts/alternate_artifacts) | |
--html_row_limit | عدد الصفوف الذي يُستبعد فوقه جدول أحد القطع الأثرية من صفحته في HTML، والتي تشير حينها إلى قاعدة بيانات LAVA وتصدير TSV بدلاً من ذلك. القيمة الافتراضية 50000؛ و0 يكتب كل الجداول. تستخدم واجهة الرسومية القيمة الافتراضية | |
--itunes_password |
لا تحلل هذه الأوضاع أي حالة. استخدمها بمفردها — دون -t أو -i أو -o:
| المعامل | الصيغة الطويلة | الوصف |
|---|---|---|
-p | --artifact_paths | كتابة جميع مسارات البحث عن القطع الأثرية إلى path_list.txt في الدليل الحالي |
-c | --create_profile_casedata | معالج تفاعلي لإنشاء ملف .ilprofile أو .lcasedata في المجلد المحدد |
أمثلة:
ileapp -p
ileapp -c /path/to/output/folder/
توجد وحدات القطع الأثرية في scripts/artifacts/ ويتم تحميلها ديناميكيًا وقت التشغيل.
الوحدات الجديدة: ابدأ بالدليل خطوة بخطوة على How to Write an iLEAPP Module.
مراجع إضافية:
يكون طلب السحب (PR) الذي يضيف قطعة أثرية أو يغيّرها أسهل في المراجعة والدمج عندما يصل
مرفقًا بشيئين: عيّنة اختبار صغيرة مقتطعة من استخراج حقيقي، وقيم sample_data التي
تسجّل ما أنتجته الوحدة. تُنشئ السكربتات كليهما. إليك سير العمل بأكمله.
قاعدة واحدة قبل أي شيء آخر: كل ما تُثبّته هنا يصبح عامًا. استخدم فقط البيانات المسموح لك بمشاركتها، مثل جهاز اختبار قمت بتعبئته بنفسك، أو صورة بحثية عامة، أو ملف قمت بتنقيته يدويًا. لا تستخدم أبدًا بيانات قضايا حقيقية.
1. اقتطع عيّنة من الاستخراج الخاص بك
python admin/test/scripts/make_test_data.py <module> --case 1 --input <extraction.zip>
هذا يستخرج الملفات التي تطابقها أنماط paths الخاصة بوحدتك من الاستخراج ويكتب
ملف الحالة admin/test/cases/testdata.<module>.json بالإضافة إلى ملف zip صغير لكل أثر
تحت admin/test/cases/data/<module>/.
قواعد الحجم: أقل من 10 ميغابايت لكل ملف zip، أرفقه مع الـ PR. بين 10 و25 ميغابايت، أرفق ملف الحالة وأرفق ملف zip بتعليق على الـ PR. أكبر من ذلك، اذكر ذلك في الـ PR وسيرتب أحد المشرفين عملية تسليم.
2. سجّل المخرجات المتوقعة
TZ=UTC python admin/test/scripts/test_module.py <module> -a all -c all
يشغّل هذا الوحدة على الـ fixture ويكتب لقطة من المخرجات تحت
admin/test/results/<module>/. أضف اللقطة إلى الـ commit أيضًا. تصبح هي خط الأساس الذي
يحمي الوحدة بعد الدمج. أبقِ على الجزء TZ=UTC: اللقطات الملتزمة بتوقيت UTC
و CI يعمل بتوقيت UTC.
3. شغّل نفس المقارنة التي سيشغّلها CI
python admin/test/scripts/run_test_cases.py --module <module>
4. توليد قيم sample_data
python admin/scripts/validate_sample_data.py --emit <extraction.zip> --key <image_name>
هذا يشغّل iLEAPP من البداية إلى النهاية على الاستخراج الخاص بك ويطبع كتل sample_data الجاهزة للصق للوحدات التي تغيّرت في فرعك. الصقها في __artifacts_v2__ الخاص بوحدتك وأضف اسم التطبيق والإصدار الذي رأيته على الصورة. إذا كان العدد صفرًا، فتحقق من أن الملف المصدر فارغ فعلًا قبل تسجيله.
5. أودِع كل شيء وافتح طلب السحب (PR)