Mattermost। बाहरी सेवाओं के साथ एकीकरण

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

भाग एक GLPI के साथ एकीकरण

चूंकि, हम अपने काम में, उपकरण, सॉफ्टवेयर, कनेक्शन, तकनीकी सहायता कॉल के पंजीकरण के लिए GLPI का उपयोग करते हैं, इसलिए उपयोगकर्ताओं को टीपी से एप्लिकेशन भेजने के लिए संभावना को व्यवस्थित करने के लिए इसे व्यवस्थित करना तर्कसंगत होगा।

एपीआई

GLPI में बाहरी सेवाओं के साथ एकीकरण के लिए http बाकी एपीआई है। इसके लिए प्रलेखन लिंक http: //glpi/apirest.php/#glossary (जहां "ग्लपी" आपके सर्वर का पता है) में स्थापित सिस्टम में उपलब्ध है।

कार्य पर थोड़ा विचार करने के बाद, यह निर्णय लिया गया कि एक्सचेंज एल्गोरिथ्म को php पर लागू किया जाए, इस समाधान के पक्ष में तथ्य यह है कि सिस्टम में php पहले से ही इंस्टॉल है और स्क्रिप्ट को ऑर्गनाइज़ रूप से glpi में दर्ज किया गया था और http: //glpi-mm.php पर उपलब्ध है। परिणाम एक प्रकार का "प्रॉक्सी" था, जो कि निवेदन से अनुरोध प्राप्त करता है, वांछित प्रारूप में परिवर्तित होता है और GLPI भेजता है। सभी HTTP अनुरोध JSON प्रारूप में भेजे जाते हैं।

कार्य प्रक्रिया में 5 भाग होते हैं:

1. मामले से अनुरोध प्राप्त करना
2. Glpi में सत्र आरंभीकरण
3. अनुरोध से डेटा पुनर्प्राप्त करना
4. ग्लेपी में डेटा भेजना
5. समापन सत्र

स्क्रिप्ट कोड के विवरण के साथ आगे बढ़ने से पहले, हम तैयारी के काम को पूरी तरह से और ख़ुशी के साथ करेंगे।

GLPI

1. चलिए हेल्पडेस्क उपयोगकर्ता बनाते हैं, जिसके आधार पर अनुरोध बनाया जाएगा, और इस उपयोगकर्ता की सेटिंग में जाकर, हम टॉस्क उत्पन्न करेंगे:
   
   लाल रंग में परिक्रमा करने वाला user_token होगा।
2. सिस्टम सेटिंग्स में, आपको एपीआई के साथ इंटरैक्ट करने के लिए क्लाइंट जोड़ना होगा। ऐसा करने के लिए, "सेटिंग" -> "सामान्य" -> "एपीआई" पर जाएं और "क्लाइंट जोड़ें" बटन पर क्लिक करें, एक रिकॉर्ड जोड़ें और एक टोकन बनाएं (app_token)

1. सिस्टम में अनुरोधों के स्रोत की पहचान करने के लिए, निर्देशिका "अनुरोधों के स्रोत" में एक प्रविष्टि जोड़ें और बस जोड़े गए प्रविष्टि में जाएं, इसकी आईडी याद रखें (लाल रंग में परिक्रमा करें)
   

यह GLPI में API सेटअप पूरा करता है।

Mattermost

Mattermost क्लाइंट मेनू में, "Inegration" -> "जावक Webhooks" पर "Add" पर क्लिक करें और एक प्रविष्टि जोड़ें। स्क्रीन पर, मैंने महत्वपूर्ण क्षेत्रों पर जोर दिया। यहां हमें एक विषयांतर करना चाहिए: इसके अतिरिक्त, अनुरोध भेजने की प्रक्रिया शुरू करने के लिए "ट्रिगर" एक शब्द या वाक्यांश है, जिसे संदेश की शुरुआत में संकेत दिया जा रहा है, वास्तव में प्रक्रिया शुरू होती है। हमारे मामले में, ट्रिगर शब्द "112" (यहां आपात स्थिति मंत्रालय के साथ एक सीधा संबंध है)।

