سرفصل‌ها درس 67 از 156 · سیاست امنیت محتوا و قاب‌گذاری
سیاست امنیت محتوا و قاب‌گذاری

Trusted Types

چرا مهم است CSP تگ‌های اسکریپت تزریق‌شده را مسدود می‌کند. اما بسیاری از باگ‌های مدرن درون JavaScript خود شما زندگی می‌کنند: خطی مانند box.innerHTML = comment متن یک بازدیدکننده را به HTML زنده تبدیل می‌کند. این همان تزریق مبتنی بر DOM از ماژول 10 (درس 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 روشنش می‌کند، که زیر آن این sinkها فقط شیءهای ویژه‌ای (TrustedHTML، TrustedScript، TrustedScriptURL) را می‌پذیرند که یک سیاست ساخته است، تابعی کوچک که خودتان می‌نویسید و نام می‌گذارید. یک رشتهٔ ساده که به یک sink داده شود به‌جای اجرا خطا می‌دهد.

روشن‌کردنش

Content-Security-Policy: require-trusted-types-for 'script'; trusted-types comments
  • require-trusted-types-for 'script': آن را روی همهٔ sinkهای مرتبط با اسکریپت اجرا کن.
  • 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). بازدیدکنندگانی که مرورگر قدیمی‌تر دارند به‌سادگی بررسی اضافه را نمی‌گیرند، پس فرار دادن و CSP مبتنی بر nonce را نگه دارید. کد می‌تواند با if (window.trustedTypes) آن را بیازماید.

آن را مثل هر سیاستی عرضه کنید: require-trusted-types-for 'script' را اول در یک سرآیند Content-Security-Policy-Report-Only بفرستید. هر رشته‌ای که به یک sink برسد گزارش می‌شود، و دقیقاً نشان می‌دهد کدام خط‌ها به یک سیاست، یا بهتر، به تغییر به textContent نیاز دارند.

یک تصور نادرست رایج: «Trusted Types HTML را برایم پاک‌سازی می‌کند». هیچ چیز را پاک نمی‌کند. رشته‌ها را وادار می‌کند از سیاست شما بگذرند. سیاستی که ورودی‌اش را بی‌تغییر برمی‌گرداند (createHTML: s => s) از بررسی می‌گذرد و از هیچ چیز محافظت نمی‌کند.

خلاصه

  • تزریق DOM در JavaScript خود شما در sinkهایی مانند innerHTML رخ می‌دهد؛ قواعد تگ اسکریپت به‌تنهایی آن را نمی‌گیرند.
  • require-trusted-types-for 'script' باعث می‌شود sinkها رشته‌های ساده را رد کنند؛ trusted-types NAME محدود می‌کند کدام سیاست‌ها می‌توانند وجود داشته باشند.
  • به‌جای هر sink، چند تابع سیاست را بازبینی کنید، و هر جا می‌توانید textContent را ترجیح دهید.
  • در همهٔ موتورهای اصلی پشتیبانی می‌شود (بررسی‌شده در اکتبر 2026)؛ اول در report-only عرضه کنید.

مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید

این تمرین به‌زودی باز می‌شود

درس پیش از آن را تمام کنید تا این یکی باز شود. کل دوره رایگان است، حساب کاربری لازم نیست، و می‌توانید همین الان این درس را بخوانید.