CommuniGate प्रो एकीकृत संचार सर्वर एपीआई

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

संचार के मामले में, यह आमतौर पर सुरक्षा, कर्मचारियों की निगरानी और आंकड़ों को इकट्ठा करने के उद्देश्य के लिए, एक नियम के रूप में, पत्राचार, कॉल और संदेशों के अतिरिक्त प्रसंस्करण की आवश्यकता से पूरक होता है।

इस लेख में, हम उस टूलकिट को देखेंगे जो कम्युनिजीट प्रो सर्वर के लिए है

• स्वचालित प्रशासनिक कार्य
• पत्र और कॉल को संसाधित करना
• तृतीय-पक्ष प्रोग्राम और स्क्रिप्ट के कनेक्शन
• HTML इंटरफेस का निर्माण
• विभिन्न प्लेटफार्मों पर यूसी ग्राहकों और उपयोगिताओं का निर्माण

CLI

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

Poppwd एक्सेस

सर्वर में सीएलआई तक पहुंचने के कई तरीके हैं। कमांड से परिचित करने के लिए सबसे सुविधाजनक में से एक पीडब्ल्यूडी मॉड्यूल माना जा सकता है। एक मानक सर्वर विन्यास के साथ, OS के कमांड लाइन में "telnet server.address 8106" (या OS और संस्करण के आधार पर "telnet server.address 106" टाइप करें)। प्रारंभ में, यह मॉड्यूल केवल पासवर्ड परिवर्तन प्रोटोकॉल का कार्यान्वयन था - poppwd:

$ telnet localhost 8106 Trying 127.0.0.1... Connected to localhost. Escape character is '^]'. 200 mymac.ru CommuniGate Pro PWD Server 6.0.5 ready <1.1381912847@mymac.ru> user postmaster 300 please send the PASS pass ****** 200 login OK, proceed newpass ****** 200 Password updated 

लेकिन एक पाठ कमांड पर रहने का कोई कारण नहीं है:

 listdomains 200 data follow (mymac.ru) listaccounts mymac.ru 200 data follow { pbx = macnt; postmaster = macnt; user1 = macnt; user2 = macnt; } 

इस उत्तर में macnt शब्द का अर्थ है मल्टी-मेलबॉक्स खाता

HTTP का उपयोग

CLI कमांड को "कमांड" पैरामीटर के साथ एक साधारण POST या GET अनुरोध भेजकर भी निष्पादित किया जा सकता है। server.name: Ishttp port] / CLI /।

bibilioteki

चूंकि नंगे पाठ का उपयोग व्यावहारिक कार्यों के लिए बहुत सुविधाजनक नहीं है, इसलिए हमने सीएलआई के साथ काम करने के लिए पर्ल और जावा लाइब्रेरी का निर्माण किया।

हमारी वेबसाइट पर एक विशेष खंड है जहां अक्सर सामना किए गए कार्यों को हल करने के लिए सीएलआई स्क्रिप्ट उदाहरण प्रदान किए जाते हैं।

CLI कमांड को XIMSS प्रोटोकॉल (cliExecute कमांड) और CG / PL प्रोग्राम (ExecuteCLI () फ़ंक्शन) में भी निष्पादित किया जा सकता है, जिसके बारे में हम संबंधित अनुभागों में चर्चा करेंगे।

पोस्टल और सिग्नलिंग नियम

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

कम्युनिटिग प्रो में सिग्नल विशेष ऑब्जेक्ट हैं जो रियल-टाइम संचार में उपयोग किए जाते हैं। एक सिग्नल वास्तविक समय के संचार की एक इकाई है। विभिन्न प्रतिभागियों (एसआईपी, एक्सएमपीपी क्लाइंट, पीबीएक्स एप्लिकेशन, ...) संवाद और अन्य कार्यों की स्थिति को व्यवस्थित करने, तोड़ने और अपडेट करने के लिए एक-दूसरे को संकेत भेजते हैं।

नियम कैसे काम करते हैं

