شرح Webhooks: الحمولات الموقعة واستراتيجيات إعادة المحاولة

Backend2026-11-12TryQuickToolBox

لقد قمت ببناء 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 دقائق). هذا يمنع هجمات إعادة التشغيل.

أفضل الممارسات للحمولات الموقعة

آليات إعادة المحاولة: ضمان التسليم الموثوق

حتى مع الحمولات الموقعة، يمكن أن تتسبب أعطال الشبكة أو أخطاء المستقبل في فشل تسليم webhook. تضمن استراتيجية إعادة المحاولة القوية تسليم الأحداث في النهاية دون إرباك المستقبل.

تصميم سياسة إعادة المحاولة

النهج الشائع هو التراجع الأسي مع التشتت. على سبيل المثال، أعد المحاولة بعد دقيقة واحدة، ثم 5 دقائق، ثم 30 دقيقة، حتى الحد الأقصى لعدد المحاولات (على سبيل المثال، 5). قم بتضمين معرف حدث فريد في الحمولة حتى يتمكن المستقبل من إزالة التكرار.

مثال على جدول إعادة المحاولة:

المحاولةالتأخير
1فوري
2دقيقة واحدة
35 دقائق
430 دقيقة
5ساعتان

بعد استنفاد إعادة المحاولات، انقل الحدث إلى قائمة انتظار الرسائل الميتة للفحص اليدوي.

Idempotency: التعامل مع التسليمات المكررة

نظرًا لأن إعادة المحاولة يمكن أن تسبب تسليمات مكررة، يجب أن يكون المستقبل idempotent. قم بتضمين معرف حدث في الحمولة واطلب من المستقبل تخزين المعرفات المعالجة لتجاهل التكرارات. بدلاً من ذلك، صمم العمليات لتكون idempotent بشكل طبيعي (على سبيل المثال، استخدام PUT بدلاً من POST).

تنفيذ Webhooks: دليل خطوة بخطوة

  1. حدد الأحداث وهيكل الحمولة: وثّق الأحداث التي يصدرها نظامك ومخطط JSON لكل منها.
  2. أنشئ سرًا: قم بإنشاء سر فريد لكل نقطة نهاية webhook وشاركه بشكل آمن.
  3. وقّع كل طلب: احسب HMAC على الحمولة والطابع الزمني، وقم بتضمينه في الرؤوس.
  4. نفذ إعادة المحاولة مع التراجع: استخدم نظام قائمة انتظار لجدولة إعادة المحاولة.
  5. وفر طريقة للتحقق من التوقيعات: وثّق عملية التحقق للمستقبلين.
  6. راقب وسجل: تتبع محاولات التسليم والفشل لتصحيح الأخطاء.

المزالق الشائعة وكيفية تجنبها

الأسئلة الشائعة

ما هي حمولة webhook الموقعة؟

تتضمن حمولة webhook الموقعة توقيعًا تشفيريًا (مثل HMAC) يسمح للمستقبل بالتحقق من أصالة المرسل وسلامة البيانات.

كم مرة يجب أن أعيد محاولة webhook فاشل؟

عادةً من 3 إلى 5 مرات مع التراجع الأسي. يعتمد العدد الدقيق على اتفاقية مستوى الخدمة (SLA) وأهمية الحدث.

هل يمكنني استخدام JWT بدلاً من HMAC لتوقيعات webhook؟

نعم، يمكن استخدام JWT، لكن HMAC أبسط وأكثر شيوعًا لتوقيع webhook. يضيف JWT عبئًا إضافيًا وهو أكثر ملاءمة لرموز المصادقة.

هل أنت مستعد لاختبار حمولات webhook الخاصة بك؟ استخدم منسق JSON للتحقق من حمولات JSON الخاصة بك وتجميلها قبل الإرسال.