انتقل إلى المحتوى

سياسة أمان المحتوى (CSP)

سياسة أمان المحتوى (CSP) تعليمات يرسلها الموقع إلى المتصفح لتقييد ما تحمّله الصفحة وتشغّله، وهي طبقة دفاع ضد حقن السكربتات عبر المواقع (XSS).

بالإنجليزية:Content Security Policyآخر تحديث

في هذه الصفحة

التعريف

  • سياسة أمان المحتوى (Content Security Policy، واختصارها CSP) سلسلة تعليمات من الموقع إلى المتصفح، يقيّد بها ما يحق للكود الذي تتكون منه الصفحة أن يفعله. وتقول MDN إن استعمالها الرئيس التحكم في الموارد، وفي مقدمتها JavaScript، التي يحق للمستند تحميلها، دفاعاً عن هجمات حقن السكربتات عبر المواقع (XSS).
  • تصل السياسة في ترويسة الرد Content-Security-Policy، وتنصح MDN بضبطها على كل الردود لا على المستند الرئيس وحده. وتتألف من توجيهات تفصل بينها فواصل منقوطة، لكل توجيه اسم تليه قيمته. فالتوجيه default-src 'self' يطلب ألا يُحمَّل إلا ما كان من أصل المستند نفسه، ما لم يحدد توجيه أخص غير ذلك.
  • من التوجيهات: script-src لمصادر JavaScript، وdefault-src سياسة بديلة لكل مورد لم يُذكر له توجيه، وframe-ancestors لمن يحق له تضمين الصفحة في إطار مثل <iframe>.
  • الترويسة Content-Security-Policy-Report-Only تجرّب سياسة دون فرضها: لا تمنع شيئاً، لكن المخالفات تُرسل إلى نقطة الإبلاغ المحددة في السياسة. ويمكن أيضاً وضع السياسة في وسم <meta http-equiv="Content-Security-Policy">، لكنه لا يدعم كل الميزات.

لماذا يهم

  • حقن السكربتات أن يدسّ أحدهم سكربتاً في صفحتك، عبر تعليق أو حقل بحث مثلاً، فيشغّله المتصفح كأنه منك. فإذا جاء السكربت من مصدر لا تسمح به السياسة، لم يشغّله المتصفح.
  • تصف MDN وW3C السياسة بأنها دفاع على طبقات: تحدّ من ضرر الحقن، ولا تغني عن تنقية المدخلات وترميز المخرجات قبل عرضها.
  • إذا كان في السياسة default-src أو script-src حُجب JavaScript المضمّن، أي <script> المكتوب في الصفحة ومعالجات الأحداث مثل onclick وروابط javascript:، إلا إذا اتُّخذت إجراءات إضافية لتمكينه. لذلك تحتاج الصفحة التي تحمّل سكربتات من مواقع أخرى، أو فيها سكربتات مضمّنة، سياسة تذكر هذه المصادر.
  • وتذكر MDN أن CSP تُستعمل أيضاً للحماية من تضمين الصفحة في إطارات خادعة (clickjacking)، وللمساعدة في ضمان تحميل صفحات الموقع عبر HTTPS. وللتوسع في ذلك انظر HSTS والمحتوى المختلط.
  • تتحقق قاعدة csp-missing في Arablyzer من وجود سياسة مفروضة، لا من إحكامها: فالترويسة Content-Security-Policy-Report-Only وحدها لا تُحسب.

مثال

ابدأ بسياسة تجريبية تُبلغ بالمخالفات ولا تمنع شيئاً. تقول MDN إن التوجيه report-to لازم في هذه الترويسة وإلا فلا يُرسل شيء، ويُعرَّف المقصد في الترويسة Reporting-Endpoints:

http
Reporting-Endpoints: csp-endpoint="https://example.com/csp-reports"
Content-Security-Policy-Report-Only: default-src 'self'; script-src 'self' https://cdn.example.com; report-to csp-endpoint

اقرأ التقارير التي تصل، وعدّل السياسة حتى لا تذكر إلا ما تحتاجه صفحاتك، ثم أرسلها مفروضة:

http
Content-Security-Policy: default-src 'self'; script-src 'self' https://cdn.example.com; frame-ancestors 'none'

وتنصح MDN، ما لم تُرد أن تُضمَّن صفحتك في صفحات الآخرين، بأن تضبط frame-ancestors على 'none'.

أخطاء شائعة

  • الاكتفاء بالترويسة Content-Security-Policy-Report-Only ظناً أنها تحمي: هي تُبلغ ولا تمنع.
  • وضع frame-ancestors أو report-uri أو sandbox في وسم <meta>: تقول W3C إن الوسم لا يدعمها، ولا يدعم Report-Only أيضاً.
  • وضع الوسم <meta> بعد السكربتات: السياسة التي فيه لا تشمل المحتوى الذي يسبقه، وتشجع W3C على وضعه مبكراً.
  • إضافة 'unsafe-inline' لإسكات الأخطاء: تحذّر MDN من أنها تُفقد السياسة معظم الغرض منها. والبديل nonce أو hash.
  • nonce ثابت أو يمكن توقعه: يجب أن يتغير مع كل رد، وألا يمكن التنبؤ به (MDN).
  • اعتبار السياسة بديلاً عن تنقية ما يكتبه الزوار.