انتقل إلى المحتوى
تمايز للتسويق وتطوير المتاجر الإلكترونيةتقنية وتسويقالعودة للمتجر
القائمة

تمايز / معلومات تهمك

كيف تنفذ تحقق Turnstile من الخادم لحماية نموذج الطلب؟

شرح عملي لدمج Cloudflare Turnstile في نموذج الطلب والتحقق من الرمز عبر Siteverify ومنع إعادة الاستخدام دون تعطيل العملاء.

يعطي تحقق Turnstile من الخادم نموذج الطلب طبقة تمنع قبول رمز مزور أو منتهي أو مستخدم سابقًا. إضافة الودجت في المتصفح وحدها لا تحمي نقطة الإرسال؛ يستطيع عميل آلي تجاوز الواجهة وإرسال الطلب مباشرة. لذلك يجب إرسال الرمز إلى خادم المتجر والتحقق منه عبر Siteverify قبل إنشاء الطلب أو الموعد أو التذكرة.

توضح Cloudflare أن الرمز قصير العمر ويُستخدم مرة واحدة، وأن التحقق الخادمي إلزامي لاكتمال الدمج. كما يمكن عرض الودجت ضمن صفحة ثابتة أو إنشائه صراحة في تطبيق ديناميكي، لكن النتيجة النهائية يجب أن تمر عبر الخادم.

أين تضع Turnstile في رحلة الطلب؟

ضعه قبل العملية التي تريد حمايتها: إرسال نموذج تواصل، إنشاء حساب، طلب عرض سعر، أو تأكيد خطوة حساسة. لا تنشئ الرمز عند فتح الصفحة ثم تترك العميل يملأ نموذجًا طويلًا؛ قد تنتهي صلاحيته قبل الإرسال. في النماذج الديناميكية، استخدم العرض الصريح عندما يصبح النموذج جاهزًا.

يمكن حماية نماذج خدمة إنشاء موقع خدمات مع إبقاء مفتاح الموقع عامًا في الواجهة، وحفظ المفتاح السري في متغيرات الخادم فقط. لا تضع السر في JavaScript أو HTML أو سجل المتصفح.

كيف يعمل التحقق من الخادم؟

يرسل المتصفح رمز Turnstile مع حقول النموذج. يستقبل الخادم الطلب، ثم يرسل secret وresponse إلى Siteverify. إذا عاد success=true، يفحص الخادم بيانات إضافية مثل hostname وaction عند استخدامها، ثم ينفذ العملية. إذا فشل التحقق، يرفض العملية ويطلب رمزًا جديدًا برسالة قابلة للفهم.

  1. أنشئ الودجت للنطاق والبيئة المناسبة واحصل على الرمز عند الإرسال.
  2. أرسل الرمز إلى الخادم، واستدعِ Siteverify من الخادم فقط.
  3. اقبل العملية بعد نجاح التحقق ومطابقة السياق، وسجل النتيجة دون حفظ السر.

تذكر Cloudflare أن الرمز صالح لخمس دقائق ويُستخدم مرة واحدة. لا تخزن رمزًا لاستخدامه في طلبات لاحقة، ولا تُعد محاولة التحقق بالرمز نفسه بعد timeout-or-duplicate؛ اطلب من الواجهة إعادة إنشاء التحدي.

كيف تمنع الخطأ في التطبيقات الديناميكية؟

في SPA قد يُزال النموذج ويُعاد إنشاؤه من دون تحميل الصفحة. استخدم turnstile.render عند ظهور الحاوية، واحفظ widgetId لإعادة الضبط أو الإزالة. لا تنشئ نسخًا متعددة فوق العنصر نفسه. عند انتهاء الرمز أو فشل الشبكة، أعِد ضبط الودجت وأبقِ بيانات النموذج التي كتبها العميل.

افصل ودجت الإنتاج عن الاختبار، وقيّد hostnames بالنطاقات التي تملكها. استخدم مفاتيح الاختبار التي توفرها Cloudflare في بيئة التطوير بدل إرسال نتائج وهمية إلى الإنتاج. واقرأ تفعيل HSTS في Cloudflare قبل تشديد HTTPS على النطاقات الفرعية، لأن حماية النموذج تعتمد أيضًا على اتصال صحيح ومستقر.

مثال افتراضي

مثال افتراضي: موقع خدمات يضيف Turnstile إلى نموذج الحجز ويخفي زر الإرسال بعد نجاح الودجت، لكنه لا يتحقق من الرمز في الخادم. يرسل روبوت طلب POST مباشرة إلى نقطة الحجز فينشئ مواعيد وهمية لأن الخادم يثق في الحقل القادم من المتصفح.

يصلح الفريق التدفق بإرسال الرمز إلى Siteverify، ورفض أي طلب بلا success، ومطابقة hostname وaction. يضيف مفتاحًا فريدًا للطلب حتى لا يؤدي ضغط العميل مرتين إلى حجزين. ثم يختبر النجاح والفشل والانتهاء وإعادة الاستخدام.

كيف تراقب الأخطاء دون إزعاج العملاء؟

سجل رمز الخطأ ووقت الطلب والمسار وبيئة الودجت، لكن لا تسجل السر أو بيانات العميل الكاملة. فرّق بين فشل التحدي وبين تعذر الاتصال بخدمة التحقق. في الحالة الثانية لا تنشئ الطلب بصمت؛ اعرض رسالة مؤقتة واسمح بإعادة المحاولة برمز جديد.

راقب نسبة الفشل حسب الصفحة والإصدار. ارتفاع timeout-or-duplicate قد يعني أن الرمز يُنشأ مبكرًا أو أن الواجهة تعيد الإرسال. ارتفاع hostname mismatch قد يعني مفتاحًا مستخدمًا على نطاق غير مسموح. نفذ اختبارًا يدويًا بعد كل تغيير في النطاق أو CSP.

قائمة مراجعة

  • [ ] المفتاح السري محفوظ في الخادم فقط.
  • [ ] الرمز يُرسل مع الطلب إلى نقطة الخادم.
  • [ ] Siteverify يُستدعى قبل تنفيذ العملية.
  • [ ] success وhostname وaction تُراجع حسب الإعداد.
  • [ ] الرمز المنتهي أو المستخدم يعاد إنشاؤه.
  • [ ] لا تتكرر الودجت في الواجهة الديناميكية.
  • [ ] يوجد مفتاح فريد لمنع تكرار الطلب نفسه.
  • [ ] السجلات لا تحتوي أسرارًا أو بيانات عميل زائدة.
  • [ ] اختُبرت حالات النجاح والفشل وانقطاع الشبكة.

المصادر الرسمية

بهذا التصميم يصبح Turnstile جزءًا من قرار الخادم، لا مجرد عنصر مرئي. وهو يقلل الطلبات الآلية لكنه لا يغني عن التحقق من الحقول وحدود المعدل ومنع التكرار.

المراجع والمصادر

محتوى إرشادي أُعد بمساعدة الذكاء الاصطناعي. الأمثلة افتراضية للتوضيح، وليست نتائج لعملاء تمايز.

نسمعك

اكتب سؤالك أو ملاحظتك. يُنشر التعليق بعد المراجعة، ويبقى البريد خاصًا.