
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 |
各ダウンロードには 1 つのプログラム 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 | 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)を実行してください。
通常の解析実行には、次の 3 つの引数が必須です。
| 引数 | 長形式 | 説明 |
|---|---|---|
-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/ に配置され、実行時に動的に読み込まれます。
新しいモジュール: まず How to Write an iLEAPP Module のステップバイステップガイドから始めてください。
その他の参考資料:
アーティファクトを追加または変更する PR は、次の 2 つを伴っているとレビューとマージが最も簡単になります。1 つは実際の抽出から切り出した小さなテストフィクスチャ、もう 1 つはモジュールが生成した内容を記録する sample_data の値です。スクリプトが両方を生成します。以下が全体の流れです。
何よりも先に 1 つのルールがあります。ここにコミットするものはすべて公開されます。自分でデータを投入したテストデバイス、公開されている研究用イメージ、手作業でサニタイズしたファイルなど、共有が許可されているデータのみを使用してください。ケースワークは決して使用しないでください。
1. 抽出からフィクスチャを切り出す
python admin/test/scripts/make_test_data.py <module> --case 1 --input <extraction.zip>
これにより、モジュールの paths パターンに一致するファイルが抽出結果から取り出され、ケースファイル admin/test/cases/testdata.<module>.json と、各アーティファクトごとに1つの小さな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__ に貼り付け、イメージ上で確認したアプリ名とバージョンを追加してください。カウントがゼロの場合は、記録する前にソースファイルが本当に空であることを確認してください。
5. すべてをコミットして PR を開く
モジュール、ケースファイル、フィクスチャの zip、記録したスナップショットをまとめてコミットしてください。詳細は admin/docs/testing/create_module_test_cases.md にあります。
抽出データを共有できない場合は、その旨を伝えた上で PR を開いてください。フィクスチャは多くの場合、公開されている調査用イメージから切り出すか、実際のファイルを手作業でサニタイズすることができます。それを解決する間もレビューは止まりません。
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/