Question 1

osFoundry यह कैसे वेरिफाई करता है कि कोई इनबाउंड वेबहुक असली है?

Accepted Answer

हर इनबाउंड टोकन के पास एक HMAC-SHA256 साइनिंग सीक्रेट होता है। भेजने वाला अनुरोध की बॉडी पर एक सिग्नेचर की गणना करता है और उसे X-OsFoundry-Signature हेडर में भेजता है, और osFoundry हर अनुरोध पर उसे दोबारा गणना कर मिलाता है। गायब या अमान्य सिग्नेचर वाले अनुरोध अस्वीकार हो जाते हैं, इसलिए केवल वही सिस्टम आपके चैनल में पब्लिश कर सकता है जिसके पास सीक्रेट है। सीक्रेट बनाते समय एक ही बार दिखाया जाता है, इसलिए उसे उसी समय सहेज लें, क्योंकि बाद में वह दोबारा नहीं दिखाया जाता।

Question 2

जब मैं किसी टोकन को रोटेट या रिवोक करता हूँ तो बीच में चल रहे इवेंट का क्या होता है?

Accepted Answer

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

Question 3

क्या मुझे हर चीज़ के लिए एक ही वेबहुक URL मिलता है, या मैं उन्हें सीमित कर सकता हूँ?

Accepted Answer

हर टोकन किसी खास ऐप, इंस्टेंस और चैनल तक सीमित होता है, और /api/v1/webhooks/inbound/{id} के अंतर्गत अपना खुद का URL बनाता है। इसका मतलब है कि कोई भेजने वाला ऐसे चैनल में पब्लिश नहीं कर सकता जिसकी उसे अनुमति नहीं दी गई, और आप बाकी को छुए बिना किसी एक इंटीग्रेशन को रिवोक या रोटेट कर सकते हैं। हर टोकन अपने अंतिम उपयोग का समय और 24-घंटे की अनुरोध गिनती भी बताता है ताकि आप जान सकें कि कौन-से एंडपॉइंट वास्तव में ट्रैफ़िक पा रहे हैं।