डिफ़ॉल्ट उपयोगकर्ता नाम और अवतार के लिए लिंक जोड़ा जा सकता है (या आप इसे जोड़ नहीं सकते हैं), क्योंकि ये पैरामीटर अनुरोध में स्थानांतरित किए जाएंगे। लेकिन इन मापदंडों को संसाधित करने में सक्षम होने के लिए, सर्वर सेटिंग्स में आपको फ़ाइल में कुछ विकल्पों को बदलने की आवश्यकता है /opt/mattermost/config/config.json

"EnablePostUsernameOverride": true, "EnablePostIconOverride": true, 

यह सेटअप पूरा करता है। लेखन कोड पर आगे बढ़ने का समय स्क्रिप्ट को ग्लपी फ़ाइलों के साथ रूट डायरेक्टरी में कॉपी किया जाता है, मेरे मामले में यह /var/www/html/glpi/mm.pp है

  <?php # GLPI     $app_token = '7uizyyildM71x84j1UxeABXTuCHdPoLRW45Tx2wG'; $user_app_token ='dZdCqc10Xhb1TxCT4OsXp8qqDSEqILASf2wZot0w'; #    (  ,    ) $requesttypes_id = '7'; #    GLPI (1 - , 2 - ) $type = '1'; #      $postData = file_get_contents('php://input'); $data = json_decode($postData, true); #  json  MatterMost.       #         #$message_text = $data["text"]; #$user_name = $data["user_name"]; #$user_id = $data["user_id"]; #$channel_name = $data["channel_name"]; #$channel_id = $data["channel_id"]; #$team_domain = $data["team_domain"]; #$team_id = $data["team_id"]; #$post_id = $data["post_id"]; #  "112"  ,    4 . $message_text = substr($data["text"],4); #   POST ,      mattermost #HTTP/1.1 200 OK header('Content-Type: application/json'); $reply = array( 'response_type' => 'comment', 'text'=> '      ' ); echo json_encode($reply); #     glpi #        #         if( $curl = curl_init() ) { curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'Authorization: user_token '.$user_app_token, 'App-Token: '.$app_token)); curl_setopt($curl, CURLOPT_URL, 'http://glpi/apirest.php/initSession'); curl_setopt($curl, CURLOPT_POST, true); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); $out = curl_exec($curl); $session = json_decode($out, true); $session_token = $session["session_token"]; #echo $session_token; curl_close($curl); } #       $json = array( 'input'=> array( 'name'=>'  '.$data["user_name"], 'requesttypes_id'=>$requesttypes_id, 'content'=>$message_text, 'type'=>$type ) ); #   if( $curl = curl_init() ) { curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'App-Token: '.$app_token, 'Session-token: '.$session_token)); curl_setopt($curl, CURLOPT_URL, 'http://glpi/apirest.php/Ticket'); curl_setopt($curl, CURLOPT_POST, true); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($json)); $out = curl_exec($curl); curl_close($curl); } #   if( $curl = curl_init() ) { curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'App-Token: '.$app_token, 'Session-token: '.$session_token)); curl_setopt($curl, CURLOPT_URL, 'http://glpi/apirest.php/killSession'); curl_setopt($curl, CURLOPT_POST, false); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); $out = curl_exec($curl); curl_close($curl); } ?> 

इस स्क्रिप्ट का परिणाम GLPI में घटना पंजीकरण प्रणाली में एक अतिरिक्त अनुरोध होगा। तस्वीरों में, ऐसा दिखता है:

हम व्यर्थ में एक संदेश लिखते हैं:

हम GLPI "सहायता" -> "एप्लिकेशन" पर जाते हैं और सूची में एक नया संदेश दिखाई देना चाहिए:

संदेश हेडर पर क्लिक करने से, अधिक विस्तृत जानकारी खुल जाएगी (वे फ़ील्ड जिनके मान स्क्रिप्ट में संचरित हैं, लाल रंग में परिचालित हैं)

इस सेटिंग पर Mattermost से GLPI को संदेश भेजने को पूर्ण माना जा सकता है। कोड पर थोड़ा काम करने से, कुछ भी आपको अनुरोध के प्रकार (घटना या अनुरोध) में बदलाव को लागू करने से नहीं रोक सकेगा।