ipsw

iOS/macOS Research Schweizer Taschenmesser

Was ist ipsw 🤔

ipsw ist ein umfassendes Kommandozeilen-Forschungsframework für iOS und macOS. Es bietet ein umfangreiches Toolkit für Sicherheitsforscher, Reverse Engineers, Jailbreak-Entwickler und iOS-Enthusiasten zum Herunterladen, Parsen und Analysieren von Apple-Firmware sowie zur Interaktion mit iOS-Geräten.

Kernfunktionen

• 📱 IPSW/OTA-Analyse – iOS-Firmware-Dateien herunterladen, extrahieren und analysieren
• 🔍 Binäranalyse – Fortschrittliches Mach-O-Parsing mit ARM-Disassemblierung und KI-Unterstützung
• 🧠 dyld_shared_cache – Vollständige Shared-Cache-Analyse mit ObjC/Swift-Klassendumping
• 🔧 Kernel-Analyse – Kernelcache-Parsing, Syscall-Extraktion und Symbolisierung
• 📲 Geräteinteraktion – Umfassende iOS-Geräteverwaltung und -Debugging
• 🔐 Firmware-Forschung – IMG4-, iBoot-, SEP- und Co-Prozessor-Firmware-Analyse
• 🏪 App Store Connect – Vollständige API-Integration für App- und Zertifikatsverwaltung
• 🛠️ Entwicklerwerkzeuge – SSH-, Frida-, Debugging- und Reverse-Engineering-Dienstprogramme

Schnellstart

Installation

macOS

Mit dem blacktop-Tap (inklusive Extras)

brew install blacktop/tap/ipsw

Mit der offiziellen Homebrew-Formel

brew install ipsw

Linux

sudo snap install ipsw

Windows

scoop bucket add blacktop https://github.com/blacktop/scoop-bucket.git 
scoop install blacktop/ipsw

Grundlegende Verwendung

# Neuestes iOS-IPSW herunterladen
ipsw download ipsw --device iPhone16,1 --latest

# Kernelcache extrahieren
ipsw extract --kernel iPhone16,1_18.2_22C150_Restore.ipsw

# dyld_shared_cache analysieren
ipsw dyld info /path/to/dyld_shared_cache_arm64

# Geräteinformationen abrufen
ipsw idev list

Hauptfunktionen

📱 IPSW- & OTA-Verwaltung

• Download-Quellen: Apple, AppleDB, Developer Portal, RSS-Feeds, GitHub, iTunes, Wikipedia
• Dateitypen: IPSW, OTA, macOS-Installer, Xcode, KDKs, PCC-Dateien
• Operationen: Extrahieren, Diff, Mounten, Metadaten analysieren

ipsw download ipsw --device iPhone16,1 --latest
ipsw extract --kernel iPhone16,1_18.2_22C150_Restore.ipsw
ipsw diff iPhone16,1_18.1_22B83_Restore.ipsw iPhone16,1_18.2_22C150_Restore.ipsw

🔍 Binäranalyse & Reverse Engineering

• Mach-O-Parsing: Vollständige Binäranalyse mit Symbolextraktion
• ARM-Disassemblierung: ARM-v9-a-Disassembler mit KI-gestützter Analyse
• Codesignierung: Signaturen verifizieren, Berechtigungen analysieren
• Binär-Patching: Patches hinzufügen, ändern oder entfernen

ipsw macho info /path/to/binary
ipsw macho disass /path/to/binary --symbol _main
ipsw macho search /path/to/binary --string "password"

🧠 dyld_shared_cache-Analyse

• Cache-Parsing: Vollständige Shared-Cache-Struktur extrahieren und analysieren
• ObjC-Analyse: Klassendumps, Methodenanalyse, Protokoll-Parsing
• Swift-Unterstützung: Swift-Klassendumping und -Analyse (experimentell)
• Symbolverwaltung: Symbolextraktion und Adressauflösung

ipsw dyld info /path/to/dyld_shared_cache
ipsw dyld extract /path/to/dyld_shared_cache --dylib Foundation
ipsw dyld objc class /path/to/dyld_shared_cache --class NSString

📲 iOS-Geräteinteraktion (idev)

• Dateisystem: Dateien über AFC durchsuchen und übertragen
• App-Verwaltung: Anwendungen installieren, deinstallieren und analysieren
• Backup & Wiederherstellung: Vollständige Geräte-Backup-Operationen
• Entwicklung: Entwickler-Images mounten, Protokolle erfassen, Paketerfassung
• Diagnose: Akku-Informationen, Absturzprotokolle, Systemdiagnose

ipsw idev list
ipsw idev afc ls /
ipsw idev apps ls
ipsw idev backup create
ipsw idev syslog

🔐 Firmware- & Sicherheitsanalyse

• IMG4: Image4-Format-Dateien parsen und entschlüsseln
• iBoot: Bootloader-Analyse und -Forschung
• SEP: Firmware-Analyse des Secure-Enclave-Prozessors
• AEA: Entschlüsselung Apple-verschlüsselter Archive
• Co-Prozessoren: AOP-, DCP-, GPU-, Kamera-Firmware-Analyse

ipsw img4 dec iBoot.img4
ipsw fw sep iPhone16,1_18.2_22C150_Restore.ipsw
ipsw fw iboot iPhone16,1_18.2_22C150_Restore.ipsw

🏪 App-Store-Connect-Integration

• Zertifikatsverwaltung: iOS/macOS-Zertifikate und -Profile
• Geräteregistrierung: Entwicklungsgeräte verwalten
• App-Verwaltung: Bundle-IDs, Fähigkeiten und Bewertungen
• Provisioning: Vollständiger Lebenszyklus von Provisioning-Profilen

