Webhook सिग्नेचर की जाँच करना
X-CalcLib-Signature हेडर से स्ट्रिंग t.body बनाएँ, अपने सीक्रेट से HMAC-SHA256 निकालें, और डिलीवरी पर कार्रवाई करने से पहले दोनों की तुलना करें।
Webhooks में जोड़ा गया webhook एंडपॉइंट हर बार जब कोई आपका एम्बेड चलाता है, एक साइन किया हुआ POST पाता है। हर डिलीवरी में X-CalcLib-Signature हेडर होता है, जिसका रूप t=<unix time>,v1=<signature> है।
पार्स करने से पहले जाँचें
- रॉ रिक्वेस्ट बॉडी पढ़ें। JSON को पार्स करके दोबारा सीरियलाइज़ करने से बाइट बदल जाते हैं, और सिग्नेचर कभी मेल नहीं खाएगा।
- हेडर से
tलें और स्ट्रिंगt.bodyबनाएँ: टाइमस्टैम्प, एक डॉट, फिर रॉ बॉडी। - उस स्ट्रिंग का HMAC-SHA256 अपने एंडपॉइंट सीक्रेट से hex रूप में निकालें।
- इसे हर
v1मान से constant time में मिलाएँ। सीक्रेट बदलते समय हेडर में दोv1मान हो सकते हैं; उनमें से कोई भी मेल खा सकता है। - अगर
tआपकी घड़ी से 5 मिनट से ज़्यादा दूर हो, तो डिलीवरी अस्वीकार कर दें।
जो डिलीवरी विफल हो जाती हैं
उन्हें 1 मिनट, 5 मिनट, 30 मिनट, 2 घंटे और 8 घंटे बाद दोबारा भेजा जाता है। जो एंडपॉइंट लगातार 20 बार विफल होता है उसे बंद कर दिया जाता है और हम आपको ईमेल भेजते हैं, जो सूचनाएँ में प्रोडक्ट स्विच के अनुसार चलता है।