البيان - وضع الحماية

تحذير: بدءًا من الإصدار 57، لن يسمح Chrome بعرض محتوى ويب خارجي (بما في ذلك الإطارات والبرامج النصية المضمّنة) داخل الصفحات المحمية. يُرجى استخدام عرض ويب بدلاً من ذلك.

تحدّد هذه السمة مجموعة من صفحات التطبيق أو الإضافة التي سيتم عرضها في مصدر فريد ضمن وضع الحماية، ويمكنها أيضًا تحديد "سياسة أمان المحتوى" التي سيتم استخدامها معها. يترتّب على وضع الموقع الإلكتروني في وضع الحماية نتيجتان:

1. لن تتمكّن الصفحة المحمية من الوصول إلى واجهات برمجة التطبيقات الخاصة بالإضافات أو التطبيقات، أو الوصول المباشر إلى الصفحات غير المحمية (يمكنها التواصل معها عبر postMessage()).

2. لا تخضع الصفحة المحصورة في بيئة الاختبار المعزولة لسياسة أمان المحتوى (CSP) التي تستخدمها بقية التطبيق أو الإضافة (بل تتضمّن قيمة CSP منفصلة خاصة بها). وهذا يعني أنّه يمكنه، على سبيل المثال، استخدام نص برمجي مضمّن وeval.

   على سبيل المثال، إليك كيفية تحديد أنّه سيتم عرض صفحتَي إضافة في بيئة اختبار مع سياسة أمان محتوى مخصّصة:

   {
     ...
     "sandbox": {
       "pages": [
         "page1.html",
         "directory/page2.html"
       ]
       // content_security_policy is optional.
       "content_security_policy":
           "sandbox allow-scripts; script-src 'self'"
     ],
     ...
   }
   

   إذا لم يتم تحديدها، تكون القيمة التلقائية content_security_policy هي sandbox allow-scripts allow-forms allow-popups allow-modals; script-src 'self' 'unsafe-inline' 'unsafe-eval'; child-src 'self';. يمكنك تحديد قيمة CSP لفرض المزيد من القيود على وضع الحماية، ولكن يجب أن تتضمّن التوجيه sandbox وألا تتضمّن الرمز المميّز allow-same-origin (راجِع مواصفات HTML5 لمعرفة الرموز المميّزة المحتملة لوضع الحماية). بالإضافة إلى ذلك، قد لا تسمح "سياسة أمان المحتوى" التي تحدّدها بتحميل محتوى ويب خارجي داخل الصفحات المحمية.

يُرجى العلم أنّه عليك إدراج الصفحات التي تتوقّع تحميلها في النوافذ أو الإطارات فقط. لا يلزم أن تظهر الموارد التي تستخدمها الصفحات المحصورة (مثل أوراق الأنماط أو ملفات مصدر JavaScript) في القائمة sandboxed_page، بل ستستخدم الحماية التي توفّرها الصفحة التي تضمّنها.

"استخدام eval في إضافات Chrome تقدّم المقالة "استخدام بيئة الاختبار المعزولة بأمان" تفاصيل أكثر حول تنفيذ سير عمل في بيئة الاختبار المعزولة يتيح استخدام المكتبات التي قد تواجه مشاكل في التنفيذ بموجب سياسة أمان المحتوى التلقائية للإضافة.

لا يمكن تحديد الصفحة المحصورة في بيئة الاختبار إلا عند استخدام الإصدار manifest_version 2 أو إصدار أحدث.