ipsw

سكين الجيب السويسري لأبحاث iOS/macOS

ما هو ipsw 🤔

ipsw هو إطار عمل بحثي شامل لسطر الأوامر خاص بـ iOS و macOS. يوفر مجموعة أدوات واسعة لباحثي الأمن، ومهندسي الهندسة العكسية، ومطوّري الجيلبريك، وعشاق iOS لتنزيل وتحليل ملفات Apple الثابتة والتفاعل مع أجهزة iOS واستخراج محتواها.

الإمكانيات الأساسية

• 📱 تحليل IPSW/OTA - تنزيل واستخراج وتحليل ملفات iOS الثابتة
• 🔍 تحليل الثنائيات - تحليل متقدم لملفات Mach-O مع فك تجميع ARM ومساعدة الذكاء الاصطناعي
• 🧠 dyld_shared_cache - تحليل كامل للذاكرة المؤقتة المشتركة مع تفريغ أصناف ObjC/Swift
• 🔧 تحليل النواة - تحليل Kernelcache واستخراج استدعاءات النظام والرمزية
• 📲 التفاعل مع الأجهزة - إدارة شاملة لأجهزة iOS وتصحيح الأخطاء
• 🔐 أبحاث البرامج الثابتة - تحليل برامج IMG4 و iBoot و SEP الثابتة وبرامج المعالجات المساعدة
• 🏪 App Store Connect - تكامل كامل مع واجهة برمجة التطبيقات لإدارة التطبيقات والشهادات
• 🛠️ أدوات المطوّرين - أدوات SSH و Frida وتصحيح الأخطاء والهندسة العكسية

بدء الاستخدام السريع

التثبيت

macOS

باستخدام إضافة blacktop (تشمل إضافات إضافية)

brew install blacktop/tap/ipsw

باستخدام صيغة Homebrew الرسمية

brew install ipsw

Linux

sudo snap install ipsw

Windows

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

الاستخدام الأساسي

# تنزيل أحدث IPSW لنظام iOS
ipsw download ipsw --device iPhone16,1 --latest

# استخراج kernelcache
ipsw extract --kernel iPhone16,1_18.2_22C150_Restore.ipsw

# تحليل dyld_shared_cache
ipsw dyld info /path/to/dyld_shared_cache_arm64

# الحصول على معلومات الجهاز
ipsw idev list

الميزات الرئيسية

📱 إدارة IPSW و OTA

• مصادر التنزيل: Apple و AppleDB و Developer Portal وخلاصات RSS و GitHub و iTunes و Wikipedia
• أنواع الملفات: IPSW و OTA ومثبّتات macOS و Xcode و KDKs وملفات PCC
• العمليات: الاستخراج والمقارنة والتركيب وتحليل البيانات الوصفية

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

🔍 تحليل الثنائيات والهندسة العكسية

• تحليل Mach-O: تحليل كامل للثنائيات مع استخراج الرموز
• فك تجميع ARM: مفكك تجميع ARM v9-a مع تحليل مدعوم بالذكاء الاصطناعي
• توقيع الكود: التحقق من التوقيعات وتحليل الصلاحيات
• ترقيع الثنائيات: إضافة الترقيعات أو تعديلها أو إزالتها

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

• تحليل الذاكرة المؤقتة: استخراج وتحليل بنية الذاكرة المؤقتة المشتركة بالكامل
• تحليل ObjC: تفريغ الأصناف وتحليل الدوال وتحليل البروتوكولات
• دعم Swift: تفريغ وتحليل أصناف Swift (تجريبي)
• إدارة الرموز: استخراج الرموز وحل العناوين

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 (idev)

• نظام الملفات: تصفح ونقل الملفات عبر AFC
• إدارة التطبيقات: تثبيت التطبيقات وإلغاء تثبيتها وتحليلها
• النسخ الاحتياطي والاستعادة: عمليات نسخ احتياطي كاملة للأجهزة
• التطوير: تركيب صور المطوّرين والتقاط السجلات والتقاط الحزم
• التشخيص: معلومات البطارية وسجلات الأعطال وتشخيصات النظام

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

🔐 تحليل البرامج الثابتة والأمن

• IMG4: تحليل وفك تشفير ملفات صيغة Image4
• iBoot: تحليل وأبحاث محمّل الإقلاع
• SEP: تحليل البرامج الثابتة لمعالج الأمان المساعد
• AEA: فك تشفير الأرشيفات المشفرة من Apple
• المعالجات المساعدة: تحليل برامج AOP و DCP و GPU و Camera الثابتة

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

