डॉकराइज़्ड एंड्रॉइड

डॉकराइज़्ड एंड्रॉइड एक कंटेनर-आधारित ढाँचा है जो डॉकर के अंदर एंड्रॉइड एमुलेटर को चलाने और इसे ब्राउज़र के माध्यम से नियंत्रित करने की अनुमति देता है। यह प्रोजेक्ट साइबर रेंज में मोबाइल सुरक्षा घटकों को एकीकृत करने के लिए एक प्रारंभिक बिंदु प्रदान करने के उद्देश्य से विकसित किया गया है, लेकिन इसका उपयोग किसी भी उद्देश्य के लिए किया जा सकता है। किसी भी मामले में, विकास और परीक्षण उद्देश्यों के लिए सुझाया गया प्रोजेक्ट docker-android है।

विषय सूची

• विषय सूची
• परिचय
• विशेषताएँ
• वास्तुकला
  • मुख्य घटक
  • UI घटक
  • इंस्टेंस प्रबंधक घटक
• डॉकर इमेज की सूची
• कैसे चलाएं
  • पूर्वापेक्षाएँ
  • OS अनुकूलता
  • वास्तविक डिवाइस के लिए OS X वर्कअराउंड
  • चलाएं
  • बनाएं
• कॉन्फ़िगरेशन
• लाइसेंस
• डॉकराइज़्ड एंड्रॉइड के बारे में कौन बात करता है
• श्रेय

परिचय

जैसा कि उपरोक्त संक्षिप्त विवरण में कहा गया है, यह प्रोजेक्ट साइबर रेंज में मोबाइल सुरक्षा घटकों को शामिल करने के लिए एक प्रारंभिक बिंदु प्रदान करने के उद्देश्य से बनाया गया है। इस कारण से, पहले से विकसित की गई सुविधाएँ और भविष्य में जोड़ी जाने वाली सुविधाएँ उपयोगकर्ता को यथार्थवादी सिमुलेशन (उदाहरण के लिए सुरक्षा प्रशिक्षण के लिए) सेट करने में आसान बनाने में मदद करेंगी। यह README काफी लंबा है, शायद आप सीधे "कैसे चलाएं" भाग पर जाना चाहें।

विशेषताएँ

वर्तमान में निम्नलिखित सुविधाएँ उपलब्ध हैं:

• डॉकर में एंड्रॉइड एमुलेटर चलाएं
• वेब ब्राउज़र के माध्यम से डिवाइस को नियंत्रित करें
• एप्लिकेशन इंस्टॉल करें
• पोर्ट फ़ॉरवर्डिंग सक्षम करें
• डिवाइस को रिबूट करें
• SMS का अनुकरण करें
• वेब ब्राउज़र से टर्मिनल का उपयोग करें
• एक भौतिक डिवाइस भी संलग्न करें
• स्टार्टअप व्यवहार को अनुकूलित करें (कॉन्फ़िगरेशन अनुभाग देखें)
• कई इंस्टेंस को आसानी से प्रबंधित करें

वास्तुकला

प्रोजेक्ट तीन मुख्य भागों से बना है:

• डॉकराइज़्ड एंड्रॉइड कोर
• डॉकराइज़्ड एंड्रॉइड UI
• डॉकराइज़्ड एंड्रॉइड इंस्टेंस प्रबंधक (वैकल्पिक) निम्नलिखित आंकड़ा दो अनिवार्य घटकों की वास्तविक वास्तुकला का अवलोकन प्रदान करता है:

मुख्य घटक

मुख्य घटक वह है जो एक डॉकर कंटेनर के अंदर एंड्रॉइड घटक (एमुलेटेड या वास्तविक) को चलाने के लिए आवश्यक सभी प्रक्रियाओं को निष्पादित करता है, साथ ही बाहर की ओर कुछ सुविधाओं को उजागर करता है। यह निस्संदेह सबसे जटिल भाग है क्योंकि इसे सुविधाओं का एक सेट प्रदान करने के लिए विभिन्न प्रक्रियाओं का प्रबंधन करना होता है। उपरोक्त आंकड़ा दीर्घकालिक प्रक्रियाओं, आरंभिक प्रक्रियाओं और उपयोगिता स्क्रिप्ट के बीच एक स्पष्ट अंतर दिखाता है। इसके अलावा, यह आंकड़ा दर्शाता है कि 6 दीर्घकालिक प्रक्रियाएँ हैं, यह मुख्य घटक का सामान्य अवलोकन प्रदान करने के लिए जोड़ी गई एक छोटी अशुद्धि है, वास्तव में मुख्य घटक के दो अलग-अलग स्वाद हैं:

