ربط المتجر بخدمة خارجية عبر webhook لا يعني أن كل طلب يصل إلى الرابط موثوق أو أنه يجب تنفيذ أثره فورًا. قد تُعاد الرسالة، أو تصل متأخرة، أو يرسل مهاجم طلبًا مشابهًا. حماية webhook في المتجر تحتاج تحققًا من المصدر على البيانات الخام، ومنعًا للتكرار، وحفظًا سريعًا قبل المعالجة الحساسة.
تحقق من التوقيع قبل قراءة الأثر
توضح وثائق Shopify للتحقق من تسليم webhooks أن كل تسليم HTTPS يحتوي توقيع HMAC ومعرف تسليم فريد، وأن التوقيع يُحسب من جسم الطلب الخام. إذا حوّل إطار العمل الجسم إلى JSON ثم أعاد ترتيبه قبل التحقق، قد تفشل المقارنة رغم صحة الرسالة أو تُبنى حماية غير دقيقة.
اقرأ البايتات الخام، احسب HMAC بالمفتاح السري داخل الخادم، وقارن القيم بطريقة آمنة زمنيًا. لا تسجل المفتاح أو التوقيع مع بيانات العميل في سجلات الدعم. إذا فشل التحقق، أعد استجابة رفض ولا تغيّر المخزون أو الطلب.
افصل الاستلام عن المعالجة
تشرح وثائق Shopify لاستكشاف webhooks أهمية مراقبة التسليم والفشل والتأخير، وتشير إلى أن المعالجة الطويلة قد تسبب timeout وأن الطلب ينبغي أن يتلقى استجابة سريعة. بعد التحقق، احفظ الحدث في طابور موثوق مع معرف التسليم والموضوع والوقت، ثم أعد الاستجابة قبل تنفيذ عمل بطيء.
أنشئ قيدًا فريدًا على معرف التسليم أو مفتاح العملية. إذا وصل الحدث نفسه مجددًا، تعرّف عليه ولا تعيد الأثر. وإذا كان حدثان مختلفان يعدلان المورد نفسه، قارن وقت التغيير أو اقرأ الحالة الحالية قبل الكتابة.
يمكن توضيح هذه المتطلبات ضمن خدمة إنشاء متجر Shopify. والمقال المكمل إشعارات Shopify المتعثرة: كيف تنظم الاستعادة دون تكرار التنفيذ؟ يشرح ما بعد فشل المعالجة.
ثلاث خطوات لاختبار الأمان والتكرار
- أرسل طلبًا بتوقيع صحيح إلى بيئة اختبار، ثم طلبًا بجسم معدل مع التوقيع نفسه. يجب قبول الأول ورفض الثاني قبل أي كتابة. اختبر أيضًا غياب الرأس أو استخدام سر قديم بعد تدوير المفاتيح.
- أعد التسليم الصحيح مرتين بالمعرف نفسه. يجب أن يسجل النظام محاولة مكررة من دون إنشاء شحنة أو فاتورة أو تعديل مخزون مرة ثانية.
- أرسل حدثين صحيحين بترتيب معكوس، ثم اجعل المعالج يتوقف بعد استدعاء خدمة خارجية وقبل حفظ النتيجة. عند الاستعادة، ابحث عن إيصال المزود قبل إعادة العملية غير المحسومة.
اختبر ببيانات وهمية ولا تستخدم طلب عميل حقيقي. احتفظ بسجل الحالة: received وverified وqueued وprocessing وcompleted وfailed أو uncertain، مع سبب مفهوم ووقت كل انتقال.
مثال افتراضي: شحنة أنشئت والرد انقطع
مثال افتراضي: يستقبل التكامل حدث طلب ويطلب شحنة من الناقل. ينشئ الناقل الشحنة لكن الرد ينقطع، فتظل المهمة غير محسومة. يصل webhook نفسه مرة أخرى. يتعرف النظام على معرف التسليم ولا يعيد التنفيذ تلقائيًا؛ يبحث أولًا عن مرجع الطلب لدى الناقل، ثم يحفظ رقم الشحنة الموجود.
في سيناريو آخر يصل طلب بتوقيع غير صحيح لكنه يحمل رقم طلب صالحًا. يرفضه النظام قبل القراءة التشغيلية. المثال يوضح حدود الثقة ولا يعني أن جميع المزودين يوفرون البحث بالطريقة نفسها.
قائمة مراجعة حماية webhook
- هل يتحقق الخادم من HMAC على الجسم الخام؟
- هل يبقى السر في الخادم ولا يظهر في المتصفح أو السجلات؟
- هل يوجد معرف فريد للتسليم ومنع للتكرار؟
- هل تُحفظ الرسالة سريعًا قبل المعالجة الطويلة؟
- هل تعود الاستجابة ضمن المهلة المطلوبة؟
- هل تفرّق بين failed وuncertain؟
- هل تتحقق من إيصال المزود قبل إعادة أثر حساس؟
- هل اختبرت الأحداث المتأخرة والمعكوسة وتدوير السر؟
الحماية الجيدة لا تفترض وصولًا واحدًا ولا ترتيبًا مثاليًا. صمّم المعالج بحيث يمكن مراجعة كل نتيجة واستعادتها من دون تكرار أثر تجاري أو كشف بيانات حساسة.
المراجع والمصادر
محتوى إرشادي أُعد بمساعدة الذكاء الاصطناعي. الأمثلة افتراضية للتوضيح، وليست نتائج لعملاء تمايز.
تمايز للتسويق وتطوير المتاجر الإلكترونيةتقنية وتسويق
نسمعك