नियमों को तीन स्तरों में विभाजित किया जाता है - सर्वर, डोमेन और खाता (खाता) स्तर। इनमें से प्रत्येक स्तर पर, संकेतों के लिए और मेल के लिए अलग-अलग नियम हैं।

प्रत्येक नियम का एक नाम और प्राथमिकता होती है, सिग्नल नियमों में "जब" स्थिति होती है। उच्च प्राथमिकता, पहले वाली शेष शर्तों के तहत, नियम काम करेगा। "जब" स्थिति यह निर्धारित करती है कि नियम किस पल में काम करेगा - किस सेकंड में सिग्नल संसाधित होता है या जब एक निश्चित कोड के साथ कोई त्रुटि होती है (जवाब नहीं देता, व्यस्त या अन्य त्रुटियां होती हैं):





मेल संदेशों को संसाधित करने की प्रक्रिया:

• सभी सर्वर नियम लागू होते हैं
• वे पत्र जो रूटिंग के परिणामस्वरूप स्थानीय खातों में डोमेन नियमों और नियमों द्वारा संसाधित किए जाते हैं, वे निम्नानुसार हैं:
  
  • प्राथमिकता> 5 के साथ डोमेन नियम
  • खाता नियम
  • प्राथमिकता के साथ डोमेन नियम <= 5
  
  

सिग्नल प्रोसेसिंग ऑर्डर:

• सर्वर सिग्नलिंग नियम एक खाली "कब" फ़ील्ड के साथ लागू होते हैं (इसका मतलब है कि वे तुरंत लागू होते हैं)
• वे संकेत जो रूटिंग के परिणामस्वरूप स्थानीय खातों में शेष सर्वर नियमों (जब खाली फ़ील्ड नहीं है), डोमेन नियमों और नियमों के अनुसार संसाधित होते हैं:
  
  • प्राथमिकता> 5 के साथ सर्वर नियम
  • प्राथमिकता> 5 के साथ डोमेन नियम
  • खाता नियम
  • प्राथमिकता के साथ डोमेन नियम <= 5
  • प्राथमिकता के साथ सर्वर नियम <= 5
  
  

उपयोग के उदाहरण

डोमेन अग्रेषण प्रतिबंध:

विशिष्ट डोमेन के बाहर प्राप्तकर्ताओं के साथ सभी कॉल निर्दिष्ट पते पर पुनर्निर्देशित किए जाते हैं:

सहायक

कम्युनिस्ट प्रो हेल्पर प्रोटोकॉल को लागू करता है, जो आपको विभिन्न कार्यों के लिए सर्वर पर बाहरी कार्यक्रमों का उपयोग करने की अनुमति देता है।

कुछ शर्तों के तहत, उदाहरण के लिए, एक मेल नियम एक संदेश के लिए एक फ़िल्टर शुरू करता है जो प्रक्रियाओं या बाहरी प्रमाणीकरण डोमेन में ट्रिगर होता है, सर्वर हेल्पर प्रोग्राम शुरू करता है। उसके बाद, यह हेल्पर प्रोटोकॉल कमांड भेजने के लिए मानक इनपुट के माध्यम से शुरू होता है और मानक आउटपुट से प्रतिक्रियाओं को पढ़ता है।

एक सहायक प्रोटोकॉल के लिए कुछ सामान्यीकृत सत्र का उदाहरण (I - कार्यक्रम में इनपुट, ओ - आउटपुट):

 O: * My Helper program started I: 00001 INTF 1 O: 00001 INTF 1 I: 00002 COMMAND parameters O: 00002 OK I: 00003 COMMAND parameters I: 00004 COMMAND parameters O: * processing 00003 will take some time O: 00004 ERROR description O: 00003 OK I: 00005 QUIT O: * processed: 5 requests. Quitting. O: 00005 OK 

