VSCode के लिए Frida Workbench

Repository | Issues | Install

यह एक समुदाय द्वारा योगदान किया गया प्रोजेक्ट है, जो आधिकारिक Frida टीम से संबद्ध नहीं है। इसे @CodeColorist द्वारा Visual Studio Code के लिए एक ओपन-सोर्स एक्सटेंशन के रूप में विकसित और अनुरक्षित किया जाता है, जिसका उद्देश्य Frida स्क्रिप्टिंग अनुभव को बेहतर बनाना है।

中文说明

पूर्वापेक्षाएँ

• Python >= 3.7
• frida-tools python पैकेज

वैकल्पिक निर्भरताएँ

• libimobiledevice (inetcat कमांड से SSH शेल शुरू करने के लिए)
• Windows पर iTunes (iOS USB कनेक्शन के लिए)

यदि आप Windows पर हैं, तो USB के माध्यम से iOS डिवाइस के साथ इंटरैक्ट करने के लिए आपको iTunes खुला रखना होगा।

frida-tools इंस्टॉल करें

PEP0668 के कारण, ग्लोबली pip3 install frida-tools चलाते समय आपको त्रुटि मिल सकती है।

अनुशंसित तरीका यह है कि VSCode में एक फ़ोल्डर (वर्कस्पेस) खोलें, फिर Python एक्सटेंशन का उपयोग करके एक वर्चुअल एनवायरनमेंट बनाएँ और सक्रिय करें। इस स्थिति में, एक्सटेंशन frida कमांड लोड करने के लिए आपके वर्तमान सक्रिय Python venv का उपयोग करेगा।

वैकल्पिक रूप से, आप pipx या UV जैसे पैकेज मैनेजर का उपयोग करके इसे $PATH में इंस्टॉल कर सकते हैं, जबकि इसे अलग-थलग रख सकते हैं।

विशेषताएँ

ऐप्स और प्रोसेस सूची

साइडबार पैनल में कनेक्टेड डिवाइस पर ऐप्स और प्रोसेस की सूची देखें। अटैच करने, लोकल टारगेट के लिए एलिवेटेड प्रिविलेज के साथ अटैच करने, स्पॉन करने, सस्पेंडेड मोड में स्पॉन करने, प्रोसेस को किल करने, या डिवाइस/प्रोसेस जानकारी क्लिपबोर्ड पर कॉपी करने के लिए राइट-क्लिक करें। लोकल, Apple Simulator, USB, और रिमोट डिवाइस का समर्थन करता है। लोकल प्रोसेस प्रविष्टियों में उपलब्ध होने पर executable path, owner, parent PID, और arguments जैसे best-effort मेटाडेटा शामिल होते हैं।

इंटरैक्टिव रनटाइम पैनल

मॉड्यूल और एक्सपोर्ट ब्राउज़र

किसी भी अटैच किए गए प्रोसेस के लिए लोड किए गए नेटिव मॉड्यूल और उनके एक्सपोर्ट किए गए फंक्शन ब्राउज़ करें। नाम से मॉड्यूल फ़िल्टर करें, बेस एड्रेस, साइज़, और पाथ का निरीक्षण करें, फिर हुक जनरेशन के लिए एक्सपोर्ट चुनें।

क्लासेस और मेथड्स ब्राउज़र

Java और Objective-C दोनों के लिए रनटाइम क्लासेस और मेथड्स का अन्वेषण करें। क्लासेस फ़िल्टर करें, own और inherited मेथड्स के बीच टॉगल करें, और हुक जनरेशन के लिए मेथड्स को बैच-सेलेक्ट करें। इसमें Objective-C प्रोटोकॉल निरीक्षण भी शामिल है, जो प्रोटोकॉल को ब्राउज़ और विश्लेषण करने के लिए है।

हेडर जनरेट करें

रिवर्स इंजीनियरिंग के लिए क्लास हेडर डंप करें:

• Objective-C — रनटाइम क्लास मेटाडेटा से हेडर फ़ाइलें जनरेट करें
• Java — पैकेज और इम्पोर्ट स्टेटमेंट के साथ डीकंपाइल किए गए क्लास स्टब्स जनरेट करें

हुक जनरेशन

Modules और Classes पैनल से Frida हुक कोड जनरेट करें:

