Kurrikulum Leson 67 van 156 · Innhoudsbeveiligingsbeleid en raamwerk
Innhoudsbeveiligingsbeleid en raamwerk

Betroubare Tipes

Waarom dit saak maak CSP blokke wat ingespius wordscript tags. Maar baie moderne foute leef binne jou eie JavaScript: 'n reël soos box.innerHTML = comment verander teks van 'n besoeker in lewendige HTML. Dit is die DOM-gebaseerde inspuiting van Module 10 (Lesson 59), en dit gebeur nadat die bladsy gelaai het. Trusted Types laat die blutser daardie gevaarlike reë weier tensy die waarde deur 'n kontrole gegaan het wat jy geskryf het.

Verbeeld 'n fabriek waar net dele met 'n inspeksiestempel op die assemblinelyn mag gaan. Niemand mag 'n willekeurige deel wat in die parkeerterrein gevind is vasbout nie, selfs nie per ongeluk nie. Trusted Types voeg daardie stempel by die strings wat jou kode in gevaarlike plekke stoot.

DOM: kort vir Document Object Model, die lewendige boom van elemente wat die bladsyverwerker vanaf 'n bladsy bou, wat JavaScript kan lees en verander.

Sink: 'n plek in die DOM waar 'n string kode of markup word. Voorbeelde: element.innerHTML, outerHTML, insertAdjacentHTML, document.write, iframe.srcdoc, eval en string argumente na setTimeout, en script.src.

Trusted Types: 'n blutserfunksie, ingeskakel deur CSP, waaronder daardie sinks slegs spesiale objekte (TrustedHTML, TrustedScript, TrustedScriptURL) aanvaar wat deur 'n policy gemaak word, 'n klein funksie wat jy skryf en benoem. 'n Gewone string wat aan 'n sink toegewys word, gooi 'n fout in plaas daarvan om te hardloop.

Skakel dit aan

Content-Security-Policy: require-trusted-types-for 'script'; trusted-types comments
  • require-trusted-types-for 'script': dwing dit af op alle skripverwante sinks.
  • trusted-types comments: die enigste beleidsnaam wat jou kode mag skep. 'n Ingevoegde skrif kan nie 'n beleid onder 'n ander naam registreer nie. trusted-types 'none' verbied om enige te skep.

Gebruik dit in jou kode

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

Die groot wen is vir hersieners. In plaas daarvan om elke innerHTML in 'n groot kodebasis te soek, hersien jy die min beleidfunksies. As hulle veilig is, dwing die blutser dat alles anders deur hulle gaan.

'n

beleid genaamd default is spesiaal: die bladsspange roep dit outomaties wanneer 'n gewone string 'n sink bereik. Dit is nuttig terwyl jy ou kode migreer, maar dit is ook 'n plek waar foute wegsteek, so hou dit streng en log wat deurgaan.

Ondersteun en uitrol

Trusted Types word ondersteun in alle groot enjins: Chromium-gebaseerde blousers, Safari 26 en Firefox 148 (nasien in Oktober 2026). Besoekers op ouer blousers kry eenvoudig nie die ekstra kontrole nie, so hou aan met escaping en hou jou nonce-gebaseerde CSP. Kode kan daarop toets met if (window.trustedTypes).

Rol dit uit soos enige beleid: stuur require-trusted-types-for 'script' in 'n Content-Security-Policy-Report-Only header eerste. Elke string wat 'n sink bereik word gerapporteer. Dit wys jou presies watter reëls 'n beleid nodig het of, beter nog, 'n oorgang na textContent.

'n algemene wanbelewing: "Trusted Types saniteer HTML vir my". Dit skoon niks nie. Dit dwing strings deur jou beleid. 'n Beleid wat sy insetsein onveranderd teruggee (createHTML: s => s) slaag die kontrole en beskerm niks nie.

Opsomming

  • DOM-inspuiting gebeur in jou eie JavaScript by sinks soos innerHTML; script-tag reëls alleen vang dit nie nie.
  • require-trusted-types-for 'script' laat sinks geweier om gewone strings te aanvaar; trusted-types NAME beperk watter policies mag bestaan.
  • Hersien die paar policy functions in plaas van elke sink, en verkies textContent waar jy kan.
  • Ondersteun in alle groot enjins (nasgelyk Oktober 2026); rol eers uit in report-only.

Sien jy 'n probleem in hierdie les? Rapporteer dit · Vra oor hierdie les

Hierdie oefening open binnekort

Voltooi die lesie voor dit en hierdie een sal ontvanklik wees. Die hele kursus is gratis, geen rekening nodig nie, en jy kan hierdie les nou lees.