वेबहुक्स के माध्यम से CMA अधिसूचना भेजना

अवलोकन

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

Cato दो प्रकार के वेबहुक एकीकरणों का समर्थन करता है:

  • मानक वेबहुक्स HTTP अनुरोधों का उपयोग बाहरी प्लेटफ़ॉर्म में वस्तुओं को बनाने या अपडेट करने के लिए करते हैं। 

  • संबंधित वेबहुक्स XOps सेवा के साथ एकीकृत होते हैं। वे खराब संबोधन आईडी का उपयोग करते हैं ताकि बाहरी उपकरणों में XOps सुरक्षा और नेटवर्क कहानियों के जीवनचक्र का प्रतिनिधित्व करने वाली वस्तुओं को बनाएं और अपडेट करें। XOps लाइसेंस आवश्यक है।

वेबहुक एकीकरण पूरी तरह से कॉन्फ़िगरेबल हैं। आप HTTP विधि (POST या PUT), लक्ष्य URL, प्रमाणीकरण विधि, और अनुरोध बॉडी को परिभाषित करते हैं। टेम्पलेट्स और क्षेत्र चर आपको तृतीय-पक्ष प्लेटफ़ॉर्म की आवश्यकताओं के लिए पेलोड संरचना को दर्जी बनाने की अनुमति देते हैं।

Cato वेबहुक एकीकरण को समझना

वेबहुक एकीकरण के प्रकार

Cato आपके खाते को तृतीय-पक्ष प्लेटफ़ॉर्म के साथ एकीकृत करने और स्वचालन प्रवाह बनाने के लिए इन प्रकार के वेबहुक्स का समर्थन करता है:

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

  • संबंधित वेबहुक्स XOps सेवा के लिए डिज़ाइन किए गए हैं। वे वेबहुक कार्यक्षमता को सुरक्षा और नेटवर्क कहानियों तक बढ़ाते हैं, इसलिए CMA में प्रत्येक कहानी को बाहरी प्रणाली में एक रिकॉर्ड के रूप में मैप किया जाता है और कहानी के विकास के अनुसार अद्यतित किया जाता है। XOps लाइसेंस आवश्यक है।

वेबहुक प्रवाह - बनाएँ या अपडेट करें

वेबहुक प्रवाह दर्शाते हैं कि CMA तृतीय पक्ष की प्लेटफ़ॉर्म के साथ कैसे संवाद करता है, या तो नए रिकॉर्ड बनाकर या मौजूदा को अपडेट करके:

  • POST (बनाएँ) - वेबहुक को ट्रिगर करने पर तीसरे पक्ष के प्लेटफ़ॉर्म में एक नई वस्तु बनाता है। उदाहरण: हर बार जब इंटरनेट फ़ायरवॉल नियम एक ट्रैफ़िक प्रवाह को अवरुद्ध करता है, तो एक नया सर्विसनाउ टिकट खोलें।

  • PUT (अपडेट करें) – तीसरे पक्ष के प्लेटफ़ॉर्म में मौजूदा वस्तु को अपडेट करता है। अनुरोध में URL या बॉडी में एक मान्य वस्तु ID शामिल है।

प्रमाणीकरण विधियाँ

वेबहुक एकीकरण बनाते समय, चुनने के लिए विभिन्न प्रमाणीकरण विधियाँ होती हैं:

  • बेसिक - उपयोगकर्ता नाम और पासवर्ड

  • बियरर - बियरर टोकन

  • कस्टम - ऐसी सेवाओं के लिए कस्टम हैडर्स जो विशेष प्रमाणीकरण की आवश्यकता होती है। आवश्यकतानुसार कुंजी-मूल्य जोड़ें।

नोट: यदि तृतीय-पक्ष सेवा तक पहुँच विशेष IP पतों तक सीमित है, तो उन Cato IP पतों की सूची के लिए कृपया इस लेख का संदर्भ लें जिन्हें आपको अनुमति देनी होगी (इस लेख को देखने के लिए आपको साइन इन होना चाहिए)।

सूचना सामग्री को अनुकूलित करना

