
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 上从“应用程序”中打开 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 | TAR 归档,普通或 xz 压缩(.tar.xz) |
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 | 从中加载 artifact 模块的额外文件夹(例如 scripts/alternate_artifacts) | |
--html_row_limit | 行数阈值,超过该值时 artifact 的表格将不会出现在其 HTML 页面上,该页面随后会指向 LAVA 数据库和 TSV 导出文件。默认值为 50000;0 表示写入所有表格。GUI 使用默认值 | |
--itunes_password |
这些模式不解析案件。请单独使用它们——不要与 -t、-i 或 -o 一起使用:
| 参数 | 长格式 | 描述 |
|---|---|---|
-p | --artifact_paths | 将所有 artifact 搜索路径写入当前目录下的 path_list.txt |
-c | --create_profile_casedata | 交互式向导,用于在给定文件夹中创建 .ilprofile 或 .lcasedata 文件 |
示例:
ileapp -p
ileapp -c /path/to/output/folder/
Artifact 模块位于 scripts/artifacts/ 中,并在运行时动态加载。
新模块: 请从 如何编写 iLEAPP 模块 的分步指南开始。
其他参考资料:
当添加或修改 artifact 的 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,同时在 admin/test/cases/data/<module>/ 下为每个产物生成一个小型 zip 文件。
大小规则:每个 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
这会针对 fixture 运行该模块,并将输出快照写入
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__ 中,并添加你在镜像上看到的应用程序名称和版本。如果计数为零,在记录之前请检查源文件确实为空。
5. 提交所有内容并打开 PR
将模块、案例文件、fixture zip 文件和记录的快照一起提交。 更多细节请参见 admin/docs/testing/create_module_test_cases.md。
如果你的提取数据无法共享,仍然可以打开 PR 并说明情况。通常可以从公开研究镜像中截取 fixture,或者手动清理真实文件。在我们解决这个问题的过程中,审查不会停止。
发布版本是运行 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,对于通过文件夹按钮选择的 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)的磁盘镜像会被一起读取:将它们全部通过 -i 配合 -t raw 提供,或在 GUI 的文件对话框中一起选择。若只给出一个包含成员的镜像,其他成员会在其所在文件夹中根据每个文件对自身的记录来查找,而不是根据文件名;命令行会在读取集合之前列出找到的内容、遗漏的内容及原因(--no-find-members 仅读取给定的镜像),GUI 会在读取找到的文件之前询问。报告会列出读取的每个镜像,并标记自动找到的镜像。包含 md 成员的单个镜像也会连同其阵列一起读取:具有元数据 1.1 或 1.2 的孤立 RAID1 成员现在会通过阵列读取其文件系统,其卷名会在前面加上镜像或阵列的名称。同一磁盘给出两次只会读取一次。未找到 RAID 元数据的镜像按原样读取;关于 qnxprobe 1.71 如何处理单独读取的 DDF、IMSM 和 md 成员镜像,请参见 admin/docs/raw_image_input.md。
tar 还可读取 xz 压缩的 tar(.tar.xz),GUI 会针对该扩展名选择 tar。压缩的 tar(包括 .tar.gz)会在读取任何文件之前解压一次到报告文件夹中,因此运行需要在该处有足够的可用空间来存放未压缩的 tar。运行结束时该副本会被删除,运行日志会说明该步骤耗时。
GUI:
python ileappGUI.py
参见上文的 CLI 参数,或运行 python ileapp.py --help。