cloudflare-turnstile

Status: Production Ready Last Updated: 2025-10-22 Dependencies: None (optional: @marsidev/react-turnstile for React) Latest Versions: @marsidev/react-turnstile@1.3.1, turnstile-types@1.2.3

ALWAYS validate the token server-side. Client-side verification alone is not secure.

✅ Call Siteverify API - Server-side validation is mandatory ✅ Use HTTPS - Never validate over HTTP ✅ Protect secret keys - Never expose in frontend code ✅ Handle token expiration - Tokens expire after 5 minutes ✅ Implement error callbacks - Handle failures gracefully ✅ Use dummy keys for testing - Test sitekey: 1x00000000000000000000AA

توفر هذه المهارة معرفة شاملة لتطبيق Cloudflare Turnstile، وهو نظام حماية الروبوتات البديل لـ CAPTCHA. ويجب استخدامه عند دمج حماية الروبوتات في النماذج، أو صفحات تسجيل الدخول، أو تدفقات الاشتراك، أو أي ميزة تواجه المستخدم وتتطلب منع البريد العشوائي/الروبوتات. يدير Turnstile تحديات غير مرئية في الخلفية، مما يحافظ على تجربة مستخدم ممتازة مع حظر حركة المرور الآلية. يُستخدم عندما: إضافة حماية الروبوت إلى النماذج، أو تنفيذ أمان تسجيل الدخول، أو حماية نقاط نهاية API من سوء الاستخدام، أو الترحيل من reCAPTCHA/hCaptcha، أو مواجهة أخطاء CSP مع Turnstile، أو التعامل مع فشل التحقق من صحة الرمز المميز، أو تنفيذ اختبارات E2E مع Turnstile، أو التكامل مع تطبيقات React/Next.js/Hono، أو تصحيح رموز الخطأ 100*، 300*، 600*. الكلمات الرئيسية: الباب الدوار، كلمة التحقق، حماية الروبوت، تحدي Cloudflare، التحقق من الموقع، بديل recaptcha، منع البريد العشوائي، حماية النماذج، cf-turnstile، أداة الباب الدوار، التحقق من الرمز المميز، التحدي المُدار، التحدي غير المرئي، @marsidev/react-turnstile، hono Turnstile، العمال الدوار المصدر: jackspace/claudeskillz.