• नेटिव हुक — एक्सपोर्ट किए गए फंक्शन के लिए onEnter / onLeave कॉलबैक के साथ Interceptor.attach()
• Objective-C हुक — उचित ObjC ब्रिज उपयोग के साथ क्लास और सेलेक्टर आधारित हुक
• Java हुक — मेथड ओवरलोड समर्थन के साथ Java.perform() / Java.use() हुक
• AI-संचालित हुक — नेटिव फंक्शन सिग्नेचर (पैरामीटर प्रकार, रिटर्न प्रकार) का अनुमान लगाने और टाइप-अवेयर आर्गुमेंट लॉगिंग जनरेट करने के लिए GitHub Copilot का उपयोग करें

स्मार्ट ऑटोकम्पलीट (LSP)

JavaScript / TypeScript में Frida स्क्रिप्ट के लिए कॉन्टेक्स्ट-अवेयर कम्पलीशन:

• ObjC.classes.<ClassName> — Objective-C क्लास नाम पूर्ण करता है
• ObjC.classes.Foo['<method>'] — मेथड सेलेक्टर पूर्ण करता है
• ObjC.classes.Foo.method — क्लास मेथड सेलेक्टर पूर्ण करता है
• Java.use('<ClassName>') — Java क्लास नाम पूर्ण करता है
• Process.getModuleByName('<name>') — लोड किए गए मॉड्यूल नाम पूर्ण करता है

लैंग्वेज सर्वर एक टारगेट प्रोसेस कॉन्टेक्स्ट पर निर्भर करता है। आपको अपने वर्कस्पेस में एक कॉन्फ़िगरेशन फ़ाइल .vscode/frida.json बनानी होगी। सबसे आसान तरीका है साइडबार में किसी प्रोसेस या ऐप पर राइट-क्लिक करें और Set LSP Target चुनें, जो फ़ाइल को स्वचालित रूप से जनरेट करता है।

.vscode/frida.json कॉन्फ़िगरेशन

यह फ़ाइल निर्दिष्ट करती है कि LSP को किस डिवाइस और टारगेट से अटैच होना चाहिए। इसमें एक device फ़ील्ड और app, pid, या process में से ठीक एक की आवश्यकता होती है।

ऐप आइडेंटिफायर से अटैच करें (अनुशंसित — ऐप को स्पॉन या अटैच करता है):

{
    "device": "local",
    "app": "com.example.myapp"
}

प्रोसेस नाम से अटैच करें:

{
    "device": "local",
    "process": "myprocess"
}

PID से अटैच करें (उपयोगी जब कई प्रोसेस एक ही नाम साझा करते हैं):

{
    "device": "local",
    "pid": 1234
}

device मान Frida डिवाइस ID से मेल खाता है — होस्ट मशीन के लिए local, एक Simulator या USB डिवाइस ID, या रिमोट डिवाइस के लिए host:port स्ट्रिंग।

LSP इस फ़ाइल में परिवर्तनों को देखता है। इसे संपादित करने या फिर से बनाने पर लैंग्वेज सर्वर स्वचालित रूप से नए टारगेट के साथ पुनः आरंभ हो जाता है।

Syslog

अटैच किए गए प्रोसेस से रीयल-टाइम एप्लिकेशन लॉग स्ट्रीम करें।

प्रोजेक्ट स्कैफोल्डिंग

• New Agent — TypeScript समर्थन के साथ एक नया Frida Agent प्रोजेक्ट बनाएँ
• New C Module — एक नया Frida C Module प्रोजेक्ट बनाएँ
• Download Typings — ऑटोकम्पलीट के लिए Frida TypeScript टाइप परिभाषाएँ डाउनलोड करें

डीबग कॉन्फ़िगरेशन

ब्रेकपॉइंट के साथ Frida स्क्रिप्ट डीबग करने के लिए VSCode launch.json और tasks.json जनरेट करें।

Android टूल्स

• Android डिवाइस पर frida-server डाउनलोड और शुरू करें (स्वचालित आर्किटेक्चर डिटेक्शन)
• डिवाइस से APK पुल करें (पुल करने के लिए Android ऐप पर राइट-क्लिक करें)

बाहरी टूल्स एकीकरण

• Objection — रनटाइम मोबाइल एक्सप्लोरेशन

शेल

Android डिवाइस के लिए, Open Shell adb shell का रैपर है।

iOS के लिए यह जेलब्रोकन डिवाइस पर SSH शेल देता है। क्रेडेंशियल कॉन्फ़िगर करने की आवश्यकता हो सकती है।

रिमोट डिवाइस समर्थन

साइडबार से सीधे host:port के माध्यम से रिमोट Frida डिवाइस से कनेक्ट करें।

CHANGELOG

योगदानकर्ता