टेम्पलेट में content क्षेत्र अलर्ट का उत्पन्न पढ़ने योग्य सारांश समाविष्ट करता है, जो ईमेल अलर्ट सामग्री के समान है। आप सामग्री के लिए इन प्रारूपों को चुन सकते हैं: contentText, contentMarkdown, या contentHTML।

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

वेबहुक फ़ील्ड्स के लिए डिफ़ॉल्ट मान

आप नोटिफिकेशन डेटा में मान शामिल नहीं होने पर गतिशील वेबहुक फ़ील्ड्स के लिए कस्टम डिफ़ॉल्ट मान परिभाषित कर सकते हैं ताकि लचीलापन जोड़ें। यह आपको वेबहुक यूआरएल, हेडर या बॉडी में डिफ़ॉल्ट एनए मान को ओवरराइड करने देता है। फील्ड के फॉलबैक मान को परिभाषित करने के लिए ${field:defaultValue} प्रारूप का उपयोग करें। उदाहरण के लिए, आप ${level:medium} सेट कर सकते हैं यदि level फ़ील्ड भरी नहीं जाती है। एक संबंधित प्रवाह में, आप एक डिफ़ॉल्ट सर्विसनाउ टिकट में अनसम्बंधित नोटिफिकेशन को कैप्चर करने के लिए वेबहुक यूआरएल में फॉलबैक टिकट आईडी का उपयोग कर सकते हैं, जैसे https://EXAMPLE-INSTANCE.service-now.com/api/now/table/incident/${correlationId:12345}।

मानक वेबहुक एकीकरण

मानक वेबहुक्स आपको CMA अधिसूचनाओं को तृतीय-पक्ष प्लेटफ़ॉर्म पर विभिन्न उपयोग मामलों के लिए भेजने की अनुमति देते हैं। पहले, प्लेटफ़ॉर्म के साथ एकीकरण के लिए वेबहुक को परिभाषित करें। फिर यह चुनें कि कौन से CMA अधिसूचनाएँ और नीति नियम, जैसे कि फ़ायरवॉल क्रियाएं, वेबहुक का उपयोग करके अधिसूचना उत्पन्न करेंगे।

वेबहुक एकीकरण को परिभाषित करें

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

विवरण परिभाषित करने के बाद, आप कनेक्शन का परीक्षण कर सकते हैं और सत्यापित कर सकते हैं कि यह काम करता है।

वेबहुक एकीकरण को परिभाषित करने के लिए:

  1. नेविगेशन मेनू से, खाता > सदस्यताएँ पर क्लिक करें और वेबहुक टैब का चयन करें।

  2. नया वेबहुक पर क्लिक करें। नया वेबहुक एकीकरण पैनल खुलता है।

  3. वेबहुक विवरण को कॉन्फ़िगर करें:

    1. एकीकरण नाम दर्ज करें।

    2. स्लाइडर पर क्लिक करके एकीकरण को सक्षम (हरा) या निष्क्रिय (ग्रे) करें (यह डिफ़ॉल्ट रूप से सक्षम है)।

  4. एकीकरण के लिए JSON टेम्पलेट के लिए सेटिंग्स को कॉन्फ़िगर करें:

    • टेम्पलेट से शुरू करें में, डिफ़ॉल्ट JSON टेम्पलेट चुनें जो एकीकरण की सेटिंग्स को आबाद करता है।

      आप कस्टम बॉडी के लिए फ़ील्ड्स को समायोजित और संशोधित कर सकते हैं (नीचे चरण 7 देखें)।

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

  5. कनेक्शन विवरण कॉन्फ़िगर करें:

    1. Webhook प्राप्त करने वाली सेवा के लिए यूआरएल दर्ज करें।

      आप URL में चर के रूप में फ़ील्ड्स का उपयोग कर सकते हैं। उपलब्ध फ़ील्ड्स देखने के लिए $ टाइप करें।

    2. अनुरोध विधि में, इस वेबहुक के लिए प्रवाह का चयन करें: POST या PUT।

    3. यदि आवश्यक हो, तो सेवा के लिए प्रमाणीकरण विधि और सेटिंग्स कॉन्फ़िगर करें।

  6. (वैकल्पिक) कस्टम हेडर्स में, एकीकरण के लिए प्रत्येक अतिरिक्त HTTP हैडर के लिए कुंजी और मान निर्धारित करें।

  7. कस्टम बॉडी में, वेबहुक अधिसूचना की सामग्री को परिभाषित करें:

    1. (वैकल्पिक) बॉडी संपादित करें में सामग्री को कस्टमाइज़ करें।

      • बॉडी में $ का उपयोग करने के लिए एस्केप करैक्टर के रूप में / दर्ज करें

      • अन्य फ़ील्ड्स को एम्बेड करने के लिए $ दर्ज करें

      मानक वेबहुक एकीकरण के लिए प्रतिक्रिया संबोधन आईडी का उपयोग नहीं किया जाता है

    2. डिफ़ॉल्ट मान को परिभाषित करने के लिए ${field:defaultValue} प्रारूप का उपयोग करें, उदाहरण के लिए ${ID:12345}।

  8. परीक्षण करें पर क्लिक करें। CMA फ़ील्ड्स के लिए स्वचालित रूप से उत्पन्न सामग्री के साथ एक परीक्षण HTTP अनुरोध भेजता है।

    यदि एकीकरण सेवा से कनेक्ट हो सकता है, तो एक परीक्षण सफलतापूर्वक पास हुआ संदेश प्रदर्शित होता है।

    यदि कनेक्शन त्रुटि है, तो पृष्ठ सेवा द्वारा रिपोर्ट किए गए HTTP त्रुटि कोड और संदेश प्रदर्शित करता है।

  9. सहेजें पर क्लिक करें। वेबहुक एकीकरण सहेजा गया है और सदस्यता पृष्ठ में एकीकरण टैब में जोड़ा गया है।

