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

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

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

  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 للتعرّف على الرموز المميّزة المحتملة لوضع الحماية). وقد لا يسمح أيضًا سياسة أمان المحتوى (CSP) التي تحددها بتحميل محتوى ويب خارجي داخل صفحات محمية في وضع الحماية.

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

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

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