Programma Les 67 van 156 · Content Security Policy en framing
Content Security Policy en framing

Trusted Types

Waarom dit ertoe doet CSP blokkeert geïnjecteerde script tags. Maar veel moderne bugs zitten in je eigen JavaScript: een regel zoals box.innerHTML = comment verandert tekst van een bezoeker in live HTML. Dat is de DOM-based injection uit Module 10 (Lesson 59), en het gebeurt nadat de pagina is geladen. Trusted Types zorgt ervoor dat de browser die gevaarlijke regels weigert tenzij de waarde door een check is gegaan die jij hebt geschreven.

Stel je een fabriek voor waar alleen onderdelen met een inspectiestempel op de assemblagelijn mogen. Niemand kan per ongeluk een willekeurig onderdeel uit de parkeerplaats vastschroeven. Trusted Types voegt die stempel toe aan de strings die je code naar gevaarlijke plekken stuurt.

DOM: afkorting voor Document Object Model, de live boom van elementen die de browser bouwt van een pagina, die JavaScript kan lezen en veranderen.

Sink: een plek in de DOM waar een string code of markup wordt. Voorbeelden: element.innerHTML, outerHTML, insertAdjacentHTML, document.write, iframe.srcdoc, eval en string argumenten naar setTimeout, en script.src.

Trusted Types: een browserfunctie, ingeschakeld door CSP, waarbij die sinks alleen speciale objecten (TrustedHTML, TrustedScript, TrustedScriptURL) accepteren die gemaakt zijn door een policy, een kleine functie die je schrijft en benoemt. Een gewone string toegewezen aan een sink geeft een foutmelding in plaats van uit te voeren.

Het inschakelen

Content-Security-Policy: require-trusted-types-for 'script'; trusted-types comments
  • require-trusted-types-for 'script': dwing het af op alle script-gerelateerde sinks.
  • trusted-types comments: de enige beleidsnaam die je code mag aanmaken. Een geïnjecteerd script kan geen beleid van zichzelf onder een andere naam registreren. trusted-types 'none' verbiedt het aanmaken van zoiets.

Het gebruiken in je 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

De grote win is voor reviewers. In plaats van elk innerHTML in een grote codebase te zoeken, beoordeel je de weinige policy functies. Als ze veilig zijn, dwingt de browser af dat alles wat overblijft door hen gaat.

De

A policy genaamd default is speciaal: de browser roept het automatisch aan wanneer een gewone string een sink bereikt. Het is nuttig tijdens het migreren van oude code, maar het is ook een plek waar fouten zich verstoppen, dus houd het strikt en log wat er doorheen gaat.

Ondersteuning en uitrol

Trusted Types wordt ondersteund in alle grote engines: Chromium-gebaseerde browsers, Safari 26 en Firefox 148 (gecontroleerd in oktober 2026). Bezoekers op oudere browsers krijgen simpelweg de extra check niet, dus blijf escapen en behoud je nonce-gebaseerde CSP. Code kan hierop testen met if (window.trustedTypes).

Rol het uit zoals elke policy: stuur require-trusted-types-for 'script' in een Content-Security-Policy-Report-Only header eerst. Elke string die een sink bereikt wordt gerapporteerd, wat je precies laat zien welke regels een policy nodig hebben of, beter, een switch naar textContent.

Een veelvoorkomende misvatting: "Trusted Types reinigt HTML voor mij". Het reinigt niets. Het dwingt strings door your policy. Een policy die zijn input onveranderd teruggeeft (createHTML: s => s) slaagt de check en beschermt niets.

Samenvatting

  • DOM-injectie gebeurt in je eigen JavaScript bij sinks zoals innerHTML; script-tag regels alleen vangen het niet op.
  • require-trusted-types-for 'script' zorgt ervoor dat sinks gewone strings weigeren; trusted-types NAME beperkt welke policies mogen bestaan.
  • Bekijk de weinige policy functies in plaats van elke sink, en kies voor textContent waar je kunt.
  • Ondersteund in alle belangrijke engines (gecontroleerd oktober 2026); eerst uitrollen in report-only.

Een probleem ontdekt in deze les? Meld het · Vraag naar deze les

Deze oefening opent binnenkort

Maak de les ervoor af voordat deze wordt ontgrendeld. De hele cursus is gratis, geen account nodig, en je kunt deze les nu lezen.