यहां, INTF कमांड प्रोटोकॉल संस्करण को सहमत करता है, और QUIT सत्र समाप्त होता है, * एक सूचनात्मक संदेश है, जिसके लिए सर्वर प्रतिक्रिया नहीं देता है, लेकिन लॉग को लिखता है।

इस प्रोटोकॉल के तहत, और अधिक विशिष्ट लोगों के लिए विकसित किया गया है:

• शरीर प्रसंस्करण पत्र
• बाहरी प्रमाणीकरण
• बैनर सिस्टम कनेक्शन
• प्रमाणीकरण के लिए RADIUS अनुरोध जोड़ना
• क्लस्टर लोड संतुलन प्रबंधन

ये सभी सेटिंग-> जनरल-> हेल्पर्स वेबएडमिन इंटरफेस पेज पर जुड़े हुए हैं।

निष्पादन योग्य फ़ाइलों के सभी पथ कम्युनिटाइज़ प्रो बेस डायरेक्टरी (उपयोगकर्ता डेटा के साथ एक निर्देशिका) से गिने जाते हैं।

शरीर प्रसंस्करण पत्र

मेल संचालकों को मेल नियम द्वारा ट्रिगर किया जाता है, उदाहरण के लिए इस तरह:



इस और अन्य सहायकों के आदेशों का विस्तृत विवरण मैनुअल में पाया जा सकता है। लेख केवल एक सामान्य विवरण प्रदान करेगा।

इस प्रकार के सहायकों का उपयोग मुख्य रूप से एंटी-वायरस और एंटी-स्पैम इंजन को CGPro से जोड़ने के लिए किया जाता है।

बाहरी प्रमाणीकरण

बाहरी प्रमाणीकरण के लिए सहायक प्रोटोकॉल आमतौर पर उपयोग किया जाता है यदि:

• हमें एक प्रमाणीकरण विधि की आवश्यकता है जो सीधे सर्वर द्वारा समर्थित नहीं है
• कुछ खाते दूसरी प्रणाली पर स्थित हैं (उदाहरण के लिए, AD)
• जटिल रूटिंग की आवश्यकता है
• सेवाओं की खाता सेटिंग के लिए बाहरी प्रबंधन की आवश्यकता है

इस प्रकार के सहायकों के उदाहरण इस पृष्ठ पर देखे जा सकते हैं।

अन्य सहायक

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

WSSP

WSSP (वेब ​​सर्वर-साइड पेज) वेब पेज टेम्पलेट्स के लिए एक भाषा है।
WSSP के बारे में बात करने से पहले, आपको सर्वर पर वेब की खाल को व्यवस्थित करने के बारे में कुछ शब्दों में रखना होगा।

प्रत्येक वेब त्वचा में तीन प्रकार की फाइलें होती हैं:

• स्टैटिक फाइलें - ग्राफिक्स, शैलियाँ, ...
• WSSP फ़ाइलें
• भाषा और स्ट्रिंग फ़ाइलें

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

खाल में फ़ाइल पदानुक्रम

प्रत्येक त्वचा सर्वर, डोमेन या मानक हो सकती है।

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

इस प्रकार, अपनी खुद की फाइल को नाम रहित सर्वर स्किन पर अपलोड करते हुए, सर्वर एडमिनिस्ट्रेटर यह सुनिश्चित कर सकता है कि उसकी फाइल का उपयोग किया गया है, न कि मानक वाले का।

यही है, इस दृष्टिकोण के साथ, आप दोनों मानक खाल में छोटे बदलाव कर सकते हैं, और खरोंच से अपना खुद का विकास कर सकते हैं।

स्ट्रिंग फ़ाइलें

.data फ़ाइलों में CG / PL शब्दकोश प्रारूप में पाठ डेटा (UFT-8) होता है , इन डेटा का उपयोग विभिन्न सर्वर मॉड्यूल द्वारा इंटरफ़ेस में स्ट्रिंग्स बनाने या मान सेट करने के लिए किया जाता है।

