
Парсер журналов Android, событий и Protobuf

Если вы хотите внести свой вклад, свяжитесь со мной здесь: https://abrignoni.github.io
Публикации в блоге здесь: https://leapps.org/blog
Готовые сборки не требуют установки Python: ALEAPP GitHub Releases, или LEAPPs Releases для всего семейства 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 и другие Linux-дистрибутивы на основе RPM (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, читаются как содержащиеся в них файлы. GUI выбирает
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 — своей парольной фразой, каждый задаётся
тем же способом. В терминале запрашивается всё недостающее, а GUI спрашивает в диалогах;
о томе BitLocker, APFS или LUKS, который ничем не открывается, сообщается, и он не просматривается.
Образы дисков набора программного RAID Linux (md или LVM2 на нескольких дисках) читаются
вместе: передайте их все в -i с -t raw или выберите их вместе в диалоге выбора файлов
GUI. Если задан один образ, содержащий участник, остальные участники ищутся в его
папке по тому, что каждый файл сообщает о себе, а не по его имени; командная строка перечисляет
найденное и исключённое и почему, прежде чем читать набор (--no-find-members
читает только заданный образ), а GUI спрашивает перед чтением найденных файлов. Отчёт
называет каждый прочитанный образ и помечает найденные автоматически. Один образ, содержащий
участник md, читается вместе со своими массивами: одиночный участник RAID1 с метаданными 1.1 или 1.2
теперь читает свою файловую систему через массив, а к именам его томов добавляется спереди имя образа или
массива. Один диск, заданный дважды, читается один раз. Образ, в котором не найдены
метаданные RAID, читается как прежде; см. admin/docs/raw_image_input.md о том, что
qnxprobe 1.71 делает с образами участников DDF, IMSM и md, читаемыми по отдельности.
tar также читает tar, сжатый xz (.tar.xz), и GUI выбирает tar для этого
расширения. Сжатый tar, включая .tar.gz, распаковывается один раз в папку отчёта
перед чтением любого файла, поэтому для запуска нужно свободное место там для несжатого tar. Копия
удаляется по завершении запуска, а журнал запуска сообщает, сколько времени занял этот шаг.
$ python aleappGUI.py
$ python aleapp.py --help
Модули артефактов находятся в scripts/artifacts/ и загружаются при каждом запуске ALEAPP.