ipsw

iOS/macOS अनुसंधान के लिए स्विस आर्मी चाकू

`ipsw` क्या है 🤔

ipsw iOS और macOS के लिए एक व्यापक कमांड-लाइन अनुसंधान ढांचा है। यह सुरक्षा शोधकर्ताओं, रिवर्स इंजीनियरों, जेलब्रेक डेवलपर्स और iOS उत्साही लोगों के लिए Apple फर्मवेयर डाउनलोड करने, पार्स करने और विश्लेषण करने तथा iOS डिवाइसों के साथ इंटरैक्ट करने हेतु एक विस्तृत टूलकिट प्रदान करता है।

मुख्य क्षमताएँ

📱 IPSW/OTA विश्लेषण - iOS फर्मवेयर फ़ाइलें डाउनलोड करें, निकालें और विश्लेषण करें
🔍 बाइनरी विश्लेषण - ARM डिसअसेंबली और AI सहायता के साथ उन्नत Mach-O पार्सिंग
🧠 dyld_shared_cache - ObjC/Swift क्लास डंपिंग के साथ पूर्ण शेयर्ड कैश विश्लेषण
🔧 कर्नेल विश्लेषण - Kernelcache पार्सिंग, syscall निष्कर्षण और सिंबोलिकेशन
📲 डिवाइस इंटरैक्शन - व्यापक iOS डिवाइस प्रबंधन और डिबगिंग
🔐 फर्मवेयर अनुसंधान - IMG4, iBoot, SEP और को-प्रोसेसर फर्मवेयर विश्लेषण
🏪 App Store Connect - ऐप और प्रमाणपत्र प्रबंधन के लिए पूर्ण API एकीकरण
🛠️ डेवलपर टूल्स - SSH, Frida, डिबगिंग और रिवर्स इंजीनियरिंग उपयोगिताएँ

त्वरित आरंभ

स्थापना

macOS

blacktop tap का उपयोग करके (एक्स्ट्रा सहित)

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

बुनियादी उपयोग

# नवीनतम iOS IPSW डाउनलोड करें
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 डिसअसेंबली: AI-संचालित विश्लेषण के साथ ARM v9-a डिसअसेंबलर
कोड साइनिंग: हस्ताक्षर सत्यापित करें, entitlements का विश्लेषण करें
बाइनरी पैचिंग: पैच जोड़ें, संशोधित करें या हटाएँ

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: Secure Enclave Processor फर्मवेयर विश्लेषण
AEA: Apple Encrypted Archives डिक्रिप्शन
को-प्रोसेसर: AOP, DCP, GPU, कैमरा फर्मवेयर विश्लेषण

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 प्रमाणपत्र और प्रोफ़ाइल
डिवाइस पंजीकरण: विकास डिवाइस प्रबंधित करें
ऐप प्रबंधन: Bundle IDs, क्षमताएँ और समीक्षाएँ
प्रोविज़निंग: पूर्ण प्रोविज़निंग प्रोफ़ाइल जीवनचक्र

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

🛠️ उन्नत अनुसंधान उपकरण

सिंबोलिकेशन: क्रैश लॉग विश्लेषण और सिंबल समाधान
क्लास डंपिंग: ObjC और Swift क्लास निष्कर्षण
SSH एक्सेस: debugserver के साथ जेलब्रोकन डिवाइस SSH
Frida एकीकरण: डायनामिक इंस्ट्रूमेंटेशन क्षमताएँ
AI-संचालित डीकंपाइलर: Claude, OpenAI, Gemini, Ollama और OpenRouter के साथ एकीकरण

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

आर्किटेक्चर

ipsw में दो मुख्य घटक शामिल हैं:

ipsw - पूर्ण विश्लेषण क्षमताओं वाला मुख्य CLI टूल
ipswd - रिमोट संचालन और स्वचालन के लिए REST API डेमन

कॉन्फ़िगरेशन

ipsw YAML कॉन्फ़िगरेशन फ़ाइलों और पर्यावरण चरों का समर्थन करता है:

# कॉन्फ़िग निर्देशिका बनाएँ
mkdir -p ~/.config/ipsw

# उदाहरण कॉन्फ़िग कॉपी करें
cp config.example.yml ~/.config/ipsw/config.yaml

डेटाबेस समर्थन

SQLite (डिफ़ॉल्ट) - स्थानीय भंडारण
PostgreSQL - उत्पादन परिनियोजन

AI डीकंपाइलर

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"
   • सिंबल कैश फ़ाइल लोड हो रही है...
   • डीकंपाइल हो रहा है... 🕒

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.26+ (स्रोत से निर्माण के लिए)
प्लेटफ़ॉर्म: macOS, Linux, Windows
USB: डिवाइस इंटरैक्शन के लिए libusb
वैकल्पिक: उन्नत विश्लेषण के लिए AI API कुंजियाँ

दस्तावेज़ीकरण

वेबसाइट: https://blacktop.github.io/ipsw
API दस्तावेज़: ipswd चलाते समय /docs पर REST API दस्तावेज़ीकरण उपलब्ध है
उदाहरण: दस्तावेज़ीकरण में व्यापक उपयोग उदाहरण

SKILL.md

अपने AI एजेंटों को ipsw सुपर पावर से सशक्त बनाएँ

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

🆕 AI-संचालित विकी

रिपॉजिटरी के बारे में AI का उपयोग करके प्रश्न पूछें:

IPSW के लिए DeepWiki

[!WARNING] AI प्रतिक्रियाओं में भ्रम हो सकता है - महत्वपूर्ण जानकारी सत्यापित करें।

सामुदायिक संसाधन

📊 IPSW अंतर

पूर्व-गणना फर्मवेयर अंतर: ipsw-diffs

💬 समुदाय

योगदान

हम योगदान का स्वागत करते हैं! कृपया दिशानिर्देशों के लिए CONTRIBUTING.md देखें।

विकास

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

ज्ञात समस्याएँ

macOS IPSW समर्थन: कुछ macOS फर्मवेयर संचालन में संगतता समस्याएँ हो सकती हैं
परीक्षण: फर्मवेयर संस्करणों और डिवाइस प्रकारों की विविधता के कारण व्यापक परीक्षण चुनौतीपूर्ण है
संसाधन-गहन: कुछ संचालनों के लिए महत्वपूर्ण मेमोरी और प्रोसेसिंग शक्ति की आवश्यकता होती है

यदि आपको समस्याएँ आती हैं तो एक issue बनाएँ - सुधारों को प्राथमिकता दी जाती है! भविष्य के रिलीज़ के लिए एक व्यापक परीक्षण सूट की योजना बनाई गई है।

श्रेय

विशेष धन्यवाद:

Jonathan Levin को उनके प्रसिद्ध टूल्स और व्यापक iOS इंटर्नल्स दस्तावेज़ीकरण के लिए
iOS अनुसंधान समुदाय को निरंतर नवाचार और ज्ञान साझा करने के लिए
सभी योगदानकर्ताओं को जो इस प्रोजेक्ट को बेहतर बनाने में मदद करते हैं

लाइसेंस

MIT लाइसेंस - विवरण के लिए LICENSE देखें।

ipsw v3.1.716

श्रेणियाँ