ये फाइलें एक पदानुक्रम भी बनाती हैं, लेकिन पहले से ही शब्दकोश में कुंजी स्तर पर, अर्थात, यदि कुछ कुंजी डोमेन के स्ट्रिंग्स.डेटा फ़ाइल में गायब है, तो सर्वर इसे सर्वर स्तर पर strings.data फ़ाइल में खोजने की कोशिश करता है, आदि।

इंटरफ़ेस में तार के लिए अंग्रेज़ी डिफ़ॉल्ट भाषा है। यदि उपयोगकर्ता की भाषा (सत्र) अंग्रेजी से अलग है, तो भाषा फ़ाइलों (french.data, Russian.data) से कुंजियों के मान स्ट्रिंग्स.data फ़ाइल से मानों को प्रतिस्थापित करते हैं।

इस तरह की प्रणाली आपको थोड़े संशोधित इंटरफेस (स्ट्रिंग्स.डेटा फाइल्स) में शामिल करने की अनुमति देती है केवल वे कुंजी जिनके मान बदले गए हैं (उदाहरण के लिए, कंपनी का नाम, ब्रांड नाम), न कि उनका पूरा सेट।

प्रसंस्करण का अनुरोध करें

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

Wssp फ़ाइलों में कुछ अतिरिक्त तत्वों के साथ मार्कअप कोड (आमतौर पर HTML) होता है:

• पाठ को दोहरे चरित्र% (%% तत्व %%) द्वारा दोनों तरफ से बांधा गया है
• इस प्रारूप की संरचनाएँ -

ऐसे दस्तावेज़ का एक उदाहरण:

 <html> <body> <h1>   %%server%%.   %%ID%%.</h1> <!--%%IF EXISTS(lastLogin)-->     %%lastLogin%% <!--%%ENDIF--> </body> </html> 

सर्वर द्वारा संसाधित करने के बाद, सभी विशेष निर्माणों को "पर्यावरण" से तार के सरणियों या सरणियों से बदल दिया जाएगा। त्वचा में मुख्य फाइलें, डोमेन नाम या सर्वर में अन्य वस्तुओं, सेटिंग्स मानों से महत्वपूर्ण मान।

किसी भी अन्य फ़ाइलें बस ग्राहक को दी जाती हैं।

मूल डेमो वेब इंटरफेस को WSSP पृष्ठों की क्षमताओं के उत्कृष्ट चित्रण के रूप में देखा जा सकता है। लेकिन WSSP डेटा प्रारूपों को परिवर्तित करने या विभिन्न मॉड्यूल तक पहुंचने और सर्वर पर किसी भी कार्य करने के मामले में काफी सीमित है। और यहाँ एक अधिक शक्तिशाली उपकरण बचाव के लिए आता है।

सीजी / पीएल

सीजी / पीएल भाषा और उस पर पीबीएक्स अनुप्रयोगों के विकास के बारे में हमने पहले ही इस लेख में हैबे पर बात की थी।

पीबीएक्स के अलावा, यह वेब इंटरफेस कम्युनिटिग प्रो के विकास में सक्रिय रूप से उपयोग किया जाता है। यदि आप मूल वेब त्वचा (उपयोगकर्ता-> इंटरफ़ेस) की फ़ाइलों की सूची भी खोलते हैं, तो छोटे सीजी / पीएल कार्यक्रमों के साथ 14 फाइलें होंगी जो HTTP अनुरोधों को संसाधित करती हैं।

HTTP अनुरोध को संसाधित करने के लिए CG / PL प्रोग्राम को कॉल करने के लिए, आपको इसे किसी भी टेक्स्ट एडिटर में लिखने की आवश्यकता है, इसे .wcgp के रूप में सहेजें और इसे किसी भी वेब स्किन में लोड करें।

उसके बाद, फॉर्म के URL का अनुरोध करें:

 http://domain.name:[port]/programFile.wcgp/?Skin=skin_name 

निष्पादन के लिए कार्यक्रम चलाएं।

 http://domain.name:[port]/auth/programFile.wcgp/?Skin=skin_name 