• एमुलेटर के लिए कोर
• वास्तविक डिवाइस के लिए कोर

मुख्य वास्तुशिल्प अंतर दीर्घकालिक प्रक्रियाओं से संबंधित है: एमुलेटर के लिए कोर दीर्घकालिक एमुलेटर प्रक्रिया चलाता है जबकि वास्तविक डिवाइस के लिए कोर भौतिक डिवाइस को प्रदर्शित और नियंत्रित करने के लिए दीर्घकालिक scrcpy प्रक्रिया चलाता है। अन्य भाग काफी समान हैं, बस कोर घटक के प्रकार के आधार पर अलग-अलग व्यवहार का पालन करने के लिए कुछ तर्क के साथ।

UI घटक

UI घटक बैकएंड द्वारा प्रदान की गई सभी सुविधाओं का उपयोग करने का एक सरल तरीका प्रदान करता है और डिवाइस को प्रदर्शित और नियंत्रित करने की क्षमता भी जोड़ता है। उपयोगकर्ता को मैन्युअल रूप से कोर घटक का पता और संबंधित पोर्ट (बैकएंड द्वारा प्रदान किया गया पोर्ट और websockify द्वारा प्रदान किया गया पोर्ट) डालना होता है; इस मैन्युअल सेटअप के माध्यम से डिफ़ॉल्ट पोर्ट (जो बैकएंड के लिए 4242 और websockify के लिए 6080 हैं) को बदलना संभव है।

इंस्टेंस प्रबंधक घटक

इंस्टेंस प्रबंधक घटक का कार्य एक एकल REST API के माध्यम से चल रहे कोर के बारे में सभी जानकारी (यानी, पते और पोर्ट) प्रदान करना है। यह एक सरल JSON कॉन्फ़िगरेशन फ़ाइल लिखकर किया जाता है जिसमें docker-compose में मौजूद सभी कोर के बारे में जानकारी होती है, ताकि एक-एक करके मैन्युअल रूप से जोड़ने के कष्टदायक कार्य से बचा जा सके। JSON कॉन्फ़िगरेशन फ़ाइल की संरचना निम्नलिखित है:

{
    "instances": [
        {
            "name": [डिवाइस की पहचान करने के लिए सामान्य स्ट्रिंग],
            "address": [घटक का पता],
            "core_port": [बैकएंड का पोर्ट],
            "vnc_port": [VNC का पोर्ट]
        }
    ]
}

डॉकर इमेज की सूची

secsi/dockerized-android-core-bare कोई सिस्टम इमेज डाउनलोड नहीं करता है और आप अपने होस्ट मशीन पर वह फ़ोल्डर माउंट कर सकते हैं जहाँ आपके पास सभी SDK फ़ोल्डर हैं।

कैसे चलाएं

प्लेटफ़ॉर्म चलाने का पूरा उदाहरण देखने के लिए आप examples निर्देशिका में उपलब्ध docker-compose देख सकते हैं। इस निर्देशिका में तीन अलग-अलग कॉन्फ़िगरेशन हैं:

• docker-compose-core: एक वास्तविक डिवाइस के लिए एक कोर के साथ सेटअप;
• docker-compose-emulator: एक एमुलेटर के लिए एक कोर के साथ सेटअप;
• docker-compose-instance-manager: दो अलग-अलग कोर और वैकल्पिक इंस्टेंस प्रबंधक घटक के साथ सेटअप।

एक बार जब आप समझ जाते हैं कि यह कैसे काम करता है, तो आप अपनी किसी भी आवश्यकता को पूरा करने के लिए इसे बदल सकते हैं।

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

आपकी मशीन पर Docker और Docker Compose स्थापित होना चाहिए।

OS अनुकूलता

यह प्लेटफ़ॉर्म होस्ट OS के आधार पर अलग-अलग तरीकों से व्यवहार करता है, यहाँ एक तालिका है जो वर्तमान अनुकूलता को सारांशित करती है:

Windows और OS X के लिए आपको नेस्टेड वर्चुअलाइज़ेशन के साथ एक Linux VM का उपयोग करना होगा।

यह जाँचने के लिए कि क्या आपकी Linux मशीन नेस्टेड वर्चुअलाइज़ेशन का समर्थन करती है, आप निम्नलिखित कमांड चला सकते हैं:

sudo apt install cpu-checker
kvm-ok

वास्तविक डिवाइस के लिए OS X वर्कअराउंड

OS X पर वास्तविक डिवाइस के लिए कोर का उपयोग करने के लिए आप:

• होस्ट के adb का उपयोग करें
• वायरलेस कनेक्शन का उपयोग करें