मानक वेबहुक एकीकरण के लिए ट्रिगर परिभाषित करें

मानक वेबहुक्स CMA से अधिसूचनाओं द्वारा सक्रिय किए जाते हैं। आप दो प्रकार की अधिसूचनाएं कॉन्फ़िगर कर सकते हैं:

  1. CMA अधिसूचनाएँ: CMA सक्रिय रूप से आपके खाते के बारे में अधिसूचनाएं भेज सकता है, जैसे कि लॉक किए गए उपयोगकर्ता और व्यवस्थापक, या लाइसेंस अपडेट। ये अधिसूचनाएं सीधे वेबहुक एकीकरण के माध्यम से भेजी जा सकती हैं।

    अधिक जानकारी के लिए, खाता स्तर अलर्ट और सिस्टम अधिसूचनाएं देखें।

  2. नीति नियम अधिसूचनाएं: आप एक नीति नियम में ट्रैक सेटिंग को कॉन्फ़िगर कर सकते हैं ताकि हर बार नियम मेल करे, वेबहुक को अधिसूचना भेज सके।

नीतियों में नियमों को परिभाषित करते समय, आप वेबहुक एकीकरण के माध्यम से अधिसूचनाएं भेजने के लिए क्रियाएँ क्षेत्र का उपयोग कर सकते हैं।

rule_webhook.png

संबंधित वेबहुक एकीकरण

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

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

इन एकीकरणों की आवश्यकता है:

  • ए मानक वेबहुक एकीकरण

  • ए एकीकृत वेबहुक एकीकरण

  • ट्रिगर के दो प्रकार (प्रत्येक एकीकरण के लिए ए)

मानक वेबहुक परिभाषित करें

मानक वेबहुक एकीकरण बनाएं ताकि आपके तृतीय-पक्ष उपकरण में प्रारंभिक वस्तुएं (टिकट, Slack संदेश, आदि) बन सकें। फिर ये वस्तुएं संबंधित वेबहुक एकीकरण द्वारा अपडेट की जाएंगी।

विवरण परिभाषित करने के बाद, आप कनेक्शन का परीक्षण कर सकते हैं और सत्यापित कर सकते हैं कि यह काम करता है।

