
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 |
प्रत्येक डाउनलोड में एक प्रोग्राम, ileapp, होता है। प्रत्येक रिलीज़ में SHA256SUMS.txt आपको डाउनलोड जाँचने देता है।
Linux संगतता: आधिकारिक AppImages 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) चलाएँ।
सामान्य पार्स रन के लिए ये तीन आर्ग्युमेंट्स आवश्यक हैं:
| आर्ग्युमेंट | लंबा रूप | विवरण |
|---|---|---|
-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 की समीक्षा और मर्ज करना सबसे आसान तब होता है जब उसके साथ
दो चीज़ें आएँ: एक वास्तविक एक्सट्रैक्शन से काटा गया छोटा टेस्ट फ़िक्स्चर, और sample_data मान जो
रिकॉर्ड करते हैं कि मॉड्यूल ने क्या उत्पन्न किया। स्क्रिप्ट्स दोनों को जनरेट करती हैं। यहाँ पूरा प्रवाह दिया गया है।
किसी भी चीज़ से पहले एक नियम: आप यहाँ जो भी कमिट करते हैं वह सार्वजनिक हो जाता है। केवल वही डेटा उपयोग करें जिसे साझा करने की आपको अनुमति है, जैसे कोई टेस्ट डिवाइस जिसे आपने स्वयं भरा हो, कोई सार्वजनिक शोध इमेज, या कोई फ़ाइल जिसे आपने हाथ से सैनिटाइज़ किया हो। कभी भी केसवर्क नहीं।
1. अपने एक्सट्रैक्शन से एक फ़िक्स्चर काटें
python admin/test/scripts/make_test_data.py <module> --case 1 --input <extraction.zip>
यह आपके मॉड्यूल के paths पैटर्न से मेल खाने वाली फ़ाइलों को extraction से बाहर निकालता है और
केस फ़ाइल admin/test/cases/testdata.<module>.json के साथ-साथ admin/test/cases/data/<module>/ के अंतर्गत
प्रत्येक artifact के लिए एक छोटी zip लिखता है।
आकार नियम: प्रति zip 10 MB से कम, इसे PR के साथ commit करें। 10 से 25 MB के बीच, केस फ़ाइल commit करें और zip को PR टिप्पणी में संलग्न करें। उससे बड़ा होने पर, PR में इसका उल्लेख करें और एक maintainer handoff की व्यवस्था करेगा।
2. अपेक्षित आउटपुट रिकॉर्ड करें
TZ=UTC python admin/test/scripts/test_module.py <module> -a all -c all
यह मॉड्यूल को fixture के विरुद्ध चलाता है और आउटपुट का एक स्नैपशॉट
admin/test/results/<module>/ के अंतर्गत लिखता है। स्नैपशॉट को भी commit करें। यह वह baseline बन जाता है जो
merge के बाद मॉड्यूल की रक्षा करता है। TZ=UTC भाग को बनाए रखें: committed स्नैपशॉट UTC में हैं
और CI UTC में चलता है।
3. वही तुलना चलाएँ जो CI चलाएगा
python admin/test/scripts/run_test_cases.py --module <module>
4. sample_data मान उत्पन्न करें