पूर्व-प्रमाणीकरण वाले खाते की ओर से चलाएं

 http://domain.name:[port]/sys/programFile.wcgp 

यह अनुरोध केवल सर्वर में प्रोग्राम के लिए खोज करता है त्वचा और उपयोगकर्ता के रूप में पोस्टमास्टर (सर्वर व्यवस्थापक) चलाता है

एक उदाहरण के रूप में, एक छोटी लिपि पर विचार करें, जो "लिस्टकैकट्स" सीएलआई कमांड को निष्पादित करती है और परिणाम को JSON प्रारूप में परिवर्तित करती है:

 entry sysEntry is void(executeCLI("listaccounts mymac.ru")); accountList = Vars().executeCLIResult; SetHTTPResponseCode(200); SetHTTPResponseData(ObjectToJSON(accountList)); end entry; 

XIMSS

सर्वर-साइड कार्यक्षमता की इतनी बड़ी मात्रा के साथ - आवाज, त्वरित संदेश (एसएमएस सहित), कैलेंडर, संपर्क, मेल, एक फ़ाइल सर्वर, सेवा प्रदाता एक एकीकृत क्लाइंट लिखने में कुछ कठिनाइयों का अनुभव करते हैं। एसआईपी लागू करने वाले पुस्तकालयों का चयन या विकास करना आवश्यक है, * डीएवी प्रोटोकॉल, एसएमटीपी, आईएमएपी, एक्सएमपीपी का एक सेट। इस मामले में, इन प्रोटोकॉल से संदेश और डेटा स्वरूपों को पार्स करने का भार क्लाइंट के पास होता है।

इन समस्याओं को हल करने के लिए, हमने XIMSS प्रोटोकॉल विकसित किया - XML ​​इंटरफ़ेस टू मेसेजिंग, शेड्यूलिंग एंड सिग्नलिंग।

इस प्रोटोकॉल के सभी कमांड पारदर्शी विशेषताओं के साथ सरल XML दस्तावेज हैं। उदाहरण के लिए, यह सरल कमांड दो उपयोगकर्ताओं को आने वाली कॉल को पुनर्निर्देशित करेगा (कांटा):

 C:<callRedirect id="A018" callLeg="inp003" > <To>user1@example.com</To><To>user2@example.com</To> </callRedirect> S:<response id="A018"/> 

सभी डेटा प्रारूप (MIME, vCard) एक आसान उपयोग के रूप में XIMSS क्लाइंट में आते हैं।

यह प्रोटोकॉल आपको सर्वर पर उपलब्ध सभी सीएलआई कमांड को निष्पादित करने की भी अनुमति देता है - इसके माध्यम से आप प्रशासनिक सहित सभी प्रकार की सेटिंग्स को समायोजित कर सकते हैं

कई प्लेटफार्मों के लिए, हमने तैयार XIMSS पुस्तकालयों को विकसित किया है ।

XIMSS क्लाइंट की क्षमताओं के उदाहरण के रूप में, हम Pronto की एक श्रृंखला की सिफारिश करते हैं!, ऐसे अनुप्रयोग जिनके वेब संस्करण (HTML5 और Flash) हमारे बूथ bestvoip.ru पर आज़माए जा सकते हैं।

निष्कर्ष में

कम्युनिट प्रो एक ऐसा मंच है जिसके व्यवहार को विभिन्न स्तरों पर विनियमित किया जा सकता है। क्लाइंट से मुख्य संचार मॉड्यूल तक पहुंच और मानक प्रोटोकॉल के आधार पर अपनी कार्यक्षमता का विकास। इसी समय, समाधान स्थिर है और भारी भार का सामना कर सकता है।

इस तथ्य के बावजूद कि कुल सभी कम्युनिकेशन एपीआई में प्रवेश सीमा बड़ी लग सकती है, लेकिन वे संचार अधिकारियों द्वारा सामना किए जाने वाले अधिकांश कार्यों को कवर करते हैं।