मानक वेबहुक एकीकरण को परिभाषित करने के लिए:

  1. नेविगेशन मेनू से, खाता > सदस्यताएँ पर क्लिक करें और वेबहुक टैब चुनें।

  2. नया वेबहुक पर क्लिक करें। नया वेबहुक इंटीग्रेशन पैनल खुलता है।

  3. वेबहुक विवरण कॉन्फ़िगर करें:

    1. एकीकरण नाम दर्ज करें।

    2. इंटीग्रेशन को सक्षम (हरा) या अक्षम (ग्रे) करने के लिए स्लाइडर पर क्लिक करें (यह डिफ़ॉल्ट रूप से सक्षम है)।

  4. इंटीग्रेशन के लिए JSON टेम्पलेट की सेटिंग्स कॉन्फ़िगर करें:

    • टेम्पलेट से शुरू करें में, डिफ़ॉल्ट JSON टेम्पलेट चुनें जो एकीकरण सेटिंग्स को भरता है।

      कस्टम बॉडी के लिए फ़ील्ड को समायोजित और संशोधित कर सकते हैं (नीचे चरण 7 देखें)।

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

  5. कनेक्शन विवरण कॉन्फ़िगर करें:

    1. सेवा के लिए यूआरएल दर्ज करें जो वेबहुक प्राप्त कर रहा है।

      आप यूआरएल में फ़ील्ड को वेरिएबल्स के रूप में उपयोग कर सकते हैं। उपलब्ध फ़ील्ड देखने के लिए $ टाइप करें।

    2. रिक्वेस्ट विधि में, POST चुनें।

    3. यदि आवश्यक हो, तो सेवा के लिए प्रमाणीकरण विधि और सेटिंग्स कॉन्फ़िगर करें।

  6. (वैकल्पिक) कस्टम हेडर्स में, इंटीग्रेशन के लिए प्रत्येक अतिरिक्त HTTP हेडर के लिए कुंजी और मान परिभाषित करें।

  7. कस्टम बॉडी में, वेबहुक अधिसूचना की सामग्री परिभाषित करें:

    1. प्रतिक्रिया कोरिलेशन आईडी में, अपने तृतीय-पक्ष में उस वस्तु को परिभाषित करें जिसे आप यूआरएल में कोरिलेशन के लिए उपयोग करेंगे। उदाहरण के लिए, सर्विसनाउ में यह result.sys_id हो सकता है, और ज़ेनडेस्क में यह ticket.id हो सकता है।

    2. (वैकल्पिक) बॉडी संपादित करें में सामग्री को कस्टमाइज़ करें।

      • बॉडी में $ का उपयोग करने के लिए एस्केप करैक्टर के रूप में / दर्ज करें

      • अन्य फ़ील्ड एम्बेड करने के लिए $ दर्ज करें

    3. डिफ़ॉल्ट मान को परिभाषित करने के लिए ${field:defaultValue} प्रारूप का उपयोग करें, उदाहरण के लिए ${ID:12345}।

  8. परीक्षण पर क्लिक करें। CMA फ़ील्ड के लिए स्वतः उत्पन्न सामग्री के साथ एक परीक्षण HTTP अनुरोध भेजता है।

    यदि एकीकरण सेवा से कनेक्ट कर सकता है, तो एक परीक्षण सफलतापूर्वक पास हुआ संदेश प्रदर्शित होता है।

    यदि कनेक्शन त्रुटि है, तो पृष्ठ सेवा द्वारा रिपोर्ट किए गए HTTP त्रुटि कोड और संदेश प्रदर्शित करता है।

  9. सहेजें पर क्लिक करें। वेबहुक इंटीग्रेशन सहेजा जाता है और सदस्यता पृष्ठ में एकीकरण टैब में जोड़ा जाता है।

संबंधित वेबहुक को परिभाषित करें

एक संबंधित वेबहुक एकीकरण बनाएं जो पिछले प्रक्रिया में बनाई गई मौजूदा वस्तुओं को अपडेट करके आपकी तृतीय-पक्ष उपकरण में वस्तुओं (टिकट, स्लैक संदेश, आदि) के माध्यम से अधिसूचनाएं भेजता है।

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

विवरण परिभाषित करने के बाद, आप कनेक्शन का परीक्षण कर सकते हैं और सत्यापित कर सकते हैं कि वह काम करता है।

