सेलफिश ओएस के लिए कॉन्टिनेंट-एपी वीपीएन प्लगइन का विकास

परिचय

मैं सिक्योरिटी कोड कंपनी के मोबाइल प्लेटफार्मों के लिए सुरक्षा उपकरणों के विकास और परीक्षण विभाग में एक प्रोग्रामर के रूप में काम करता हूं। मोबाइल डेवलपमेंट टीम को सब्सक्राइबर स्टेशन के कॉन्टिनेंट-एपी क्रॉस-प्लेटफॉर्म लाइब्रेरी को पोर्ट करने का काम सौंपा गया था, जो पहले ही IOS और Android पर सफलतापूर्वक संचालित हो चुका था। मुख्य समस्या यह थी कि सेलफ़िश ओएस एंड्रॉइड या आईओएस के रूप में अच्छी तरह से प्रलेखित नहीं है, लेकिन ओपन मोबाइल प्लेटफ़ॉर्म से उन लोगों के लिए धन्यवाद जिन्होंने प्रलेखन साझा किया था।

सेलफ़िश ओएस में वीपीएन एपीआई वास्तुकला

सेलफ़िश ओएस में सभी नेटवर्क कनेक्शन के लिए, कनेक्टमैन सेवा जिम्मेदार है, अर्थात्:

• वाई-फाई नेटवर्क और सेलुलर नेटवर्क स्कैन करें और उनसे कनेक्ट करें;
• साझाकरण कनेक्शन (वाई-फाई हॉटस्पॉट);
• उड़ान मोड में अनुवाद, आउटपुट कनेक्शन;
• वीपीएन कनेक्शन प्रबंधन।

मैं अंतिम बिंदु के बारे में अधिक विस्तार से बात करूंगा। कोनमैन में कई प्रकार के पूर्वनिर्धारित वीपीएन प्लगइन्स होते हैं। कनेक्शन बनाने और कॉन्फ़िगर करने के लिए QML विजेट्स को फर्मवेयर में एकीकृत किया गया है।


अंजीर। वीपीएन कनेक्शन को कॉन्फ़िगर करने और प्रबंधित करने के लिए 1 सेलफ़िश ओएस सिस्टम मेनू

हमारे वीपीएन क्लाइंट का यूआई एक आरपीएम पैकेज है और स्थापना के दौरान यह वीपीएन सिस्टम विंडो को सेटिंग्स सेक्शन में एकीकृत नहीं करता है, बल्कि एक अलग एप्लिकेशन की तरह दिखता है। यूआई के विकास पर शायद एक अलग लेख होगा, इसलिए अगली कहानी सी / सी ++ में कॉनमैन प्लगइन के विकास के बारे में होगी।


अंजीर। सेलफिश द्वारा 2 महाद्वीप-एपी जीयूआई

सेलफ़िश ओएस के वीपीएन-एपी में निम्नलिखित घटक होते हैं, हम अपने वीपीएन क्लाइंट के उदाहरण द्वारा दिखाएंगे:

1. कॉनमैन वह प्रक्रिया है जो सेलफ़िश ओएस शुरू होने पर शुरू होती है।
2. कॉनमैन-वीपीएन, कॉनमैन द्वारा शुरू की गई एक डेमन प्रक्रिया है और इसका उपयोग विभिन्न प्रदाताओं के वीपीएन कनेक्शन को प्रबंधित करने और ट्यून इंटरफ़ेस को इनिशियलाइज़ करने और डी-इनिशियलाइज़ करने के लिए किया जाता है, और इसके लिए डीबीस के माध्यम से प्राप्त नेटवर्क सेटिंग्स (आईपी एड्रेस, रूट्स, डीएनएस सर्वर) को असाइन किया जाता है। हमारे मामले में, एक प्रदाता जिसका नाम महाद्वीप है।
3. महाद्वीप-proto-plugin.so वीपीएन प्लगइन एक पुस्तकालय है जिसमें रनटाइम और फ़ंक्शंस में लोड करने के लिए मैक्रो घोषणा होती है, जिसे नेट.कॉन्मन.वीपीएन.कॉन्नेनेशन इंटरफ़ेस विधियों कहा जाता है।
4. पृष्ठभूमि एप्लिकेशन (बाइनरी फ़ाइल / यूएसआर / एसबीएन / महाद्वीप) सीडी (कॉन्टिनेंट एक्सेस सर्वर) से कनेक्ट करने के लिए एक कंसोल क्लाइंट है, जिससे इसे नेटवर्क सेटिंग्स प्राप्त होती हैं, जो इसे कॉनमैन-वीपीएनडी से गुजरती हैं।
5. कॉनमैन टास्क एक रनिंग कंसोल क्लाइंट को शुरू करने, रोकने और निगरानी करने के लिए एक प्रक्रिया है।
6. DBus-api - connman-vpnd का प्रतिनिधित्व करता है, अर्थात् net.connman.vpn इंटरफेस के साथ net.connman.vpn.Manager, net.connman.vpn.Connection।