• إدارة الشهادات: شهادات وملفات تعريف iOS/macOS
• تسجيل الأجهزة: إدارة أجهزة التطوير
• إدارة التطبيقات: معرفات الحزم والقدرات والمراجعات
• التزويد: دورة حياة كاملة لملفات تعريف التزويد

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

🛠️ أدوات بحث متقدمة

• الرمزية: تحليل سجلات الأعطال ودقة الرموز
• تفريغ الأصناف: استخراج أصناف ObjC و Swift
• الوصول عبر SSH: وصول SSH للأجهزة المخترقة مع debugserver
• تكامل Frida: إمكانيات التنقيب الديناميكي
• مفكك تجميع مدعوم بالذكاء الاصطناعي: تكامل مع Claude و OpenAI و Gemini و Ollama و OpenRouter

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

البنية

يتكون ipsw من مكوّنين رئيسيين:

• ipsw - أداة سطر الأوامر الرئيسية مع إمكانيات تحليل كاملة
• ipswd - خادم واجهة برمجة تطبيقات REST للعمليات البعيدة والأتمتة

الإعدادات

يدعم ipsw ملفات إعدادات YAML ومتغيرات البيئة:

# إنشاء مجلد الإعدادات
mkdir -p ~/.config/ipsw

# نسخ مثال الإعدادات
cp config.example.yml ~/.config/ipsw/config.yaml

دعم قواعد البيانات

• SQLite (الافتراضي) - تخزين محلي
• PostgreSQL - نشر للإنتاج

مفكك التجميع المدعوم بالذكاء الاصطناعي

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"
   • Loading symbol cache file...
   • Decompiling... 🕒

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];
        }
    }
}

حالات الاستخدام

البحث الأمني

• تحليل الثغرات وتطوير الاستغلالات
• تقييم أمن البرامج الثابتة
• الهندسة العكسية للثنائيات

تطوير الجيلبريك

• تحليل واستغلال سلسلة الإقلاع
• أبحاث ملحقات النواة
• تعديل النظام وترقيعه

تطوير iOS

• تصحيح أخطاء التطبيقات وتحليلها
• إدارة الشهادات وملفات التزويد
• اختبار الأجهزة وأتمتتها

التحليل الجنائي الرقمي

• استخراج بيانات الأجهزة وتحليلها
• إعادة بناء الجداول الزمنية
• تحليل القطع الأثرية

المتطلبات

• Go: 1.24+ (للبناء من المصدر)
• المنصات: macOS و Linux و Windows
• USB: libusb للتفاعل مع الأجهزة
• اختياري: مفاتيح واجهة برمجة تطبيقات الذكاء الاصطناعي للتحليل المحسّن

التوثيق

• الموقع: https://blacktop.github.io/ipsw
• توثيق واجهة برمجة التطبيقات: توثيق REST API متاح على /docs عند تشغيل ipswd
• أمثلة: أمثلة استخدام شاملة في التوثيق

SKILL.md

عزّز وكلاء الذكاء الاصطناعي لديك بقدرات ipsw الخارقة

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

🆕 ويكيبيديا مدعومة بالذكاء الاصطناعي

اطرح أسئلة حول المستودع باستخدام الذكاء الاصطناعي:

• DeepWiki for IPSW

[!WARNING] قد تحتوي ردود الذكاء الاصطناعي على هلوسات - تحقق من المعلومات المهمة.

موارد المجتمع

📊 فروقات IPSW

فروقات برامج ثابتة محسوبة مسبقًا: ipsw-diffs

💬 المجتمع

المساهمة

نرحب بالمساهمات! يرجى الاطلاع على CONTRIBUTING.md للإرشادات.

التطوير

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

المشكلات المعروفة

• دعم IPSW لنظام macOS: قد تواجه بعض عمليات برامج macOS الثابتة مشكلات توافق
• الاختبار: الاختبار الشامل يمثل تحديًا بسبب تنوع إصدارات البرامج الثابتة وأنواع الأجهزة
• استهلاك الموارد: تتطلب بعض العمليات ذاكرة وقدرة معالجة كبيرة

أنشئ issue إذا واجهت مشكلات - يتم إصلاحها بأولوية قصوى! مجموعة اختبارات شاملة مخطط لها في الإصدارات المستقبلية.

الشكر

شكر كبير إلى:

• Jonathan Levin على أدواته الأسطورية وتوثيقه الشامل لدواخل iOS
• مجتمع أبحاث iOS على الابتكار المستمر ومشاركة المعرفة
• جميع المساهمين الذين يساعدون في جعل هذا المشروع أفضل

الترخيص

رخصة MIT - انظر LICENSE للتفاصيل.