المنهج الدراسي الدرس 67 من 156 · سياسة أمن المحتوى والتأطير
سياسة أمن المحتوى والتأطير

الأنواع الموثوقة

لماذا هذا مهم كتل CSP المحقونة وسوم script. لكن العديد من الثغرات الحديثة توجد داخل JavaScript الخاصة بك: سطر مثل box.innerHTML = comment يحول نصاً من زائر إلى HTML نشط. هذا هو الحقن المستند إلى DOM من Module 10 (Lesson 59)، ويحدث بعد تحميل الصفحة. Trusted Types تجعل المتصفح يرفض تلك الأسطر الخطيرة ما لم تمر القيمة عبر فحص كتبته أنت.

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

DOM: اختصار لـ Document Object Model، وهي شجرة العناصر الحية التي يبنيها المتصفح من الصفحة، والتي يمكن لـ JavaScript قراءتها وتغييرها.

Sink: مكان في الـ DOM حيث يتحول النص إلى كود أو علامات. أمثلة: element.innerHTML، outerHTML، insertAdjacentHTML، document.write، iframe.srcdoc، eval وحجج النص إلى setTimeout، و script.src.

Trusted Types: ميزة في المتصفح، يتم تفعيلها بواسطة CSP، حيث تقبل تلك المصارف كائنات خاصة فقط (TrustedHTML, TrustedScript, TrustedScriptURL) يتم إنشاؤها بواسطة policy، وهي دالة صغيرة تكتبها وتسميها. السلسلة النصية العادية المخصصة للمصرف تسبب خطأ بدلا من التنفيذ.

تشغيله

Content-Security-Policy: require-trusted-types-for 'script'; trusted-types comments
  • require-trusted-types-for 'script': فرض ذلك على جميع sinks المتعلقة بالسكربتات.
  • trusted-types comments: اسم السياسة الوحيد الذي يمكن لكودك إنشاؤه. لا يمكن لسكربت محقون تسجيل سياسة خاصة به تحت اسم آخر. trusted-types 'none' يمنع إنشاء أي منها.

استخدامه في الكود الخاص بك

// The one, reviewed place that turns text into HTML.
const commentsPolicy = trustedTypes.createPolicy("comments", {
  createHTML: (text) => escapeHtml(text),   // or a well-tested sanitiser
});

box.innerHTML = comment;                              // throws TypeError: blocked
box.innerHTML = commentsPolicy.createHTML(comment);   // allowed, escaped
box.textContent = comment;                            // not a sink at all: always fine

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

سياسة

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

الدعم والنشر

يدعم

Trusted Types في جميع المحركات الرئيسية: المتصفحات القائمة على Chromium، وSafari 26، وFirefox 148 (تم التحقق في أكتوبر 2026). الزوار على المتصفحات القديمة لا يحصلون ببساطة على الفحص الإضافي، لذا استمر في استخدام escaping واحتفظ بـ CSP القائم على nonce. يمكن للكود اختبار ذلك باستخدام if (window.trustedTypes).

اطرحها كأي سياسة: أرسل require-trusted-types-for 'script' في ترويسة Content-Security-Policy-Report-Only أولاً. يُبلَغ عن كل نص يصل إلى مَصبّ، فيُظهر لك بالضبط أي الأسطر تحتاج إلى سياسة، أو الأفضل، إلى التحول إلى textContent.

خطأ شائع: "Trusted Types تقوم بتنقية HTML من أجلي". هي لا تنظف أي شيء. هي تجبر النصوص على المرور عبر your policy. السياسة التي تعيد مدخلاتها دون تغيير (createHTML: s => s) تجتاز الفحص ولا تحمي أي شيء.

ملخص

    يحدث حقن
  • DOM في لغة JavaScript الخاصة بك عند نقاط النهاية مثل innerHTML؛ قواعد script-tag وحدها لا تكتشفه.
  • require-trusted-types-for 'script' يجعل sinks ترفض السلاسل النصية البسيطة؛ trusted-types NAME يحدد السياسات التي يمكن أن توجد.
  • راجع دوال السياسة القليلة بدلاً من كل مَصبّ، وفضّل textContent حيث تستطيع.
  • مدعوم في جميع المحركات الرئيسية (تم التحقق في أكتوبر 2026)؛ ابدأ بالنشر في وضع التقرير فقط أولا.

هل لاحظت مشكلة في هذا الدرس؟ أبلغ عنها · اسأل عن هذا الدرس

سيفتح هذا التمرين قريبا

أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.