अंजीर। 3 "कॉन्टिनेंट-एपी" सेलफ़िश में घटकों की आपस में बातचीत

वीपीएन प्लगइन

कॉनमैन वितरण में शामिल सभी तृतीय-पक्ष प्लगइन्स लाइब्रेरी का प्रतिनिधित्व नहीं करते हैं और पैकेज प्रबंधक के माध्यम से इंस्टॉल करते समय / usr / lib / connman / plugins-vpn में रखा जाना चाहिए।

एक प्लगइन में एक कॉन्फ़िगरेशन फ़ाइल हो सकती है, जिसमें हम इंगित करते हैं कि किस उपयोगकर्ता को द्विआधारी फ़ाइल को चलाना और उसके अधिकारों को लिखना है। फ़ाइल को पथ /etc/connman/vpn-plugin/continent.conf के साथ सिस्टम में स्थित होना चाहिए, और इसका नाम हमारे प्रदाता के नाम के अनुरूप होना चाहिए, हमारे मामले में महाद्वीप .conf।

उदाहरण के लिए फ़ाइल सामग्री:

[VPN Binary] User = nemo Group = vpn SupplementaryGroups = inet,net_admin 

कॉनमैन में प्लगइन महाद्वीप-proto-plugin.so मैक्रो CONNMAN_PLUGIN_DEFINE (नाम, विवरण, संस्करण, init, निकास) का उपयोग करके पंजीकृत है, हमारे उदाहरण में, मैक्रो कॉल इस तरह दिखेगा:

 CONNMAN_PLUGIN_DEFINE(continent, "continent VPN plugin", CONNMAN_VERSION, CONNMAN_PLUGIN_PRIORITY_DEFAULT, continent_init, continent_exit); 

नाम (महाद्वीप) तर्क को उद्धरण चिह्नों के बिना होना चाहिए। कॉन्टिनेंट_इनिट, कॉन्टेंट_एक्सिट फ़ंक्शंस तब कहलाते हैं जब प्लग को लोड और अनलोड किया जाता है, उदाहरण के लिए, जब सिस्टममार्ट रिस्टार्ट कॉनमैन को आरपीएम इंस्टॉलेशन के दौरान कहा जाता है। महाद्वीप_init फ़ंक्शन के पास vpn_register और connman_dbus_get_connection फ़ंक्शन के लिए कॉल है।

 vpn_register(name, driver, binary_path) 

नाम - प्रदाता का नाम पंजीकृत किया जा रहा है, हमारे मामले में यह "महाद्वीप" है;
ड्राइवर - संरचनात्मक vpn_driver संरचना जिसमें कॉलबैक फ़ंक्शंस होते हैं, उदाहरण के लिए, जब DBus के माध्यम से प्लगइन तक पहुंच;
बाइनरी_पथ - बाइनरी फ़ाइल का पथ, हमारे मामले में यह "/ usr / sbin / महाद्वीप" है।

Conman_dbus_get_connection फ़ंक्शन आपको स्थापित DBus कनेक्शन, DBusConnection * कनेक्शन प्राप्त करने की अनुमति देता है।

कॉनमैन में प्लगइन को अपंजीकृत करने और डीबस कनेक्शन को बंद करने के लिए कॉन्टेंट_एक्सिट फ़ंक्शन की आवश्यकता है।

एक वीपीएन प्रदाता का उदाहरण तब बनाया जाता है जब DBus net.connman.vpn.Manager.Create विधि को कॉल करता है, इसके लिए /var/lib/connman/provider_$endersHasasket_ministrVPN.Domain} निर्देशिका में एक सेटिंग फ़ाइल स्वचालित रूप से बनाई जाती है। प्रदाता को net.connman.vpn.Manager.Remove पर कॉल करके हटा दिया जाता है। जब net.connman.vpn.Connection.Connect विधि को कॉल किया जाता है, तो सेटिंग्स को बनाए गए स्ट्रक्चर vpn_provider * प्रदाता में लोड किया जाता है।

