
안드로이드 로그 이벤트 및 Protobuf 파서

기여하고 싶다면 여기에서 연락해 주세요: https://abrignoni.github.io
블로그 글은 여기에서: https://leapps.org/blog
미리 빌드된 릴리스는 Python 설치가 필요하지 않습니다: ALEAPP GitHub Releases, 또는 LEAPP 제품군 전체를 원한다면 LEAPPs Releases를 이용하세요.
| 플랫폼 | 다운로드 |
|---|---|
| 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 및 기타 RPM 기반 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을 엽니다. Windows에서는 zip 파일에서 aleapp.exe를 더블클릭하고, macOS에서는 Applications에 있는 ALEAPP을, Linux에서는 AppImage를 실행합니다. 인수 없이 시작하면 창이 열립니다.
CLI: 터미널에서 aleapp에 인수를 전달하면 대신 명령줄로 실행됩니다. 출력 폴더는 이미 존재해야 합니다. Windows에서는 zip 파일에서 aleapp.exe를 사용하십시오.
aleapp.exe -t zip -i C:\path\to\extraction.zip -o C:\path\to\output\
Linux에서는 동일한 인수로 AppImage를 실행하거나, .deb 또는 .rpm이 설치된 후에는 aleapp 자체를 실행하십시오. 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 종속성 체인을 사용하려면 대신 다음을 사용하십시오. 이 명령은 mister_skinnylegs 줄을 제외한 requirements.txt를 설치한 다음, 종속성 없이 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는 동일한 가상 환경에서 실행되는 머신용으로 PyInstaller를 사용하여 aleapp을 빌드합니다. 먼저 고정된 빌드 도구를 설치한 다음, admin/scripts/install_requirements.py로 requirements.txt와 requirements-msl-lock.txt를 설치합니다.
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(Windows에서는 dist\aleapp.exe)을 단일 파일로 만듭니다. 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, AFD 폴더 안의 모든 .aff, 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, 반복 가능)로 열립니다. macOS가 소프트웨어로 암호화한 APFS 볼륨은 비밀번호나 개인 복구 키로, LUKS 컨테이너는 패스프레이즈로 각각 같은 방식으로 제공하여 열립니다. 터미널에서는 누락된 항목을 물어보고, GUI에서는 대화상자로 물어봅니다. 아무것도 열지 못한 BitLocker, APFS, LUKS 볼륨은 보고되며 검색되지 않습니다.
Linux 소프트웨어 RAID 세트(md, 또는 여러 디스크에 걸친 LVM2)의 디스크 이미지는 함께 읽힙니다: -t raw와 함께 -i에 모두 지정하거나, GUI의 파일 대화상자에서 함께 선택하십시오. 멤버를 담고 있는 이미지 하나를 지정하면, 다른 멤버들은 파일 이름이 아니라 각 파일이 자신에 대해 기록한 정보를 바탕으로 같은 폴더에서 찾습니다. 명령줄은 세트를 읽기 전에 찾은 것과 제외한 것, 그리고 그 이유를 나열하며(--no-find-members는 주어진 이미지만 읽음), GUI는 찾은 파일을 읽기 전에 확인을 구합니다. 보고서는 읽은 모든 이미지를 명시하고 자동으로 찾은 이미지를 표시합니다. md 멤버를 담고 있는 이미지 하나는 해당 배열과 함께 읽힙니다: 메타데이터 1.1 또는 1.2를 가진 단독 RAID1 멤버는 이제 배열을 통해 파일 시스템을 읽으며, 볼륨 이름 앞에 이미지나 배열의 이름이 붙습니다. 두 번 지정된 디스크는 한 번만 읽힙니다. RAID 메타데이터가 발견되지 않은 이미지는 이전과 같이 읽힙니다. DDF, IMSM 및 단독으로 읽은 md 멤버 이미지에 대해 qnxprobe 1.71이 수행하는 작업은 admin/docs/raw_image_input.md를 참조하십시오.
tar는 xz로 압축된 tar(.tar.xz)도 읽으며, GUI는 해당 확장자에 대해 tar를 선택합니다. .tar.gz를 포함한 압축된 tar는 파일을 읽기 전에 보고서 폴더로 한 번 압축 해제되므로, 실행 시 압축 해제된 tar를 위한 여유 공간이 해당 폴더에 필요합니다. 복사본은 실행이 끝나면 삭제되며, 실행 로그에 해당 단계에 걸린 시간이 기록됩니다.
$ python aleappGUI.py
$ python aleapp.py --help
아티팩트 모듈은 scripts/artifacts/에 위치하며 ALEAPP가 실행될 때마다 로드됩니다.
새 모듈: How to Write an iLEAPP Module로 시작하세요. 이 문서는 iLEAPP를 참조로 사용하며, ALEAPP 모듈도 동일한 __artifacts_v2__ 블록과 @artifact_processor 데코레이터를 사용합니다. 도구마다 헬퍼가 동일하지 않으므로, 임포트하기 전에 ALEAPP의 scripts/ilapfuncs.py에 해당 헬퍼가 존재하는지 확인하세요.
모듈이 파일을 찾고, SQLite를 읽고, 미디어를 확인하고, 타임스탬프를 변환하기 위해 호출하는 헬퍼 함수는 Helper Functions for Artifact Modules에 설명되어 있습니다.
모듈은 두 부분으로 구성됩니다. 파일 상단의 __artifacts_v2__ 딕셔너리와, @artifact_processor로 데코레이팅된 아티팩트별 함수 하나입니다. 예를 들면 다음과 같습니다:
__artifacts_v2__ = {
"get_cool_messages": {
"name": "Cool App Messages",
"description": "Messages from the Cool App database",
"author": "@username",
"creation_date": "2026-10-14",
"last_update_date": "2026-10-14",
"requirements": "none",
"category": "Cool App",
"notes": "",
"paths": ('*/CoolApp/cool.db*',),
"output_types": "standard",
"artifact_icon": "message",
}
}
from scripts.ilapfuncs import (
artifact_processor, convert_unix_ts_to_utc, get_file_path, get_sqlite_db_records)
@artifact_processor
def get_cool_messages(context):
source_path = get_file_path(context.get_files_found(), 'cool.db')
if not source_path:
return (), [], ''
query = 'SELECT sent_at, sender, body FROM messages'
data_list = []
for row in get_sqlite_db_records(source_path, query):
data_list.append((convert_unix_ts_to_utc(row[0]), row[1], row[2]))
data_headers = (('Sent', 'datetime'), 'Sender', 'Message')
return data_headers, data_list, source_path
각 항목의 키(위의 get_cool_messages)는 데코레이트된 함수의 이름과 일치해야 합니다. 이것이 로더와 데코레이터가 서로를 찾는 방식입니다. 항목은 다음을 담습니다: