
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을 실행하세요: Windows에서는 zip에서 ileapp.exe를 더블클릭하고,
macOS에서는 Applications의 iLEAPP을, Linux에서는 AppImage를 실행합니다. 인수 없이 시작하면 창이 열리며, 입력
유형, 소스 경로, 출력 폴더 및 처리할 모듈을 선택할 수 있습니다.
CLI — 터미널에서 ileapp에 인수를 전달하면 대신 명령줄로 실행됩니다.
출력 폴더는 미리 존재해야 합니다. Windows에서는 zip의 ileapp.exe를 사용하세요.
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 | 일반 또는 xz 압축(.tar.xz) TAR 아카이브 |
gz | GZIP 압축 아카이브 |
itunes | 해시된 경로와 이름을 가진 iTunes/Finder 백업 폴더 |
file | 단일 파일 입력 |
암호화된 iTunes/Finder 백업(-t itunes)이 지원됩니다. 암호화가 감지되면 GUI가 처리 전에 비밀번호를 요청합니다. CLI에서는 --itunes_password로 비밀번호를 전달합니다(아래 선택적 파싱 옵션 참조).
이 옵션들은 CLI(인수가 주어진 ileapp / ileapp.exe, 또는 python ileapp.py)에만 적용됩니다. GUI(인수 없이 시작된 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은 모든 테이블을 작성합니다. GUI는 기본값을 사용합니다 | |
--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/에 위치하며 런타임에 동적으로 로드됩니다.
새 모듈: iLEAPP 모듈 작성 방법의 단계별 가이드부터 시작하세요.
추가 참고 자료:
아티팩트를 추가하거나 변경하는 PR은 다음 두 가지를 함께 제출할 때 검토와 병합이 가장 쉽습니다.
실제 추출에서 잘라낸 작은 테스트 픽스처와, 모듈이 생성한 결과를 기록하는 sample_data 값입니다.
스크립트가 두 가지를 모두 생성합니다. 전체 흐름은 다음과 같습니다.
무엇보다 먼저 지켜야 할 규칙이 하나 있습니다. 여기에 커밋하는 모든 것은 공개됩니다. 직접 채운 테스트 기기, 공개된 연구용 이미지, 또는 직접 정리(sanitize)한 파일처럼 공유가 허용된 데이터만 사용하세요. 실제 사건 자료(casework)는 절대 사용하지 마세요.
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>/ 아래에 작성합니다.
크기 규칙: zip 파일당 10 MB 미만이면 PR과 함께 커밋합니다. 10~25 MB 사이면 케이스 파일을 커밋하고 zip 파일을 PR 댓글에 첨부합니다. 그보다 크면 PR에 그 사실을 알려주시면 관리자가 인계를 주선할 것입니다.
2. 예상 출력 기록
TZ=UTC python admin/test/scripts/test_module.py <module> -a all -c all
이것은 모듈을 픽스처에 대해 실행하고 출력 스냅샷을
admin/test/results/<module>/ 아래에 기록합니다. 스냅샷도 함께 커밋하세요. 이 스냅샷은
병합 후 모듈을 보호하는 기준선이 됩니다. 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__에 붙여넣고, 이미지에서 확인한 앱 이름과 버전을 추가하세요. 카운트가 0이라면, 기록하기 전에 소스 파일이 실제로 비어 있는지 확인하세요.
5. 모두 커밋하고 PR 열기
모듈, 케이스 파일, 픽스처 zip, 그리고 기록된 스냅샷을 함께 커밋하세요. 자세한 내용은 admin/docs/testing/create_module_test_cases.md에 있습니다.
추출물을 공유할 수 없다면, 그래도 PR을 열고 그 사실을 알리세요. 픽스처는 종종 공개 연구 이미지에서 잘라낼 수 있거나, 실제 파일을 수작업으로 정리(sanitize)할 수 있습니다. 이를 해결하는 동안에도 리뷰는 멈추지 않습니다.
릴리스는 iLEAPP를 실행하는 가장 쉬운 방법입니다. 모듈을 개발 중이거나 main의 미출시 변경 사항이 필요하다면 소스를 사용하세요.
git clone https://github.com/abrignoni/iLEAPP.git
cd iLEAPP
python3 -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
Linux에서는 GUI를 위해 tkinter를 설치하세요:
sudo apt-get install python3-tk
Hexordia의 Windows 설정 도움말:
실행하기 전에 출력 폴더가 존재해야 합니다. 소스 빌드는 공식 릴리스 빌드와 구별하기 위해 -dev 버전(예: 2.6.0-dev.0)을 보고합니다.
CLI:
python ileapp.py -t zip -i /path/to/extraction.zip -o /path/to/output/
python ileapp.py -t raw -i /path/to/acquisition.E01 -o /path/to/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를 선택하며, 폴더 버튼으로 선택한 스파스 번들 또는 AFD 폴더에 대해서도 마찬가지입니다. admin/docs/raw_image_input.md를 참조하십시오.