एक संबंधित वेबहुक एकीकरण को परिभाषित करने के लिए:

  1. नेविगेशन मेनू से, खाता > सदस्यताएँ पर क्लिक करें और वेबहुक टैब चुनें।

  2. नया वेबहुक पर क्लिक करें। नया वेबहुक इंटीग्रेशन पैनल खुलता है।

  3. वेबहुक विवरण कॉन्फ़िगर करें:

    1. एकीकरण नाम दर्ज करें।

    2. इंटीग्रेशन को सक्षम (हरा) या अक्षम (ग्रे) करने के लिए स्लाइडर पर क्लिक करें (यह डिफ़ॉल्ट रूप से सक्षम है)।

  4. इंटीग्रेशन के लिए JSON टेम्पलेट की सेटिंग्स कॉन्फ़िगर करें:

    • टेम्पलेट से शुरू करें में, डिफ़ॉल्ट JSON टेम्पलेट चुनें जो एकीकरण सेटिंग्स को भरता है।

      कस्टम बॉडी के लिए फ़ील्ड को समायोजित और संशोधित कर सकते हैं (नीचे चरण 7 देखें)।

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

  5. कनेक्शन विवरण कॉन्फ़िगर करें:

    1. सेवा के लिए यूआरएल दर्ज करें जो वेबहुक प्राप्त कर रहा है। संबंधित आइटम आईडी फ़ील्ड जोड़कर मौजूदा वस्तु के साथ इसे संबंधित करें।

      आप यूआरएल में फ़ील्ड को वेरिएबल्स के रूप में उपयोग कर सकते हैं। उपलब्ध फ़ील्ड देखने के लिए $ टाइप करें।

    2. रिक्वेस्ट विधि में, PUT चुनें।

    3. यदि आवश्यक हो, तो सेवा के लिए प्रमाणीकरण विधि और सेटिंग्स कॉन्फ़िगर करें।

  6. (वैकल्पिक) कस्टम हेडर्स में, इंटीग्रेशन के लिए प्रत्येक अतिरिक्त HTTP हेडर के लिए कुंजी और मान परिभाषित करें।

  7. कस्टम बॉडी में, वेबहुक अधिसूचना की सामग्री परिभाषित करें:

    1. (वैकल्पिक) बॉडी संपादित करें में सामग्री को कस्टमाइज़ करें।

      • बॉडी में $ का उपयोग करने के लिए एस्केप करैक्टर के रूप में / दर्ज करें

      • अन्य फ़ील्ड एम्बेड करने के लिए $ दर्ज करें

    2. डिफ़ॉल्ट मान को परिभाषित करने के लिए ${field:defaultValue} प्रारूप का उपयोग करें, उदाहरण के लिए ${ID:12345}।

  8. परीक्षण पर क्लिक करें। CMA फ़ील्ड के लिए स्वतः उत्पन्न सामग्री के साथ एक परीक्षण HTTP अनुरोध भेजता है।

    यदि एकीकरण सेवा से कनेक्ट कर सकता है, तो एक परीक्षण सफलतापूर्वक पास हुआ संदेश प्रदर्शित होता है।

    यदि कनेक्शन त्रुटि है, तो पृष्ठ सेवा द्वारा रिपोर्ट किए गए HTTP त्रुटि कोड और संदेश प्रदर्शित करता है।

  9. सहेजें पर क्लिक करें। वेबहुक इंटीग्रेशन सहेजा जाता है और सदस्यता पृष्ठ में एकीकरण टैब में जोड़ा जाता है।

मानक वेबहुक इंटीग्रेशन के लिए ट्रिगर परिभाषित करें

मानक वेबहुक CMA से अधिसूचनाओं द्वारा सक्रिय किया जाता है। आप दो प्रकार की अधिसूचनाएं कॉन्फ़िगर कर सकते हैं:

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

    अधिक जानकारी के लिए, खाता स्तर अलर्ट और सिस्टम अधिसूचनाएं देखें।

  2. नीति नियम अधिसूचनाएं: जब भी नियम का मिलान होता है, आप वेबहुक को अधिसूचना भेजने के लिए नीति नियम में ट्रैक सेटिंग को कॉन्फ़िगर कर सकते हैं।

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

rule_webhook.png

परिभाषित डिटेक्शन और प्रतिक्रिया नोटिफिकेशन का उपयोग करके संबंधित एकीकरण के लिए ट्रिगर परिभाषित करें।

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

