Lorixen.
AR

خطأ 403 CSRF في Django بعد تفعيل HTTPS: الأصول الموثوقة

باختصار: إذا كان نظامك المبني بـ Django يعمل جيداً، ثم بعد تفعيل HTTPS أو وضع الموقع خلف Cloudflare أو خادم وسيط، بدأ تسجيل الدخول إلى لوحة الإدارة وإرسال النماذج يرجع خطأ 403 مع رسالة عن فشل التحقق من CSRF، فالمشكلة غالباً في فحص الأصل. توثيق Django يشرح أن حماية CSRF تطلب، في الطلبات التي تحمل ترويسة Origin، أن تطابق هذه الترويسة الأصل الموجود في ترويسة Host، وأن الإعداد CSRF_TRUSTED_ORIGINS قائمة بالأصول الموثوقة. الحل: أن يعرف Django أن الطلب جاء أصلاً عبر HTTPS، أو أن تضيف الأصل الصحيح بصيغته الكاملة مع https إلى قائمة الأصول الموثوقة.

كيف تظهر المشكلة؟

مكتب محاماة في عمّان لديه نظام داخلي لإدارة القضايا مبني بـ Django. كان يعمل على عنوان داخلي، ثم قرر المكتب نشره على نطاق فرعي بشهادة HTTPS ليصل إليه المحامون من خارج المكتب. نقل المطور النظام، وأعد خادماً وسيطاً يستقبل HTTPS ويمرر الطلبات إلى Django.

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

ما هي حماية CSRF باختصار؟

توثيق Django عن الحماية من تزوير الطلبات عبر المواقع يشرح أنه لكل الطلبات الواردة التي لا تستخدم GET أو HEAD أو OPTIONS أو TRACE، يجب أن يكون ملف تعريف ارتباط CSRF موجوداً، وأن يكون حقل الرمز في النموذج موجوداً وصحيحاً، وإلا يحصل المستخدم على خطأ 403.

ويضيف التوثيق طبقة أخرى: الوسيط المسؤول عن الحماية يتحقق من ترويسة Origin إذا أرسلها المتصفح، مقارنة بالمضيف الحالي وبالإعداد CSRF_TRUSTED_ORIGINS، وهذا يحمي من الهجمات بين النطاقات الفرعية. وفي طلبات HTTPS التي لا تحمل ترويسة Origin، يجري فحصاً صارماً لترويسة Referer.

أي أن الرمز في النموذج قد يكون صحيحاً تماماً، ومع ذلك يُرفض الطلب لأن فحص الأصل لم ينجح.

لماذا يفشل فحص الأصل خلف خادم وسيط؟

المتصفح يرسل النموذج من صفحة عنوانها يبدأ بـ https، فتحمل ترويسة Origin هذا الأصل. لكن الخادم الوسيط يستقبل HTTPS ثم يمرر الطلب إلى Django عادة عبر اتصال داخلي عادي. إذا لم يُخبَر Django بأن الطلب الأصلي كان آمناً، فقد يعتبر نفسه يعمل على http، فلا يتطابق الأصل الذي يتوقعه مع الأصل الذي أرسله المتصفح.

هذا تفسير للآلية في الحالة الشائعة، والتأكيد يأتي من رسالة الخطأ التفصيلية في بيئة الاختبار أو من سجلات الخادم.

الحل الأول: أخبر Django أن الطلب آمن

توثيق إعدادات Django يشرح الإعداد SECURE_PROXY_SSL_HEADER: ثنائية تمثل ترويسة وقيمة تدلان على أن الطلب آمن، وتتحكم في سلوك الدالة التي تحدد إن كان الطلب آمناً. ويعطي مثالاً يجعل Django يثق بترويسة X-Forwarded-Proto القادمة من الخادم الوسيط، ويعتبر الطلب آمناً عندما تكون قيمتها https.

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

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

الحل الثاني: أضف الأصل إلى القائمة الموثوقة