ipsw appstore cert ls
ipsw appstore device reg --name "My Device" --udid 1234567890
ipsw appstore profile create --name "Development Profile"

🛠️ Fortgeschrittene Forschungswerkzeuge

• Symbolisierung: Absturzprotokoll-Analyse und Symbolauflösung
• Klassendumping: ObjC- und Swift-Klassenextraktion
• SSH-Zugriff: SSH auf gejailbreakte Geräte mit debugserver
• Frida-Integration: Fähigkeiten zur dynamischen Instrumentierung
• KI-gestützter Decompiler: Integration mit Claude, OpenAI, Gemini, Ollama und OpenRouter

ipsw symbolicate crash.ips --dsym /path/to/symbols
ipsw class-dump /path/to/binary
ipsw ssh debugserver

Architektur

ipsw besteht aus zwei Hauptkomponenten:

• ipsw – Haupt-CLI-Tool mit vollständigen Analysefunktionen
• ipswd – REST-API-Daemon für Remote-Operationen und Automatisierung

Konfiguration

ipsw unterstützt YAML-Konfigurationsdateien und Umgebungsvariablen:

# Konfigurationsverzeichnis erstellen
mkdir -p ~/.config/ipsw

# Beispielkonfiguration kopieren
cp config.example.yml ~/.config/ipsw/config.yaml

Datenbankunterstützung

• SQLite (Standard) – Lokale Speicherung
• PostgreSQL – Produktionsbereitstellungen

KI-Decompiler

https://blacktop.github.io/ipsw/docs/guides/decompiler

❱ ipsw macho disass /System/Library/PrivateFrameworks/ApplePushService.framework/apsd --entry \
             --dec --dec-model "Claude 3.7 Sonnet"
   • Symbol-Cache-Datei wird geladen...
   • Decompilierung läuft... 🕒

int main(int argc, char *argv[]) {
    @autoreleasepool {
        __set_user_dir_suffix(@"com.apple.apsd");

        @autoreleasepool {
            APSDaemon *daemon = [[APSDaemon alloc] init];

            if (daemon) {
                NSRunLoop *runLoop = [NSRunLoop currentRunLoop];
                [runLoop run];
                [runLoop release];
            }

            [daemon release];
        }

        return 0;
    }

    @catch (NSException *exception) {
        if ([exception reason] == 1) {
            id exceptionObj = [exception retain];
            id logger = [APSLog daemon];

            if (_os_log_type_enabled(logger, 0x11)) {
                [exceptionObj logWithLogger:logger];
            }

            [logger release];
            [exceptionObj release];
        }
    }
}

Anwendungsfälle

Sicherheitsforschung

• Schwachstellenanalyse und Exploit-Entwicklung
• Bewertung der Firmware-Sicherheit
• Binäres Reverse Engineering

Jailbreak-Entwicklung

• Bootchain-Analyse und -Ausnutzung
• Kernel-Erweiterungsforschung
• Systemmodifikation und -Patching

iOS-Entwicklung

• App-Debugging und -Analyse
• Zertifikats- und Provisioning-Verwaltung
• Gerätetests und Automatisierung

Digitale Forensik

• Gerätedatenextraktion und -analyse
• Timeline-Rekonstruktion
• Artefaktanalyse

Anforderungen

• Go: 1.26+ (für die Kompilierung aus dem Quellcode)
• Plattform: macOS, Linux, Windows
• USB: libusb für die Geräteinteraktion
• Optional: KI-API-Schlüssel für erweiterte Analyse

Dokumentation

• Website: https://blacktop.github.io/ipsw
• API-Dokumentation: REST-API-Dokumentation verfügbar unter /docs bei Ausführung von ipswd
• Beispiele: Umfassende Verwendungsbeispiele in der Dokumentation

SKILL.md

Verstärken Sie Ihre KI-Agenten mit ipsw-Superkräften

npx skills add https://github.com/blacktop/ipsw-skill --skill ipsw

🆕 KI-gestütztes Wiki

Stellen Sie Fragen zum Repository mithilfe von KI:

• DeepWiki für IPSW

[!WARNING] KI-Antworten können Halluzinationen enthalten – verifizieren Sie wichtige Informationen.

Community-Ressourcen

📊 IPSW-Diffs

Vorberechnete Firmware-Unterschiede: ipsw-diffs

💬 Community

Mitwirken

Wir freuen uns über Beiträge! Bitte beachten Sie CONTRIBUTING.md für Richtlinien.

Entwicklung

git clone https://github.com/blacktop/ipsw.git
cd ipsw
make build

Bekannte Probleme

• macOS-IPSW-Unterstützung: Einige macOS-Firmware-Operationen können Kompatibilitätsprobleme aufweisen
• Tests: Umfassende Tests sind aufgrund der Vielfalt an Firmware-Versionen und Gerätetypen eine Herausforderung
• Ressourcenintensiv: Einige Operationen erfordern erheblichen Speicher und Rechenleistung

Erstellen Sie ein Issue, wenn Sie auf Probleme stoßen – Fixes werden priorisiert! Eine umfassende Testsuite ist für zukünftige Versionen geplant.

Danksagungen

Großer Dank an:

• Jonathan Levin für seine legendären Tools und die umfassende Dokumentation der iOS-Interna
• Die iOS-Forschungsgemeinschaft für kontinuierliche Innovation und Wissensaustausch
• Alle Mitwirkenden, die dazu beitragen, dieses Projekt besser zu machen

Lizenz

MIT-Lizenz – siehe LICENSE für Details.