
محلل سجلات وأحداث أندرويد وبروتوبوف

إذا كنت ترغب في المساهمة تواصل معي هنا: https://abrignoni.github.io
منشورات المدونة هنا: https://leapps.org/blog
لا تحتاج الإصدارات الجاهزة إلى تثبيت Python: إصدارات ALEAPP على GitHub، أو إصدارات LEAPPs لعائلة LEAPP بأكملها.
| المنصة | التنزيل |
|---|---|
| Windows (Intel/AMD) | ALEAPP-*-windows-x64-portable.zip |
| Windows (ARM) | ALEAPP-*-windows-arm64-portable.zip |
| macOS (Apple Silicon) | ALEAPP-*-macos-arm64.dmg |
| macOS (Intel) | ALEAPP-*-macos-x64.dmg |
| Linux (Intel/AMD) | ALEAPP-*-linux-x64.AppImage |
| Linux (ARM) | ALEAPP-*-linux-arm64.AppImage |
| Debian, Ubuntu (Intel/AMD, ARM) | ALEAPP-*-linux-x64.deb, ALEAPP-*-linux-arm64.deb |
| Fedora and other RPM-based Linux (Intel/AMD, ARM) | ALEAPP-*-linux-x64.rpm, ALEAPP-*-linux-arm64.rpm |
كل تنزيل يحتوي على برنامج واحد، aleapp. يتيح لك ملف SHA256SUMS.txt في كل إصدار التحقق من التنزيل.
تحتوي حزمتا .deb و.rpm على البناء نفسه الموجود في AppImage وتضعان aleapp على المسار PATH،
مع إدخال في القائمة. ثبّت إحداهما باستخدام مدير الحزم لديك، من المجلد الذي نزّلتها إليه:
sudo apt install ./ALEAPP-<version>-linux-x64.deb
sudo dnf install ./ALEAPP-<version>-linux-x64.rpm
واجهة المستخدم الرسومية (GUI): افتح ALEAPP بالطريقة المعتادة: بالنقر المزدوج على aleapp.exe من ملف zip على
Windows، أو ALEAPP في Applications على macOS، أو AppImage على Linux. عند تشغيله بدون
وسائط، فإنه يفتح النافذة.
واجهة سطر الأوامر (CLI): مرّر وسائط إلى aleapp في الطرفية وسيعمل كسطر أوامر بدلاً من ذلك. يجب أن يكون
مجلد الإخراج موجودًا مسبقًا. على Windows، استخدم aleapp.exe من ملف zip.
aleapp.exe -t zip -i C:\path\to\extraction.zip -o C:\path\to\output\
على Linux، شغّل AppImage بالوسائط نفسها، أو aleapp نفسه بعد تثبيت حزمة .deb أو .rpm. على macOS يوجد داخل التطبيق؛ لكي تكتب aleapp فقط في الطرفية، اربطه بمسار PATH لديك مرة واحدة:
sudo ln -s /Applications/ALEAPP.app/Contents/MacOS/aleapp /usr/local/bin/aleapp
Python 3.11 أو أحدث
التبعيات الخاصة ببيئة Python لديك مدرجة في requirements.txt. قم بتثبيتها باستخدام الأمر أدناه. تأكد من أن
جزء py صحيح لبيئتك، مثل py أو python أو python3، إلخ.
py -m pip install -r requirements.txt
أو
pip3 install -r requirements.txt
للحصول على سلسلة تبعيات mister_skinnylegs الدقيقة التي تُبنى بها الإصدارات، استخدم هذا
بدلاً من ذلك. فهو يثبّت requirements.txt بدون سطر mister_skinnylegs، ثم
requirements-msl-lock.txt بدون التبعيات، ويتوقف إذا كان Brotli أقدم من 1.2.1.
كما أنه يعمل في يوم لا يتمكن فيه أحد الفروع الافتراضية لأحد قارئات ccl من التثبيت:
python3 admin/scripts/install_requirements.py
للتشغيل على Linux، ستحتاج أيضًا إلى تثبيت tkinter بشكل منفصل كما يلي:
sudo apt-get install python3-tk
يقوم packaging/build.py ببناء aleapp باستخدام PyInstaller للجهاز الذي يعمل عليه، من
نفس البيئة الافتراضية. فهو يثبّت أدوات البناء المثبّتة، ثم requirements.txt و
requirements-msl-lock.txt باستخدام admin/scripts/install_requirements.py، أولاً.
python packaging/build.py exe # dist/ALEAPP/, and dist/ALEAPP.app on macOS
python packaging/build.py smoke # run what it built, without opening a window
python packaging/build.py installer # Windows: Inno Setup installer; macOS: .dmg; Linux: AppImage
python packaging/build.py linux-packages # Linux: .deb and .rpm around dist/ALEAPP/ (dpkg-deb, rpmbuild)
exe --onefile يجعل dist/aleapp (dist\aleapp.exe على Windows) ملفًا واحدًا
بدلاً من ذلك. يحتاج مثبّت Windows إلى Inno Setup؛ على
Linux، يحتاج smoke إلى شاشة عرض، والتي يوفرها xvfb-run. يحتوي python packaging/build.py --help
على الباقي.
$ python aleapp.py -t <zip | tar | fs | gz | raw> -i <path_to_extraction> -o <path_for_report_output>
raw يقرأ صورة قرص (.img، .dd، .bin، أو أي مقطع مرقّم .001 من مجموعة مقسّمة)، أو عملية استحواذ والمقاطع أو الملفات المجاورة لها (EnCase/EWF .E01، SMART .s01، EWF2 .Ex01، AFF .aff، AFM .afm، أي .aff في مجلد AFD، AFF4 .aff4، ملف Apple .dmg، مع أي ملفات .dmgpart مجاورة له، .sparseimage أو مجلد .sparsebundle، أو قرص جهاز ظاهري، .vhd، .vhdx، .vmdk أو .qcow2)، في مكانها: دون تركيب ودون صلاحيات مسؤول. يتم البحث مباشرة في وحدات تخزين NTFS وFAT32 وFAT16 وFAT12 وexFAT وext2/3/4 وF2FS وHFS+ وAPFS وQNX6 وQNX4 وETFS وEFS وSquashFS وJFFS2 وUBI/UBIFS وYAFFS وQNX IFS الخاصة بها (ويُقرأ بيئة U-Boot أو مخزن Belkin NVRM كملف واحد)، ولا تُقرأ من الصورة إلا الملفات التي يطلبها أثر معيّن. تُقرأ الأدلة المنطقية، ملف EnCase .L01 أو ملف FTK Imager .ad1، كالملفات التي تحتويها. تختار واجهة المستخدم الرسومية raw من تلقاء نفسها لتلك الامتدادات، ولـ sparse bundle أو مجلد AFD المختار بزر المجلد. راجع admin/docs/raw_image_input.md.
تُفتح الصورة المشفّرة بكلمة مرورها (--image_password_file أو --image_password_env)، أو، عندما تكون مختومة بشهادة، بالمفتاح الخاص RSA لتلك الشهادة (--image_private_key). تُفتح وحدة تخزين BitLocker في صورة بكلمة مرورها أو كلمة مرور الاسترداد، مُعطاة بالطريقة نفسها، أو بمفتاح بدء التشغيل (--bitlocker_key، قابل للتكرار)، ووحدة تخزين APFS التي شفّرها macOS برمجيًا بكلمة مرورها أو مفتاح الاسترداد الشخصي، وحاوية LUKS بعبارة المرور الخاصة بها، كلٌّ منها مُعطى بالطريقة نفسها. في الطرفية يُطلب أي شيء ناقص، وتطلب واجهة المستخدم الرسومية في مربعات حوار؛ ويُبلَّغ عن وحدة تخزين BitLocker أو APFS أو LUKS لا يفتحها شيء ولا يُبحث فيها.
تُقرأ صور الأقراص لمجموعة RAID برمجية في Linux (md، أو LVM2 عبر الأقراص) معًا: أعطها كلها إلى -i مع -t raw، أو اخترها معًا في مربع حوار الملفات في واجهة المستخدم الرسومية. عند إعطاء صورة واحدة تحتوي على عضو، يُبحث عن الأعضاء الآخرين في مجلدها بما يسجّله كل ملف عن نفسه، لا باسمه؛ تسرد سطر الأوامر ما وجده وما استبعده ولماذا قبل قراءة المجموعة (--no-find-members يقرأ الصورة المعطاة فقط)، وتسأل واجهة المستخدم الرسومية قبل قراءة الملفات التي وجدتها. يسمّي التقرير كل صورة قُرئت ويعلّم تلك التي وُجدت تلقائيًا. تُقرأ الصورة الواحدة التي تحتوي على عضو md مع مصفوفاتها أيضًا: عضو RAID1 منفرد ببيانات وصفية 1.1 أو 1.2 يقرأ الآن نظام ملفاته عبر المصفوفة، وتكتسب أسماء وحدات تخزينه اسم الصورة أو المصفوفة في المقدمة. القرص المعطى مرتين يُقرأ مرة واحدة. تُقرأ الصورة التي لا توجد فيها بيانات وصفية RAID كما كان من قبل؛ راجع admin/docs/raw_image_input.md لمعرفة ما يفعله qnxprobe 1.71 مع صور أعضاء DDF وIMSM وmd المقروءة منفردة.
يقرأ tar أيضًا أرشيف tar مضغوطًا بـ xz (.tar.xz)، وتختار واجهة المستخدم الرسومية tar لذلك الامتداد. يُفكّ ضغط أرشيف tar المضغوط، بما في ذلك .tar.gz، مرة واحدة إلى مجلد التقرير قبل قراءة أي ملف، لذا يحتاج التشغيل إلى مساحة خالية هناك للأرشيف tar غير المضغوط. تُحذف النسخة عند انتهاء التشغيل، ويذكر سجل التشغيل المدة التي استغرقتها الخطوة.
$ python aleappGUI.py
$ python aleapp.py --help
توجد وحدات الإضافات (artifact modules) في scripts/artifacts/ ويتم تحميلها في كل مرة يتم فيها تشغيل ALEAPP.
الوحدات الجديدة: ابدأ بـ How to Write an iLEAPP Module. فهو يستخدم iLEAPP كمرجع له، وتستخدم وحدات ALEAPP نفس كتلة __artifacts_v2__ ونفس الديكوريتور @artifact_processor. الدوال المساعدة ليست متطابقة بين الأدوات، لذا تحقق من وجود الدالة في scripts/ilapfuncs.py الخاص بـ ALEAPP قبل استيرادها.
الدوال المساعدة التي تستدعيها الوحدة للعثور على الملفات، وقراءة SQLite، والتحقق من الوسائط، وتحويل الطوابع الزمنية موصوفة في Helper Functions for Artifact Modules.