आप नीति में निम्नलिखित नियमों को कॉन्फ़िगर कर सकते हैं:

  • कहानी बनाई गई: एक संबंधित वेबहुक ट्रिगर करें जो एक नई वस्तु बनाता है

  • कहानी अपडेट की गई: एक संबंधित वेबहुक ट्रिगर करें जो कहानी के बढ़ने पर उसी वस्तु को अपडेट करता है

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

वेबहुक अधिसूचना को ट्रिगर करने के लिए परिभाषित करें:

  1. नेविगेशन मेनू से, होम > डिटेक्शन और प्रतिक्रिया नीति पर क्लिक करें।

  2. प्रतिक्रिया नीति टैब का चयन करें।

  3. नया पर क्लिक करें। प्रतिक्रिया नीति में जोड़ें पैनल खुलता है।

  4. नियम के लिए एक नाम दर्ज करें।

  5. स्रोत अनुभाग में, प्रकार का चयन करें (उदाहरण: होस्ट, IP रेंज, साइट) और फिर इस नियम के लिए स्टोरी स्रोत के लिए एक या अधिक वस्तुओं का चयन करें (या आप एक आईपी पता दर्ज कर सकते हैं)।

    डिफ़ॉल्ट स्रोत मान कोई भी है।

  6. (वैकल्पिक) मानदंड को परिभाषित करें जो बताते हैं कि कहानी को नियम से मेल खाने के लिए किन विशेषताओं की आवश्यकता है।

  7. नियम के लिए ट्रिगर का चयन करें। 

    • कहानी बनाई गई नई वस्तुओं को बनाने के लिए

    • कहानी अपडेट की गई मौजूदा वस्तुओं को अपडेट करने के लिए

  8. प्रतिक्रिया टैब में, नोटिफिकेशन भेजें का चयन करें।

  9. नोटिफ़िकेशन भेजने के लिए में, एकीकरण का चयन करें।

  10. एकीकरण में, उस वेबहुक एकीकरण का चयन करें जो अधिसूचना भेज रहा है।

  11. सहेजें पर क्लिक करें। नियम को नीति में जोड़ा गया है।

टेम्पलेट्स और फ़ील्ड्स

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

एक टेम्पलेट का चयन करने के बाद, आप JSON पेलोड के रूप में बॉडी को संपादित कर सकते हैं और इसे एक कस्टम टेम्पलेट के रूप में सहेज सकते हैं। आपके पास JSON में डेटा फ़ील्ड्स को एम्बेड करने का विकल्प भी है, जो प्रासंगिक मान को पेलोड में डाल देगा (या NA यदि उपलब्ध नहीं है)।

जब आप $ टाइप करते हैं, तो उपलब्ध फ़ील्ड्स प्रदर्शित होते हैं। Cato फील्ड्स के बारे में अधिक जानकारी के लिए, इस लेख को देखें।

आप जब वेबहुक बना रहे होते हैं तो इन टेम्पलेट्स में से चुन सकते हैं:

  • सभी क्षेत्र - इसमें हर उपलब्ध क्षेत्र शामिल है

  • बेसिक - सबसे सामान्यत: उपयोग किए जाने वाले फ़ील्ड्स वाला टेम्पलेट

  • Jira - एक बुनियादी JIRA टेम्पलेट

  • ServiceNow Create Ticket - ServiceNow में एक नया टिकट बनाता है

  • ServiceNow Update Ticket - ServiceNow में एक मौजूदा टिकट को अपडेट करता है

  • Slack - एक संदेश को स्लैक चैनल पर भेजता है

  • Zendesk Create Ticket - Zendesk में एक नया टिकट बनाता है

  • Zendesk Update Ticket - एक मौजूदा Zendesk टिकट को अपडेट करता है

  • कस्टम - एक टेम्पलेट के लिए सेटिंग्स को कस्टमाइज़ करें

आप वेबहुक इंटीग्रेशन के URL को परिभाषित करते समय फ़ील्ड्स का उपयोग भी कर सकते हैं।

क्या यह लेख उपयोगी था?

1 में से 0 के लिए उपयोगी रहा

0 टिप्पणियां