खाता सेटिंग में वेबहुक बनाएँ और दिखने पर उसका हस्ताक्षर रहस्य सुरक्षित रखें। यह रहस्य संग्रहीत स्थिति में एन्क्रिप्ट होता है, HTTP पेलोड में नहीं भेजा जाता, और एक बार फिर दिखाने के लिए बदला जा सकता है।
01 / डिलीवरी प्रारूप
जिन बाइट पर हस्ताक्षर होते हैं।
Skyroute कॉन्फ़िगर किए गए सार्वजनिक HTTPS URL पर JSON के साथ POST करता है: event and payload. X-Skyroute-Timestamp सेकंड में Unix टाइमस्टैम्प है। X-Skyroute-Signature का प्रारूप है v1=<lowercase hex>। हस्ताक्षर इस इनपुट का HMAC-SHA256 है: timestamp + "." + raw JSON body.
JSON पार्स करने से पहले अनुरोध की बाइट पढ़ें। छोटी सहनशीलता अवधि से बाहर के टाइमस्टैम्प अस्वीकार करें, एंडपॉइंट रहस्य से HMAC बनाएँ और प्राप्त डाइजेस्ट की स्थिर समय में तुलना करें। उदाहरण पाँच मिनट की सहनशीलता इस्तेमाल करता है; दोहराए गए अनुरोध रोकने के लिए घटना ID या समकक्ष कुंजी सहेजें।
NODE.JS · सत्यापन उदाहरण
import { createHmac, timingSafeEqual } from 'node:crypto';
function verifySkyroute(rawBody, timestamp, signature, secret) {
if (!/^\d+$/.test(timestamp ?? '')) return false;
if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;
const supplied = signature?.startsWith('v1=') ? signature.slice(3) : '';
if (!/^[a-f0-9]{64}$/.test(supplied)) return false;
const expected = createHmac('sha256', secret)
.update(`${timestamp}.`)
.update(rawBody)
.digest();
return timingSafeEqual(expected, Buffer.from(supplied, 'hex'));
}
// In Express, use express.raw({ type: 'application/json' })
// on this route, then pass req.body to verifySkyroute.
// Parse JSON only after verification succeeds.
मिली हुई बाइट ज्यों की त्यों इस्तेमाल करें। JSON को पार्स करके दोबारा लिखने से हस्ताक्षर इनपुट बदल जाता है।
03 / रहस्य बदलना
दिखते ही सुरक्षित रखें।
वेबहुक बनाने या उसका रहस्य बदलने के बाद हस्ताक्षर रहस्य केवल एक बार दिखता है। बदलाव पर अपने रिसीवर को तुरंत अद्यतन करें; पुराना रहस्य नई डिलीवरी पर हस्ताक्षर नहीं करेगा। सहेजे न गए रहस्य वाले वेबहुक का रहस्य वेबहुक सेटिंग में बदला जा सकता है।
Most events make one outbound HTTPS attempt per matching active webhook, with a five-second timeout and redirects disabled; failed attempts are logged without automatic retry. Sandbox route_test.result events are an exception: they use a durable retry queue and may arrive more than once. Deduplicate those events using the stable X-Skyroute-Event-Id header or payload.delivery_id. The separate inbound endpoint POST /api/webhooks/events प्रदाता-विशिष्ट हस्ताक्षर सत्यापक कॉन्फ़िगर होने तक 503 लौटाता है।