osFoundry / Platform
आउटबाउंड webhooks
platform इवेंट्स को अपने स्वयं के एंडपॉइंट्स पर फ़ैन आउट करें। ऑटो-रीट्राई, सिग्नेचर वेरिफ़िकेशन।
यह क्या है
आउटबाउंड वेबहुक की मदद से osFoundry इवेंट सीधे उन एंडपॉइंट पर भेज देता है जिन्हें आप नियंत्रित करते हैं। बदलावों के लिए बार-बार पोलिंग करने के बजाय, आप एक URL रजिस्टर करते हैं और आपके वर्कस्पेस में कोई प्रासंगिक इवेंट होते ही osFoundry उस URL पर एक HTTP अनुरोध भेज देता है। इससे आपके चैट, एजेंट, ऐप्स, कोड, नॉलेज और डेटा वाली सतहों की गतिविधि एक ऐसे संकेत में बदल जाती है जिस पर आपके अपने सिस्टम कार्रवाई कर सकते हैं, और हर एक के लिए अलग कस्टम इंटीग्रेशन बनाने की ज़रूरत नहीं पड़ती।
osFoundry के भीतर वेबहुक सेटिंग्स और सुरक्षा के अंतर्गत रहते हैं, क्योंकि ये एक भरोसे की सीमा पार करते हैं: ये वर्कस्पेस के इवेंट को बाहर, आपके अपने रिसीवर तक ले जाते हैं। हर डिलीवरी हस्ताक्षरित होती है, इसलिए आपका एंडपॉइंट सत्यापित कर सकता है कि अनुरोध वाकई osFoundry से आया है और रास्ते में उससे कोई छेड़छाड़ नहीं हुई। बॉडी पर भरोसा करने से पहले अपने साझा सीक्रेट के विरुद्ध हस्ताक्षर की जाँच कर लें। जो डिलीवरी विफल होती हैं, चाहे इसलिए कि आपका एंडपॉइंट बंद था, धीमा था या कोई त्रुटि लौटाई, उन्हें छोड़ने के बजाय स्वतः पुनः प्रयास किया जाता है, ताकि आपकी ओर की कोई छोटी रुकावट चुपचाप इवेंट न गँवा दे। चूँकि osFoundry लोकल-फ़र्स्ट और BYOK है, वेबहुक डेटा को बाहर ले जाने का एक सोचा-समझा, ऑप्ट-इन तरीका हैं: कौन-से एंडपॉइंट इवेंट पाएँगे यह आप तय करते हैं, और पेलोड वहीं जाते हैं जहाँ आप इंगित करते हैं।
व्यावहारिक फ़ायदा है डिकपलिंग। आपकी नोटिफ़िकेशन सेवा, टिकटिंग सिस्टम, डेटा वेयरहाउस या कोई आंतरिक ऑटोमेशन को न तो osFoundry के भीतर रहने की ज़रूरत है और न ही osFoundry के क्रेडेंशियल रखने की। उसे बस एक ऐसा HTTPS एंडपॉइंट खोलना है जो हस्ताक्षर सत्यापित करे और सफलता की स्थिति लौटाए। हस्ताक्षर सत्यापन और स्वतः पुनः प्रयास ही उस एंडपॉइंट को भरोसेमंद और निर्भर करने लायक बनाते हैं, और यही अंतर है उस वेबहुक में जिस पर आप एक वर्कफ़्लो खड़ा कर सकते हैं और उस वेबहुक में जिसकी आपको लगातार देखभाल करनी पड़े।
मुख्य क्षमताएँ
- अपने HTTPS एंडपॉइंट रजिस्टर करें और प्लैटफ़ॉर्म इवेंट जैसे ही घटित हों वैसे ही पाएँ, कोई पोलिंग लूप बनाए रखने की ज़रूरत नहीं
- हर पेलोड हस्ताक्षरित होता है, ताकि कार्रवाई से पहले आपका रिसीवर सत्यापित कर सके कि अनुरोध osFoundry से ही आया है
- विफल डिलीवरी स्वतः पुनः प्रयास होती हैं, इसलिए डाउनस्ट्रीम में कोई रुकावट चुपचाप इवेंट नहीं गँवाती
- सेटिंग्स और सुरक्षा के अंतर्गत प्रबंधित, हर एंडपॉइंट के लिए ऑप्ट-इन आउटबाउंड रास्ता जो पूरी तरह आपके नियंत्रण में है
- लोकल-फ़र्स्ट, BYOK मॉडल में फ़िट: डेटा केवल उन्हीं एंडपॉइंट तक जाता है जिन्हें आप स्पष्ट रूप से इंगित करते हैं
उपयोग के मामले
- प्लैटफ़ॉर्म इंजीनियर: वर्कस्पेस इवेंट को किसी आंतरिक ऑटोमेशन सेवा तक फ़ॉरवर्ड करें, बिना उसे osFoundry क्रेडेंशियल दिए या ऐप में एम्बेड किए
- ऑप्स/ऑन-कॉल: इवेंट को किसी मौजूदा अलर्टिंग या नोटिफ़िकेशन सिस्टम में भेजें, ताकि सही लोगों को गतिविधि की जानकारी रियल-टाइम में मिले
- डेटा टीम: इवेंट को वेयरहाउस या ETL एंडपॉइंट तक स्ट्रीम करें, ताकि वर्कस्पेस में जो होता है उसके साथ एक बाहरी रिकॉर्ड सिंक में रहे
सामान्य प्रश्न
मैं कैसे सत्यापित करूँ कि वेबहुक अनुरोध वाकई osFoundry से आया है?
हर डिलीवरी हस्ताक्षरित होती है। आपका एंडपॉइंट आपके साझा सीक्रेट का उपयोग करके अनुरोध बॉडी पर हस्ताक्षर फिर से गणना करता है और उसे osFoundry द्वारा भेजे गए हस्ताक्षर से मिलाता है। यदि दोनों मेल न खाएँ, तो अनुरोध अस्वीकार कर दें। यही किसी तीसरे पक्ष को आपके एंडपॉइंट पर नकली इवेंट भेजने से रोकता है।
जब कोई इवेंट ट्रिगर हो और मेरा एंडपॉइंट बंद हो तो क्या होता है?
osFoundry डिलीवरी को छोड़ने के बजाय स्वतः पुनः प्रयास करता है, इसलिए आपकी ओर की कोई छोटी रुकावट या डिप्लॉय आपके इवेंट नहीं गँवाती। पेलोड स्वीकार कर लेने पर आपके एंडपॉइंट को सफलता की स्थिति लौटानी चाहिए।
क्या वेबहुक इस्तेमाल करने से मेरा डेटा osFoundry के नियंत्रण वाली किसी जगह भेजा जाता है?
नहीं। osFoundry लोकल-फ़र्स्ट और BYOK है, और वेबहुक आपके रजिस्टर किए एंडपॉइंट की ओर आउटबाउंड होते हैं। इवेंट केवल उन्हीं URL पर जाते हैं जिन्हें आप कॉन्फ़िगर करते हैं, और कौन-से एंडपॉइंट मौजूद हैं यह आप नियंत्रित करते हैं। यह विशिष्ट इवेंट को उन सिस्टम तक ले जाने का एक ऑप्ट-इन तरीका है जो पहले से आपके अपने हैं।