التوثيق يصف CSRF_TRUSTED_ORIGINS بأنها قائمة بالأصول الموثوقة للطلبات غير الآمنة مثل POST. ويعطي مثالاً على الحاجة إليها: إذا كنت تحتاج طلبات من نطاق فرعي إلى نطاق فرعي آخر، تضيف الأصل بالصيغة الكاملة التي تبدأ بـ https. ويذكر أن الإعداد يدعم النطاقات الفرعية، فيمكن إضافة أصل يبدأ بنجمة قبل النطاق للسماح بكل النطاقات الفرعية.

لاحظ أن القيم في الأمثلة تتضمن المخطط، أي https، لا اسم النطاق وحده. كتابة النطاق دون https من الأخطاء الشائعة.

متى تحتاج هذا الحل؟

  • عندما يرسل نطاق فرعي نموذجاً إلى نطاق آخر، مثل صفحة على النطاق الرئيسي ترسل إلى نظام على نطاق فرعي.
  • كحل مكمل إذا كان النظام خلف وسيط ولا تستطيع ضمان ضبط ترويسة الأمان.

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

الحالة الخاصة: تطبيق جوال أو واجهة منفصلة

إذا كان لنظامك واجهة مبنية بإطار JavaScript على نطاق، والخادم بـ Django على نطاق آخر، فالنماذج ترسل طلبات من أصل مختلف بطبيعتها. هنا قائمة الأصول الموثوقة جزء من التصميم لا حل طارئ، ويجب أن تضم أصل الواجهة بصيغته الكاملة.

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

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

خطوات تشخيص منظمة

  1. افتح الموقع عبر HTTPS وجرّب تسجيل الدخول. سجّل نص رسالة الخطأ.
  2. في بيئة الاختبار فقط، فعّل وضع التصحيح لرؤية السبب التفصيلي للرفض، ثم أطفئه.
  3. تحقق من إعداد الخادم الوسيط: هل يمرر ترويسة تدل على المخطط الأصلي؟
  4. قرر الحل: ترويسة الأمان إذا كان الوسيط تحت سيطرتك، أو القائمة الموثوقة للأصول المحددة.
  5. أعد الاختبار على تسجيل الدخول وكل نموذج مهم، من شبكة المكتب ومن خارجها.

علاقته بإعداد المضيفين المسموحين

إذا نقلت النظام إلى نطاق جديد، فقد تواجه قبل هذا الخطأ خطأً آخر يتعلق بالمضيفين المسموحين، وهو منفصل. حل أحدهما لا يحل الآخر. ضبط المضيفين يسمح لـ Django بخدمة النطاق أصلاً، وضبط الأصول يسمح بقبول النماذج المرسلة منه.

أسئلة شائعة

ليش لوحة إدارة Django بتعطي 403 CSRF بعد ما فعلنا HTTPS؟

غالباً لأن فحص الأصل يفشل: المتصفح يرسل أصلاً يبدأ بـ https، بينما Django خلف الوسيط لا يعرف أن الطلب الأصلي كان آمناً.

شو بكتب في CSRF_TRUSTED_ORIGINS؟

الأصل بصيغته الكاملة مع المخطط، مثل نطاقك مسبوقاً بـ https، كما في أمثلة التوثيق.

هل SECURE_PROXY_SSL_HEADER آمن؟

فقط إذا كنت تتحكم في الخادم الوسيط وتضمن أنه يضبط الترويسة أو يزيلها. التوثيق يحذر أن الضبط الخاطئ قد يعرض الموقع للخطر.

هل أضيف نجمة لكل النطاقات وأرتاح؟

لا. كل أصل تضيفه مسموح له بإرسال طلبات تغير البيانات. أضف فقط ما تحتاجه.

إذا تعطلت نماذج نظامك أو تسجيل الدخول بعد الانتقال إلى HTTPS، تواصل معنا ونضبط الإعدادات معك.

المصادر

WhatsAppاحجز مكالمة