شرح Webhooks: الحمولات الموقعة واستراتيجيات إعادة المحاولة
لقد قمت ببناء API يرسل webhooks لإخطار الخدمات الخارجية بالأحداث. ولكن ماذا يحدث عندما يكون نقطة النهاية المستقبلة معطلة؟ أو عندما يحاول جهة خبيثة تزوير طلب webhook؟ بدون ضمانات مناسبة، يمكن أن تصبح webhooks الخاصة بك مصدرًا لعدم اتساق البيانات وثغرات أمنية. تشرح هذه المقالة كيفية تنفيذ الحمولات الموقعة وآليات إعادة المحاولة لجعل webhooks الخاصة بك موثوقة وآمنة.
ما هي Webhooks ولماذا تحتاج إلى الأمان؟
Webhooks هي عمليات استدعاء HTTP محددة من قبل المستخدم يتم تشغيلها بواسطة أحداث معينة. وهي تمكن الاتصال في الوقت الفعلي بين الأنظمة، مثل إخطار خدمة الدفع عند تقديم طلب. ومع ذلك، نظرًا لأن webhooks هي نقاط نهاية يمكن الوصول إليها بشكل عام، فهي عرضة للانتحال وهجمات إعادة التشغيل. بالإضافة إلى ذلك، يمكن أن تتسبب مشكلات الشبكة أو تعطل المستقبل في فقدان الأحداث. لذلك، يجب معالجة جانبين حاسمين: الأصالة (عبر الحمولات الموقعة) والموثوقية (عبر إعادة المحاولة).
الحمولات الموقعة: ضمان الأصالة والسلامة
تسمح الحمولة الموقعة للمستقبل بالتحقق من أن webhook نشأت من مصدر موثوق وأن البيانات لم يتم التلاعب بها. يتم تحقيق ذلك عادةً باستخدام HMAC (رمز مصادقة الرسائل القائم على التجزئة) مع سر مشترك.
كيف يعمل توقيع HMAC
يشترك المرسل والمستقبل في مفتاح سري. لكل طلب webhook، يحسب المرسل توقيع HMAC باستخدام السر وحمولة الطلب (غالبًا ما يتضمن طابعًا زمنيًا لمنع هجمات إعادة التشغيل). يتم إرسال التوقيع في رأس، مثل X-Signature. يعيد المستقبل حساب التوقيع ويقارنه بالتوقيع المستلم. إذا تطابقا، يكون الطلب أصيلاً.
إليك مثالاً في Python باستخدام HMAC-SHA256:
import hmac
import hashlib
import time
secret = b'your_shared_secret'
payload = b'{"event":"order.created","id":123}'
timestamp = str(int(time.time())).encode()
message = timestamp + b'.' + payload
signature = hmac.new(secret, message, hashlib.sha256).hexdigest()
# Send headers: X-Signature: signature, X-Timestamp: timestamp
على جانب المستقبل، تحقق من التوقيع وتحقق من الطابع الزمني للتأكد من أن الطلب حديث (على سبيل المثال، خلال 5 دقائق). هذا يمنع هجمات إعادة التشغيل.
أفضل الممارسات للحمولات الموقعة
- استخدم سرًا قويًا: قم بإنشاء سر عشوائي عالي الإنتروبيا وقم بتخزينه بشكل آمن.
- ضمّن طابعًا زمنيًا: ارفض الطلبات ذات الطوابع الزمنية خارج نافذة مقبولة.
- استخدم مقارنة ثابتة الوقت: امنع هجمات التوقيت باستخدام دوال مثل
hmac.compare_digest. - قم بتدوير الأسرار بشكل دوري: اسمح بوجود أسرار نشطة متعددة أثناء التدوير.
آليات إعادة المحاولة: ضمان التسليم الموثوق
حتى مع الحمولات الموقعة، يمكن أن تتسبب أعطال الشبكة أو أخطاء المستقبل في فشل تسليم webhook. تضمن استراتيجية إعادة المحاولة القوية تسليم الأحداث في النهاية دون إرباك المستقبل.
تصميم سياسة إعادة المحاولة
النهج الشائع هو التراجع الأسي مع التشتت. على سبيل المثال، أعد المحاولة بعد دقيقة واحدة، ثم 5 دقائق، ثم 30 دقيقة، حتى الحد الأقصى لعدد المحاولات (على سبيل المثال، 5). قم بتضمين معرف حدث فريد في الحمولة حتى يتمكن المستقبل من إزالة التكرار.
مثال على جدول إعادة المحاولة:
| المحاولة | التأخير |
|---|---|
| 1 | فوري |
| 2 | دقيقة واحدة |
| 3 | 5 دقائق |
| 4 | 30 دقيقة |
| 5 | ساعتان |
بعد استنفاد إعادة المحاولات، انقل الحدث إلى قائمة انتظار الرسائل الميتة للفحص اليدوي.
Idempotency: التعامل مع التسليمات المكررة
نظرًا لأن إعادة المحاولة يمكن أن تسبب تسليمات مكررة، يجب أن يكون المستقبل idempotent. قم بتضمين معرف حدث في الحمولة واطلب من المستقبل تخزين المعرفات المعالجة لتجاهل التكرارات. بدلاً من ذلك، صمم العمليات لتكون idempotent بشكل طبيعي (على سبيل المثال، استخدام PUT بدلاً من POST).
تنفيذ Webhooks: دليل خطوة بخطوة
- حدد الأحداث وهيكل الحمولة: وثّق الأحداث التي يصدرها نظامك ومخطط JSON لكل منها.
- أنشئ سرًا: قم بإنشاء سر فريد لكل نقطة نهاية webhook وشاركه بشكل آمن.
- وقّع كل طلب: احسب HMAC على الحمولة والطابع الزمني، وقم بتضمينه في الرؤوس.
- نفذ إعادة المحاولة مع التراجع: استخدم نظام قائمة انتظار لجدولة إعادة المحاولة.
- وفر طريقة للتحقق من التوقيعات: وثّق عملية التحقق للمستقبلين.
- راقب وسجل: تتبع محاولات التسليم والفشل لتصحيح الأخطاء.
المزالق الشائعة وكيفية تجنبها
- تجاهل TLS: استخدم دائمًا HTTPS لحماية الحمولات أثناء النقل.
- عدم التحقق من الطابع الزمني: يسمح بهجمات إعادة التشغيل.
- إعادة المحاولة إلى أجل غير مسمى: يمكن أن يسبب استنفاد الموارد؛ ضع حدًا أقصى.
- افتراض التسليم الفوري: صمم للمعالجة غير المتزامنة.
الأسئلة الشائعة
ما هي حمولة webhook الموقعة؟
تتضمن حمولة webhook الموقعة توقيعًا تشفيريًا (مثل HMAC) يسمح للمستقبل بالتحقق من أصالة المرسل وسلامة البيانات.
كم مرة يجب أن أعيد محاولة webhook فاشل؟
عادةً من 3 إلى 5 مرات مع التراجع الأسي. يعتمد العدد الدقيق على اتفاقية مستوى الخدمة (SLA) وأهمية الحدث.
هل يمكنني استخدام JWT بدلاً من HMAC لتوقيعات webhook؟
نعم، يمكن استخدام JWT، لكن HMAC أبسط وأكثر شيوعًا لتوقيع webhook. يضيف JWT عبئًا إضافيًا وهو أكثر ملاءمة لرموز المصادقة.
هل أنت مستعد لاختبار حمولات webhook الخاصة بك؟ استخدم منسق JSON للتحقق من حمولات JSON الخاصة بك وتجميلها قبل الإرسال.