Programma Lezione 67 di 156 · Content Security Policy e framing
Content Security Policy e framing

Trusted Types

Perché è importante La CSP blocca i tag script iniettati. Ma molti bug moderni vivono dentro il tuo JavaScript: una riga come box.innerHTML = comment trasforma il testo di un visitatore in HTML vivo. È l'iniezione basata sul DOM del Modulo 10 (Lezione 59), e avviene dopo che la pagina si è caricata. Trusted Types fa rifiutare al browser quelle righe pericolose a meno che il valore non sia passato da un controllo che hai scritto tu.

Immagina una fabbrica in cui solo i pezzi con un timbro di ispezione possono andare sulla catena di montaggio. Nessuno può montare un pezzo a caso trovato nel parcheggio, neanche per sbaglio. Trusted Types aggiunge quel timbro alle stringhe che il tuo codice manda nei posti pericolosi.

DOM: abbreviazione di Document Object Model, l'albero vivo di elementi che il browser costruisce da una pagina, che JavaScript può leggere e cambiare.

Sink: un punto del DOM in cui una stringa diventa codice o markup. Esempi: element.innerHTML, outerHTML, insertAdjacentHTML, document.write, iframe.srcdoc, eval e gli argomenti stringa di setTimeout, e script.src.

Trusted Types: una funzione del browser, attivata dalla CSP, con cui quei sink accettano solo oggetti speciali (TrustedHTML, TrustedScript, TrustedScriptURL) creati da una policy, una piccola funzione che scrivi tu e a cui dai un nome. Una semplice stringa assegnata a un sink lancia un errore invece di girare.

Attivarlo

Content-Security-Policy: require-trusted-types-for 'script'; trusted-types comments
  • require-trusted-types-for 'script': applicalo a tutti i sink legati agli script.
  • trusted-types comments: l'unico nome di policy che il tuo codice può creare. Uno script iniettato non può registrare una propria policy sotto un altro nome. trusted-types 'none' vieta di crearne qualsiasi.

Usarlo nel tuo codice

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

Il grande vantaggio è per chi rivede il codice. Invece di cercare ogni innerHTML in un grande codice sorgente, rivedi le poche funzioni di policy. Se sono sicure, il browser fa in modo che tutto il resto passi da lì.

Una policy chiamata default è speciale: il browser la chiama in automatico ogni volta che una semplice stringa arriva a un sink. È utile mentre si migra codice vecchio, ma è anche un posto in cui si nascondono gli errori, quindi tienila rigida e registra ciò che ci passa.

Supporto e introduzione

Trusted Types è supportato in tutti i motori principali: browser basati su Chromium, Safari 26 e Firefox 148 (verificato a ottobre 2026). I visitatori con browser più vecchi semplicemente non ricevono il controllo in più, quindi continua con l'escaping e con la tua CSP basata sui nonce. Il codice può verificarne la presenza con if (window.trustedTypes).

Introducilo come qualsiasi policy: invia prima require-trusted-types-for 'script' in un'intestazione Content-Security-Policy-Report-Only. Ogni stringa che arriva a un sink viene segnalata, mostrandoti esattamente quali righe hanno bisogno di una policy o, meglio, di passare a textContent.

Un equivoco comune: "Trusted Types ripulisce l'HTML al posto mio". Non pulisce niente. Costringe le stringhe a passare dalla tua policy. Una policy che restituisce l'input senza cambiarlo (createHTML: s => s) supera il controllo e non protegge niente.

Riepilogo

  • L'iniezione nel DOM avviene nel tuo JavaScript, in sink come innerHTML; le sole regole sui tag script non la prendono.
  • require-trusted-types-for 'script' fa rifiutare ai sink le semplici stringhe; trusted-types NAME limita quali policy possono esistere.
  • Rivedi le poche funzioni di policy invece di ogni sink, e preferisci textContent dove puoi.
  • Supportato in tutti i motori principali (verificato a ottobre 2026); introducilo prima in report-only.

Hai notato un problema in questa lezione? Segnalalo · Chiedi qualcosa su questa lezione

Questo esercizio si apre presto

Finisci la lezione precedente e questa si sblocca. L'intero corso è gratuito, senza account, e puoi leggere questa lezione subito.