वायरलेस कनेक्शन के लिए Google एक सरल ट्यूटोरियल प्रदान करता है। कंटेनर के अंदर से होस्ट adb से कनेक्ट करने के लिए आपको मैन्युअल रूप से कंटेनर के अंदर प्रवेश करना होगा और चलाना होगा:

adb -H host.docker.internal devices

चलाएं

फ्रेमवर्क का उपयोग शुरू करने के लिए कमांड निम्नानुसार हैं:

1. सबसे पहले, examples फ़ोल्डर में पाई गई एक कॉन्फ़िगरेशन चुनें। उदाहरण के लिए:

cp ./examples/docker-compose-core.yml docker-compose.yml

2. docker-compose के साथ चलाएं:

docker-compose up

अधिक सरलता से आप निम्न कमांड का भी उपयोग कर सकते हैं:

docker-compose -f ./examples/docker-compose-core.yml up

अब केवल ब्राउज़र के माध्यम से निम्नलिखित पते http://127.0.0.1:8080 पर नेविगेट करना और वर्तमान कॉन्फ़िगरेशन सेट करना शेष है:

यदि इंस्टेंस प्रबंधक का उपयोग नहीं किया गया था, तो मैन्युअल सेटअप पर क्लिक करें और निम्नलिखित जानकारी दर्ज करें:

1. इंस्टेंस के लिए आपकी पसंद का एक नाम;
2. docker-compose में घोषित कोर घटक का IP पता;
3. कोर पोर्ट संख्या (4242 डिफ़ॉल्ट);
4. VNC पोर्ट संख्या (6080 डिफ़ॉल्ट)।

यदि इंस्टेंस प्रबंधक का उपयोग किया जाता है, तो "इंस्टेंस प्रबंधक" पर क्लिक करें और केवल IP पता और उसका पोर्ट नंबर (उदाहरण के लिए, 193.21.1.100:7373) दर्ज करें।

बस इतना ही! आप ब्राउज़र के भीतर फ्रेमवर्क का उपयोग कर सकते हैं।

बनाएं

आप utils फ़ोल्डर में रखी स्क्रिप्ट के माध्यम से स्वयं भी इमेज बना सकते हैं।

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

आप ENV वेरिएबल के माध्यम से सेटअप को अनुकूलित करने के लिए कुछ सुविधाओं को कॉन्फ़िगर कर सकते हैं, निम्नलिखित तालिका उन सभी की सूची प्रदान करती है:

REAL_DEVICE_SERIAL वेरिएबल महत्वपूर्ण है यदि एक से अधिक भौतिक डिवाइस जुड़े हैं क्योंकि यदि यह गायब है तो कुछ भी काम नहीं करेगा। अंत में प्रत्येक घटक द्वारा उजागर किए गए पोर्ट की एक सूची है:

लाइसेंस

डॉकराइज़्ड एंड्रॉइड एक ओपन-सोर्स और मुफ्त सॉफ्टवेयर है जो MIT लाइसेंस के तहत जारी किया गया है।

डॉकराइज़्ड एंड्रॉइड के बारे में कौन बात करता है

• SecSI
  • https://secsi.io/blog/a-container-based-framework-for-android-emulation-and-hacking/
• KitPloit
  • https://www.kitploit.com/2021/10/dockerized-android-container-based.html
  • https://www.kitploit.com/2021/12/top-20-most-popular-hacking-tools-in.html

उद्धरण

यदि आप इस कोड को अपने शोध में उपयोगी पाते हैं, तो कृपया हमारे पेपर का हवाला देने पर विचार करें:

@inproceedings{Capone2022,
  doi = {10.1109/icecet55527.2022.9872834},
  url = {https://doi.org/10.1109/icecet55527.2022.9872834},
  year = {2022},
  month = jul,
  publisher = {{IEEE}},
  author = {Daniele Capone and Francesco Caturano and Angelo Delicato and Gaetano Perrone and Simon Pietro Romano},
  title = {Dockerized Android: a container-based platform to build mobile Android scenarios for Cyber Ranges},
  booktitle = {2022 International Conference on Electrical,  Computer and Energy Technologies ({ICECET})}
}

श्रेय

यह प्रोजेक्ट नेपल्स के फेडेरिको II विश्वविद्यालय में कंप्यूटर इंजीनियरिंग में हमारी मास्टर थीसिस का प्रतिनिधित्व करता है। प्रोफेसर Simon Pietro Romano और इंजीनियर Francesco Caturano को विशेष धन्यवाद, जो इस कार्य के लिए प्रेरणा स्रोत हैं।