मैं संरचना vpn_driver में कुछ कार्यों के बारे में बात करना चाहूंगा, उनमें से कुछ को कार्यान्वयन के लिए आवश्यक है।

कनेक्ट - कॉलबैक, जिसे नेट कहा जाता है ।connman.vpn.Connection.Connect DBus के माध्यम से DBus ऑब्जेक्ट के संबंधित पते के साथ कहा जाता है, पर हस्ताक्षर हैं:

 static int continent_connect( struct vpn_provider *provider, struct connman_task *task, const char *if_name, vpn_provider_connect_cb_t cb, const char *dbus_sender, void *user_data) 

इस कॉलबैक के लिए दूसरा तर्क एक स्ट्रक्चरल कॉनमैन_टस्क * टास्क है, यह बाइनरी फाइल को रन करेगा, लेकिन आपको शुरू करने से पहले तर्क पास करना होगा, उदाहरण के लिए, सर्वर होस्ट और पोर्ट:

 connman_task_add_argument(task, "--host", value); connman_task_add_argument(task, "--port", value); 

हम प्रदाता ऑब्जेक्ट उदाहरण की कॉन्फ़िगरेशन फ़ाइल में कुछ मापदंडों को संग्रहीत करते हैं, यह ऊपर वर्णित था, और हम इसे उदाहरण के लिए vpn_provider_get_string फ़ंक्शन को कॉल करके प्राप्त करते हैं:

 char * value = vpn_provider_get_string(provider , “Host”) 

जहां प्रदाता एक संरचना vpn_provider का उदाहरण है।

 connman_task_add_argument(task, "--dev-name", if_name). 

ऊपर दी गई रेखा उस वर्चुअल इंटरफ़ेस के नाम को दर्शाती है, जो कि CONMan-vpnd इनिशियलाइज़ करता है और वीपीएन प्रदाता के वर्तमान उदाहरण के लिए उठाए गए TUN इंटरफ़ेस उदाहरण से IP पैकेट को पढ़ने और लिखने के लिए प्रदान करता है। पृष्ठभूमि प्रक्रिया में, यह हमारे लिए डिवाइस को खोलने और पढ़ने / लिखने के लिए एक फ़ाइल विवरणक प्राप्त करने के लिए बना रहता है।

एक संक्षिप्त टिप्पणी: प्लगइन के विकास के दौरान यह पता चला कि TUN इंटरफ़ेस को डिफ़ॉल्ट मार्ग इंटरफ़ेस के रूप में उठाया गया है।

 connman_task_add_argument(task, "--dbus-busname", dbus_bus_get_unique_name(connection)); connman_task_add_argument(task, "--dbus-interface", CONNMAN_TASK_INTERFACE); connman_task_add_argument(task, "--dbus-path", connman_task_get_path(task)); 

बैकग्राउंड एप्लिकेशन और वीपीएन प्लगइन के बीच फीडबैक के लिए, हम कॉनमैनटैस्क डीबस एड्रेस और वर्तमान उदाहरण के लिए रास्ता पास करते हैं, इसके लिए हमें इनिशियलाइज़ेशन फंक्शन में conman_dbus_get_connection को कॉल करना होगा।

हम पृष्ठभूमि प्रक्रिया शुरू करते हैं:

 err = connman_task_run(task, continent_died, data, &data->stdin_fd, NULL, NULL); 

Continent_died - कॉलबैक जिसे बैकग्राउंड प्रोसेस समाप्त होने पर कॉल किया जाता है। इसमें, हम प्रक्रिया को समाप्त करने के लिए त्रुटि कोड का पता लगाते हैं, मेमोरी को तैनात करते हैं, अतिरिक्त मार्गों को हटाते हैं।

सूचित करें - कॉलबैक, जिसे net.connman.Task.notify कहा जाता है, इसे DBus के माध्यम से कहा जाता है, इसमें हमें एक रनिंग बैकग्राउंड एप्लिकेशन से DBus संदेश मिलते हैं। मुख्य बात नेटवर्क मापदंडों का प्रसारण है: टीयूएन इंटरफ़ेस का पता, वर्चुअल नेटवर्क में डीएनएस सर्वर आदि। नेटवर्क मापदंडों को डिबस के रूप में DBusMessage में पैक किया जाता है और कॉनमैन टास्क में स्थानांतरित किया जाता है, जिसमें बैकग्राउंड एप्लिकेशन लॉन्च होने पर Dbus पैरामीटर भेजे जाते हैं।

