आउटगोइंग वेबहुक और HMAC हस्ताक्षर
HMAC-SHA256 क्रिप्टोग्राफिक हस्ताक्षरों का उपयोग करके सुरक्षित रूप से अपने Aurabase प्रोजेक्ट से वास्तविक समय की घटनाओं को अपने सर्वर पर प्राप्त करें।
वेबहुक वास्तुकला#
Aurabase आउटगोइंग वेबहुक आपके कॉलबैक यूआरएल पर सिस्टम इवेंट प्रसारित करता है (उदाहरण के लिए नया उपयोगकर्ता पंजीकरण, सफल भुगतान, तालिका पंक्ति अपडेट)।
भेजे गए प्रत्येक वेबहुक में एक अद्वितीय ईवेंट पहचानकर्ता event_id होता है जो आपको अपने सर्वर पर इडेम्पोटेंट प्रोसेसिंग लागू करने की अनुमति देता है।
X-Aurabase-हस्ताक्षर शीर्षलेख की संरचना#
Aurabase द्वारा जारी किए गए प्रत्येक HTTP POST अनुरोध में निम्नलिखित सुरक्षा शीर्षलेख शामिल हैं:
POST /webhook HTTP/1.1
Host: api.votre-domaine.com
Content-Type: application/json
X-Aurabase-Event-Id: evt_01J8Y6Q9K3M7Z...
X-Aurabase-Signature: t=1724060000,v1=9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08
HMAC-SHA256 हस्ताक्षर सत्यापित करें#
import crypto from 'node:crypto'
export function verifyAurabaseWebhook(
rawBody: string, signatureHeader: string, secret: string
): boolean {
const parts = Object.fromEntries(
signatureHeader.split(',').map(p => p.split('=')),
)
const { t: timestamp, v1: signature } = parts
// 1. रीप्ले हमलों से सुरक्षा (अधिकतम 5 मिनट)
if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) {
return false
}
// 2. टाइमस्टैम्प.रॉबॉडी पर HMAC-SHA256 की गणना
const expected = crypto
.createHmac('sha256', secret)
.update(timestamp + '.' + rawBody)
.digest('hex')
// 3. निरंतर समय में सुरक्षित तुलना
return crypto.timingSafeEqual(
Buffer.from(signature), Buffer.from(expected)
)
}
दोष प्रबंधन और डेड-लेटर कतार#
यदि आपका सर्वर HTTP त्रुटि कोड (4xx, 5xx) के साथ प्रतिक्रिया करता है या टाइमआउट (10 सेकंड की समय सीमा) का अनुभव करता है, तो Aurabase स्वचालित रूप से एक घातीय बैकऑफ़ के अनुसार भेजने का पुनः प्रयास करता है:
- प्रयास 1: तत्काल
- प्रयास 2: 15 सेकंड के बाद
- प्रयास 3: 1 मिनट के बाद
- प्रयास 4: 5 मिनट के बाद
- प्रयास 5: 30 मिनट के बाद
लगातार 5 विफलताओं के बाद, इवेंट को निरीक्षण और मैन्युअल रीप्ले के लिए स्टूडियो के डेड-लेटर क्यू (DLQ) में रखा गया है।