पाठ्यक्रम 156 में से पाठ 67 · Content Security Policy और framing
Content Security Policy और framing

Trusted Types

यह क्यों मायने रखता है CSP injected script tags रोकता है। पर कई आधुनिक bugs आपके अपने JavaScript के अंदर रहते हैं: box.innerHTML = comment जैसी एक पंक्ति एक आगंतुक के टेक्स्ट को जीवित HTML में बदल देती है। यह मॉड्यूल 10 (पाठ 59) का DOM-आधारित injection है, और यह पन्ना load होने के बाद होता है। Trusted Types ब्राउज़र को उन ख़तरनाक पंक्तियों को मना करने पर मजबूर करता है जब तक मान आपकी लिखी एक जाँच से न गुज़रा हो।

एक कारख़ाने की कल्पना करें जहाँ सिर्फ़ निरीक्षण की मुहर वाले पुर्ज़े assembly line पर जा सकते हैं। कोई भी car park में मिला एक रैंडम पुर्ज़ा नहीं लगा सकता, संयोग से भी नहीं। Trusted Types वह मुहर उन strings में जोड़ता है जो आपका code ख़तरनाक जगहों में डालता है।

DOM: Document Object Model का छोटा रूप, elements का वह जीवित पेड़ जो ब्राउज़र एक पन्ने से बनाता है, जिसे JavaScript पढ़ और बदल सकता है।

Sink: DOM में एक जगह जहाँ एक string code या markup बन जाती है। उदाहरण: element.innerHTML, outerHTML, insertAdjacentHTML, document.write, iframe.srcdoc, eval और setTimeout के string arguments, और script.src।

Trusted Types: एक ब्राउज़र feature, CSP से चालू, जिसके तहत वे sinks सिर्फ़ ख़ास objects (TrustedHTML, TrustedScript, TrustedScriptURL) स्वीकार करते हैं जो एक policy, एक छोटा function जो आप लिखते और नाम देते हैं, से बने हों। एक sink को दी गई सादी string चलने के बजाय error फेंकती है।

इसे चालू करना

Content-Security-Policy: require-trusted-types-for 'script'; trusted-types comments
  • require-trusted-types-for 'script': इसे सारे script से जुड़े sinks पर लागू करें।
  • trusted-types comments: वह अकेला policy नाम जो आपका code बना सकता है। एक injected script किसी दूसरे नाम से अपनी policy register नहीं कर सकती। trusted-types 'none' कोई भी बनाना मना करता है।

इसे अपने code में इस्तेमाल करना

// 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

बड़ी जीत समीक्षकों के लिए है। एक बड़े codebase में हर innerHTML खोजने के बजाय, आप कुछ policy functions की समीक्षा करते हैं। अगर वे सुरक्षित हैं, तो ब्राउज़र लागू करता है कि बाक़ी सब उनसे गुज़रे।

default नाम की policy ख़ास है: जब भी एक सादी string एक sink तक पहुँचती है, ब्राउज़र उसे अपने आप बुलाता है। यह पुराना code बदलते समय काम की है, पर यह ऐसी जगह भी है जहाँ ग़लतियाँ छिपती हैं, इसलिए इसे सख़्त रखें और जो गुज़रे उसे log करें।

समर्थन और rollout

Trusted Types सारे बड़े engines में समर्थित है: Chromium-आधारित ब्राउज़र, Safari 26 और Firefox 148 (अक्टूबर 2026 में जाँचा)। पुराने ब्राउज़रों पर आगंतुकों को बस अतिरिक्त जाँच नहीं मिलती, इसलिए escaping रखें और अपना nonce-आधारित CSP रखें। Code इसे if (window.trustedTypes) से जाँच सकता है।

इसे किसी भी policy की तरह लागू करें: पहले require-trusted-types-for 'script' एक Content-Security-Policy-Report-Only header में भेजें। एक sink तक पहुँचने वाली हर string रिपोर्ट होती है, आपको ठीक दिखाते हुए कि किन पंक्तियों को एक policy की, या बेहतर, textContent पर जाने की ज़रूरत है।

एक आम ग़लतफ़हमी: "Trusted Types मेरे लिए HTML साफ़ करता है"। यह कुछ साफ़ नहीं करता। यह strings को आपकी policy से गुज़रने पर मजबूर करता है। एक policy जो अपना input बिना बदले लौटाए (createHTML: s => s) जाँच पास करती है और कुछ नहीं बचाती।

सार

  • DOM injection आपके अपने JavaScript में innerHTML जैसे sinks पर होता है; अकेले script-tag नियम उसे नहीं पकड़ते।
  • require-trusted-types-for 'script' sinks को सादी strings मना करवाता है; trusted-types NAME सीमित करता है कि कौन-सी policies हो सकती हैं।
  • हर sink के बजाय कुछ policy functions की समीक्षा करें, और जहाँ हो सके textContent को तरजीह दें।
  • सारे बड़े engines में समर्थित (अक्टूबर 2026 में जाँचा); पहले report-only में लागू करें।

इस पाठ में कोई समस्या दिखी? बताएँ · इस पाठ के बारे में पूछें

यह अभ्यास जल्द खुलेगा

इससे पहले वाला पाठ पूरा करें और यह खुल जाएगा। पूरा कोर्स मुफ़्त है, कोई खाता नहीं चाहिए, और आप यह पाठ अभी पढ़ सकते हैं।