
Verarbeitet forensische Extraktionen von iOS und iPadOS zu HTML-, TSV-, Timeline-, KML- und LAVA-Berichten mit modularer Artefakt-Erkennung und Unterstützung verschlüsselter iTunes-Backups.
 # iOS Logs, Events, And Plists Parser iLEAPP parst forensische iOS- und iPadOS-Extraktionen und erzeugt HTML-, TSV-, Timeline-, KML- und LAVA-Ausgaben. Es unterstützt iOS/iPadOS 11 bis zu den aktuellen Versionen. Durchsuchen Sie die vollständige, durchsuchbare Artifact-Liste unter [leapps.org/artifacts](https://leapps.org/artifacts) (filtern Sie nach dem LEAPP-Tool). ## Schnellstart (empfohlen) Laden Sie ein vorgefertigtes Release herunter — keine Python-Installation erforderlich. - [LEAPPs Releases](https://leapps.org/releases) — alle Tools der LEAPP-Familie durchsuchen - [iLEAPP GitHub Releases](https://github.com/abrignoni/iLEAPP/releases) — direkte Downloads | Plattform | Download | | -------- | -------- | | 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` | Jeder Download enthält ein Programm, `ileapp`. Mit `SHA256SUMS.txt` in jedem Release können Sie einen Download überprüfen. **Linux-Kompatibilität:** Die offiziellen AppImages werden auf Ubuntu 22.04 gebaut und benötigen glibc 2.35 oder neuer. **GUI** — öffnen Sie iLEAPP wie gewohnt: durch Doppelklick auf `ileapp.exe` aus dem Zip unter Windows, auf iLEAPP in Programme unter macOS oder auf das AppImage unter Linux. Ohne Argumente gestartet, öffnet es das Fenster; wählen Sie Ihren Eingabetyp, Quellpfad, Ausgabeordner und die zu verarbeitenden Module aus. **CLI** — übergeben Sie `ileapp` Argumente in einem Terminal, und es läuft stattdessen als Kommandozeile. Der Ausgabeordner muss bereits existieren. Verwenden Sie unter Windows `ileapp.exe` aus dem Zip. ``` ileapp.exe -t zip -i C:\path\to\extraction.zip -o C:\path\to\output\ ``` Unter Linux führen Sie das AppImage mit denselben Argumenten aus. Unter macOS befindet es sich in der App; um in einem Terminal einfach `ileapp` einzugeben, verlinken Sie es einmalig in Ihren PATH: ``` sudo ln -s /Applications/iLEAPP.app/Contents/MacOS/ileapp /usr/local/bin/ileapp ``` ## Eingabetypen | Typ | Beschreibung | | ---- | ----------- | | `fs` | Ordner mit extrahierten Dateien mit normalen Pfaden und Namen | | `zip` | ZIP-Archiv mit Dateien mit normalen Namen | | `tar` | TAR-Archiv, unkomprimiert oder xz-komprimiert (`.tar.xz`) | | `gz` | GZIP-komprimiertes Archiv | | `itunes` | iTunes/Finder-Backup-Ordner mit gehashten Pfaden und Namen | | `file` | Eingabe einer einzelnen Datei | Verschlüsselte iTunes/Finder-Backups (`-t itunes`) werden unterstützt. Die GUI fordert vor der Verarbeitung zur Eingabe eines Passworts auf, wenn eine Verschlüsselung erkannt wird. Auf der CLI übergeben Sie das Passwort mit `--itunes_password` (siehe [Optionale Parsing-Optionen](#optional-parsing-options) unten). ## CLI-Argumente Diese Optionen gelten nur für die **CLI** (`ileapp` / `ileapp.exe` mit Argumenten oder `python ileapp.py`). Die GUI (`ileapp` ohne Argumente gestartet oder `python ileappGUI.py`) stellt dieselben Einstellungen stattdessen über ihre Oberfläche bereit, nicht über Kommandozeilen-Flags. Führen Sie `ileapp --help` (oder `python ileapp.py --help` aus dem Quellcode) aus, um die integrierte Referenz anzuzeigen. ### Parsen eines Falls Diese drei Argumente sind für einen normalen Parse-Lauf erforderlich: | Argument | Langform | Beschreibung | | -------- | --------- | ----------- | | `-t` | | Eingabetyp: `fs`, `tar`, `zip`, `gz`, `itunes` oder `file` | | `-i` | `--input_path` | Pfad zur Eingabedatei oder zum Eingabeordner | | `-o` | `--output_path` | Pfad zum Ausgabeordner (**muss bereits existieren**) | **Beispiel:** ``` ileapp -t zip -i /path/to/extraction.zip -o /path/to/output/ ``` ### Optionale Parsing-Optionen | Argument | Langform | Beschreibung | | -------- | --------- | ----------- | | `-w` | `--wrap_text` | Setzen Sie dieses Flag, um den Textumbruch in Ausgabedateien zu **deaktivieren** | | `-m` | `--load_profile` | Pfad zu einer iLEAPP-Profildatei (`.ilprofile`), um einzuschränken, welche Module ausgeführt werden | | `-d` | `--load_case_data` | Pfad zu einer LEAPP-Falldatendatei (`.lcasedata`) | | `--custom_output_folder` | | Benutzerdefinierter Name für den Unterordner der Berichtsausgabe | | `--custom_artifacts_path` | | Zusätzlicher Ordner, aus dem Artefaktmodule geladen werden (z. B. `scripts/alternate_artifacts`) | | `--html_row_limit` | | Zeilenanzahl, ab der die Tabelle eines Artefakts von seiner HTML-Seite ausgelassen wird, die dann stattdessen auf die LAVA-Datenbank und den TSV-Export verweist. Standard 50000; `0` schreibt jede Tabelle. Die GUI verwendet den Standardwert | | `--itunes_password` | | | Passwort für ein verschlüsseltes iTunes/Finder-Backup (`-t 12345`) | ### Eigenständige Dienstprogramm-Modi Diese Modi parsen keinen Fall. Verwenden Sie sie **allein** — ohne `-t`, `-i` oder `-o`: | Argument | Langform | Beschreibung | | -------- | --------- | ----------- | | `-p` | `--artifact_paths` | Schreibt alle Artefakt-Suchpfade in `path_list.txt` im aktuellen Verzeichnis | | `-c` | `--create_profile_casedata` | Interaktiver Assistent zum Erstellen einer `.ilprofile`- oder `.lcasedata`-Datei im angegebenen Ordner | **Beispiele:** ``` ileapp -p ileapp -c /path/to/output/folder/ ``` ## Mitwirken Artefaktmodule liegen in `scripts/artifacts/` und werden zur Laufzeit dynamisch geladen. **Neue Module:** Beginnen Sie mit der Schritt-für-Schritt-Anleitung unter [How to Write an iLEAPP Module](https://leapps.org/blog-post?post=2026-06-14-how-to-write-an-ileapp-module). **Weitere Referenzen:** - [Artifact Info Block Structure](https://github.com/abrignoni/ileapp/blob/main/admin/docs/artifact_info_block.md) - [Helper Functions for Artifact Modules](https://github.com/abrignoni/ileapp/blob/main/admin/docs/helper_functions.md) - [Updating Modules for Automatic Output Generation](https://github.com/abrignoni/ileapp/blob/main/admin/docs/module_updates.md) - [Updating Complex Modules to Include LAVA Output](https://github.com/abrignoni/ileapp/blob/main/admin/docs/module_updates_advanced.md) - [Testing Modules](https://github.com/abrignoni/ileapp/blob/main/admin/docs/testing/readme.md) ## Testdaten und sample_data für Ihren PR Ein PR, der ein Artefakt hinzufügt oder ändert, lässt sich am einfachsten prüfen und zusammenführen, wenn er zwei Dinge enthält: ein kleines Test-Fixture, das aus einer echten Extraktion geschnitten wurde, und `sample_data`-Werte, die festhalten, was das Modul erzeugt hat. Skripte generieren beides. Hier ist der gesamte Ablauf. Eine Regel vor allem anderen: Was Sie hier committen, wird öffentlich. Verwenden Sie nur Daten, die Sie teilen dürfen, etwa ein Testgerät, das Sie selbst befüllt haben, ein öffentliches Forschungsabbild oder eine Datei, die Sie von Hand bereinigt haben. Niemals Fallarbeit. **1. Schneiden Sie ein Fixture aus Ihrer Extraktion** ``` python admin/test/scripts/make_test_data.py <module> --case 1 --input <extraction.zip> ``` Dies extrahiert die Dateien, die zu den `paths`-Mustern deines Moduls passen, aus der Extraktion und schreibt die Case-Datei `admin/test/cases/testdata.<module>.json` sowie eine kleine Zip-Datei pro Artefakt unter `admin/test/cases/data/<module>/`. Größenregeln: Unter 10 MB pro Zip-Datei committe sie mit dem PR. Zwischen 10 und 25 MB committe die Case-Datei und hänge die Zip-Datei an einen PR-Kommentar an. Bei mehr als das gib es im PR an, und ein Maintainer wird eine Übergabe arrangieren. **2. Erwartete Ausgabe aufzeichnen** ``` TZ=UTC python admin/test/scripts/test_module.py <module> -a all -c all ``` Dies führt das Modul gegen das Fixture aus und schreibt einen Snapshot der Ausgabe unter `admin/test/results/<module>/`. Committe den Snapshot ebenfalls. Er wird zur Baseline, die das Modul nach dem Merge absichert. Behalte den Teil `TZ=UTC` bei: Die committeten Snapshots sind in UTC und CI läuft in UTC. **3. Führe denselben Vergleich aus, den CI ausführen wird** ``` python admin/test/scripts/run_test_cases.py --module <module> ``` **4. Die sample_data-Werte generieren** ``` python admin/scripts/validate_sample_data.py --emit <extraction.zip> --key <image_name> ``` Dies führt iLEAPP end-to-end auf Ihrer Extraktion aus und gibt sofort einsatzbereite `sample_data`-Blöcke für die Module aus, die in Ihrem Branch geändert wurden. Fügen Sie diese in die `__artifacts_v2__` Ihres Moduls ein und ergänzen Sie den App-Namen und die Version, die Sie auf dem Image gesehen haben. Wenn eine Anzahl null ist, prüfen Sie, ob die Quelldatei wirklich leer ist, bevor Sie sie erfassen. **5. Alles committen und den PR öffnen** Committen Sie das Modul, die Falldatei, die Fixture-Zips und den erfassten Snapshot zusammen. Weitere Details finden Sie in [admin/docs/testing/create_module_test_cases.md](https://github.com/abrignoni/ileapp/blob/main/admin/docs/testing/create_module_test_cases.md). Wenn Ihre Extraktion nicht geteilt werden kann, öffnen Sie den PR trotzdem und geben Sie dies an. Ein Fixture kann oft stattdessen aus einem öffentlichen Forschungsimage erstellt werden, oder die echte Datei kann manuell bereinigt werden. Die Überprüfung wird nicht angehalten, während wir das klären. ## Aus dem Quellcode ausführen Releases sind der einfachste Weg, iLEAPP auszuführen. Verwenden Sie den Quellcode, wenn Sie Module entwickeln oder nicht veröffentlichte Änderungen aus `main` benötigen. ### Voraussetzungen - Python 3.11 bis 3.15 - Git ### Einrichtung ``` 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 ``` Installiere unter **Linux** `tkinter` für die GUI: ``` sudo apt-get install python3-tk ``` Windows-Setup-Hilfe von Hexordia: - [ILEAPP Walkthrough (PDF)](https://www.hexordia.com/s/ILEAPP-Walkthrough.pdf) - [ILEAPP Walkthrough (Video)](https://www.youtube.com/watch?v=7qvVFfBM2NU) ### Verwendung Der Ausgabeordner muss vor dem Ausführen existieren. Source-Builds melden eine `-dev`-Version (z. B. `2.6.0-dev.0`), um sie von offiziellen Release-Builds zu unterscheiden. **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` liest ein Datenträgerabbild (`.img`, `.dd`, `.bin` oder ein beliebiges nummeriertes `.001`-Segment eines aufgeteilten Satzes) oder eine Erfassung und die daneben liegenden Segmente oder Dateien (EnCase/EWF `.E01`, SMART `.s01`, EWF2 `.Ex01`, AFF `.aff`, AFM `.afm`, jede `.aff` in einem AFD-Ordner, AFF4 `.aff4`, ein Apple `.dmg` mit den daneben liegenden `.dmgpart`-Dateien, `.sparseimage` oder `.sparsebundle`-Ordner oder eine Festplatte einer virtuellen Maschine, `.vhd`, `.vhdx`, `.vmdk` oder `.qcow2`) direkt vor Ort: ohne Einbinden und ohne Administratorrechte. Seine NTFS-, FAT32-, FAT16-, FAT12-, exFAT-, ext2/3/4-, F2FS-, HFS+-, APFS-, QNX6-, QNX4-, ETFS-, EFS-, SquashFS-, JFFS2-, UBI/UBIFS-, YAFFS- und QNX-IFS-Volumes werden direkt durchsucht (und eine U-Boot-Umgebung oder ein Belkin-NVRM-Speicher wird als eine Datei gelesen), und nur die Dateien, die ein Artefakt anfordert, werden aus dem Abbild ausgelesen. Logische Beweismittel, ein EnCase `.L01` oder ein FTK Imager `.ad1`, werden als die darin enthaltenen Dateien gelesen. Die GUI wählt `raw` für diese Erweiterungen selbst aus, ebenso für einen Sparse Bundle oder AFD-Ordner, der mit ihrer Ordnerschaltfläche ausgewählt wurde. Siehe `admin/docs/raw_image_input.md`. Ein verschlüsseltes Abbild öffnet sich mit seinem Passwort (`--image_password_file` oder `--image_password_env`) oder, wenn es an ein Zertifikat versiegelt ist, mit dem RSA-Privatschlüssel dieses Zertifikats (`--image_private_key`). Ein BitLocker-Volume in einem Abbild öffnet sich mit seinem Passwort oder Wiederherstellungspasswort, auf dieselbe Weise angegeben, oder mit seinem Startschlüssel (`--bitlocker_key`, wiederholbar), ein APFS-Volume, das macOS in Software verschlüsselt hat, mit seinem Passwort oder persönlichen Wiederherstellungsschlüssel und ein LUKS-Container mit seiner Passphrase, jeweils auf dieselbe Weise angegeben. In einem Terminal wird alles Fehlende abgefragt, und die GUI fragt in Dialogen danach; ein BitLocker-, APFS- oder LUKS-Volume, das sich nicht öffnen lässt, wird gemeldet und nicht durchsucht. Die Datenträgerabbilder eines Linux-Software-RAID-Verbunds (md oder LVM2 über mehrere Datenträger) werden gemeinsam gelesen: Geben Sie sie alle mit `-i` und `-t raw` an oder wählen Sie sie gemeinsam im Dateidialog der GUI aus. Wird ein Abbild angegeben, das ein Mitglied enthält, werden die anderen Mitglieder in seinem Ordner anhand der Angaben gesucht, die jede Datei über sich selbst enthält, nicht anhand ihres Namens; die Befehlszeile listet vor dem Lesen des Verbunds auf, was sie gefunden und was sie aus welchem Grund ausgelassen hat (`--no-find-members` liest nur das angegebene Abbild), und die GUI fragt nach, bevor sie gefundene Dateien liest. Der Bericht nennt jedes gelesene Abbild und kennzeichnet die automatisch gefundenen. Ein Abbild, das ein md-Mitglied enthält, wird auch mit seinen Arrays gelesen: Ein einzelnes RAID1-Mitglied mit Metadaten 1.1 oder 1.2 liest sein Dateisystem nun über das Array, und seine Volume-Namen erhalten den Namen des Abbilds oder des Arrays vorangestellt. Ein zweimal angegebener Datenträger wird einmal gelesen. Ein Abbild, in dem keine RAID-Metadaten gefunden werden, wird wie bisher gelesen; siehe `admin/docs/raw_image_input.md` dazu, was qnxprobe 1.71 mit DDF-, IMSM- und md-Mitgliedsabbildern macht, die allein gelesen werden. `tar` liest auch ein xz-komprimiertes tar (`.tar.xz`), und die GUI wählt `tar` für diese Erweiterung. Ein komprimiertes tar, einschließlich `.tar.gz`, wird einmal in den Berichtsordner entpackt, bevor eine Datei gelesen wird, sodass der Lauf dort freien Speicherplatz für das unkomprimierte tar benötigt. Die Kopie wird am Ende des Laufs gelöscht, und das Laufprotokoll gibt an, wie lange der Schritt gedauert hat. **GUI:** ``` python ileappGUI.py ``` Siehe [CLI-Argumente](#cli-arguments) oben oder führe `python ileapp.py --help` aus. ### Erstellen der Binärdateien `packaging/build.py` erstellt `ileapp` mit PyInstaller für die Maschine, auf der es ausgeführt wird, aus derselben virtuellen Umgebung. Führe zuerst `python admin/scripts/fetch_unifiedlog_iterator.py` aus, um den Unified-Log-Parser zu bündeln. ``` python packaging/build.py exe # dist/iLEAPP/, and dist/iLEAPP.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 ``` `exe --onefile` erzeugt stattdessen `dist/ileapp` (`dist\ileapp.exe` unter Windows) als einzelne Datei. Der Windows-Installer benötigt [Inno Setup](https://jrsoftware.org/isdl.php); unter Linux benötigt `smoke` ein Display, das `xvfb-run` bereitstellt. `python packaging/build.py --help` enthält den Rest. Ein Linux-Build benötigt die glibc der Maschine, auf der er gebaut wurde, oder eine neuere. Ein Build, der auf einer neueren Distribution erstellt wurde, startet nicht auf älteren; baue auf Ubuntu 22.04, um mit den Release-Builds übereinzustimmen. ## Code-Signierungsrichtlinie Kostenlose Code-Signierung bereitgestellt von [SignPath.io](https://about.signpath.io/), Zertifikat von [SignPath Foundation](https://signpath.org/). Die Windows-Builds sind noch nicht signiert. iLEAPP bewirbt sich um das kostenlose Code-Signierungsprogramm der SignPath Foundation für Open-Source-Projekte, und diese Richtlinie gilt für jede Windows-Version, die im Rahmen dieses Programms signiert wird. Die Windows-Executables, die an [GitHub Releases](https://github.com/abrignoni/iLEAPP/releases) angehängt sind, werden aus diesem Repository von GitHub Actions auf GitHub-gehosteten Runnern gebaut ([`release.yml`](https://github.com/abrignoni/ileapp/blob/main/.github/workflows/release.yml)). Im Rahmen dieser Richtlinie signiert SignPath nur das, was dieser Workflow gebaut hat. Die macOS-Disk-Images werden separat mit einer Apple Developer ID signiert und von Apple notarisiert. SignPath signiert `ileapp.exe`, das Einzeldateiprogramm im portablen Zip. Dateien von Drittanbietern, die darin verpackt sind, wie Mandiants Unified Log Parser (`unifiedlog_iterator.exe`), werden nicht separat signiert. ### Teamrollen - Committer und Reviewer: [@abrignoni](https://github.com/abrignoni), [@JamesHabben](https://github.com/JamesHabben), [@Johann-PLW](https://github.com/Johann-PLW), [@stark4n6](https://github.com/stark4n6) - Genehmiger: [@abrignoni](https://github.com/abrignoni), [@Johann-PLW](https://github.com/Johann-PLW) Änderungen, die von Personen vorgeschlagen werden, die keine Committer sind, werden von einem Committer geprüft, bevor sie zusammengeführt werden. Jede Signierungsanfrage für ein Release wird von einem Genehmiger genehmigt. ### Datenschutzrichtlinie iLEAPP verarbeitet Extraktionen lokal, auf der Maschine, auf der es läuft. Dieses Programm überträgt keine Informationen an andere vernetzte Systeme, es sei denn, dies wird ausdrücklich vom Benutzer oder der Person, die es installiert oder betreibt, angefordert. Dieselbe Richtlinie gilt für die anderen LEAPPs: [leapps.org/releases#code-signing-policy](https://leapps.org/releases#code-signing-policy). ## Lizenz Der Code von iLEAPP steht unter der MIT-Lizenz (`LICENSE`). Um HEIC-Bilder anzuzeigen, enthalten die paketierten Programme auf der Releases-Seite heicreader, das unter MIT steht und aus MIT- und BSD-3-Clause-Code gebaut ist. Seine Lizenztexte befinden sich in [`LICENSES/`](https://github.com/abrignoni/ileapp/blob/main/LICENSES/THIRD-PARTY-NOTICES.md). Jedes paketierte Programm enthält außerdem in `LICENSES/bundled/` die Lizenz jedes enthaltenen Python-Pakets und jeder von der Build-Maschine übernommenen Bibliothek und benennt diejenigen unter Copyleft-Bedingungen, wie simplekml (LGPL), mit einem Link zu ihrer Quelle. ## Danksagungen Dieses Triage-Tool ist das Ergebnis einer gemeinsamen Anstrengung vieler Menschen in der DFIR-Community. Das iLEAPP-Logo wurde von Kevin Pagano zur Verfügung gestellt. Das frühere iLEAPP-Logo stammt von Derek Eiri.