सूचना फ़ंक्शन में TUN इंटरफ़ेस को प्रारंभ करने का एक उदाहरण:

 struct connman_ipaddress * ipaddress = connman_ipaddress_alloc(AF_INET); connman_ipaddress_set_ipv4(ipaddress, address, netmask, remote_server_ip); connman_ipaddress_set_peer(ipaddress, peer); vpn_provider_set_ipaddress(provider, ipaddress); vpn_provider_set_nameservers(provider, “8.8.8.8”); return VPN_STATE_CONNECT; 

हम मध्यवर्ती मान भी पास करते हैं, उदाहरण के लिए, यदि हम वर्तमान कनेक्शन के गुणों को लिखकर घटना के UI को सूचित करना चाहते हैं, जो UI नेट से सीख सकते हैं। (प्रदाता, कुंजी, मूल्य)।

डिस्कनेक्ट - कॉलबैक जिसे नेट कहा जाता है ।connman.vpn.Connection.Disconnect को DBus के माध्यम से कहा जाता है
रोक प्रक्रिया एक SIGTERM सिग्नल भेजकर होती है, यदि 3 सेकंड के भीतर कोई डिस्कनेक्ट नहीं होता है, तो SIGKILL सिग्नल भेजा जाता है।

वीपीएन प्लगइन का विकास और डिबगिंग

कॉन्टिनेंट-एपी वीपीएन प्लग-इन और इसके घटकों की असेंबली सेलफ़िश बिल्ड इंजन ओएस वर्चुअल मशीन (वर्चुअल बॉक्स) पर की जाती है, जो सेलफ़िश एसडीके का हिस्सा है। प्लगइन का निर्माण करने के लिए, आपको पुस्तकालयों की आवश्यकता है: कॉनमैन-डेवेल, डबस -1, ग्लिब्स -2.0, जिसे हम ssh के माध्यम से लॉग इन करके स्थापित करते हैं:

 ssh -p 2222 -i ~/SailfishOS/vmshare/ssh/private_keys/engine/mersdk mersdk@localhost 

हम क्रॉस-संकलन के लिए एसबी 2 उपयोगिता (स्क्रैचबॉक्स 2) - टूलकिट का उपयोग करते हैं। हम i486 और armv7hl प्लेटफार्मों के लिए आवश्यक पैकेज स्थापित करते हैं:

 sb2 -t SailfishOS-3.0.1.11-i486 -m sdk-install -R zypper -n in cmake patchelf chrpath connman-devel systemd-compat-libs systemd-devel 

 sb2 -t SailfishOS-3.0.1.11-armv7hl -m sdk-install -R zypper -n in cmake patchelf chrpath connman-devel systemd-compat-libs systemd-devel 

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

हम sb2 sdk-build के माध्यम से वीपीएन प्लगइन और उसके घटकों की असेंबली शुरू करते हैं:

 sb2 -t SailfishOS-3.0.1.11-armv7hl -m sdk-build cmake . && make sb2 -t SailfishOS-3.0.1.11-i486 -m sdk-build cmake . && make 

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

 %files %defattr(-,root,root,-) %{_sbindir}/continent %{_libdir}/connman/plugins-vpn/continent-proto-plugin.so 

प्लग-इन को एमुलेटर पर यूआई से अलग से विकसित किया गया था, जो सेलफिश एसडीके का हिस्सा है, और निरंतर लॉग आउटपुट मोड में -f विकल्प के साथ जीडीबस और जर्नलक्ट ने डिबगिंग टूल के रूप में बहुत मदद की।

उदाहरण के लिए, gdbus का उपयोग करके प्रदाता का एक उदाहरण बनाना:

 gdbus call --system --dest=net.connman.vpn --object-path / --method net.connman.vpn.Manager.Create "{ 'Type': <'continent'>, … }" 

परीक्षण उपकरण INOI R7 (फोन), INOI T8 (टैबलेट) और वर्चुअलबॉक्स पर आधारित एक एमुलेटर थे

उपयोगी लिंक:

1. सेलफ़िश के लिए अनुकूलित कॉनमैन स्रोत कोड यहां पाया जा सकता है ।
2. कंकाल - प्लगइन परियोजना
3. sailfishos.org/wiki