Programma Lezione 63 di 156 · Iniezione di script (XSS)
Iniezione di script (XSS)

Template che fanno l'escaping per impostazione predefinita

Perché è importante Raramente incollerai l'HTML a mano. I siti veri usano i template, e i buoni sistemi di template fanno l'escaping di ogni valore al posto tuo. Il tuo lavoro consiste soprattutto nel non spegnerlo per sbaglio, e nel riconoscere i pochi interruttori che lo fanno.

Un'analogia: un'auto che frena per te

Le auto moderne frenano da sole se stai per colpire qualcosa. Puoi spegnere la funzione, e a volte c'è un buon motivo. Ma ogni volta che è spenta, vale la pena chiedersi perché. L'escaping automatico è uguale: attivo per impostazione predefinita negli strumenti buoni, con pochi modi chiaramente nominati per spegnerlo.

Template: un file HTML con dei buchi, come {{ name }}, che il server riempie per ogni pagina. Il motore di template è il codice che riempie i buchi.

Escaping automatico: il motore di template fa l'escaping di ogni valore che mette in un buco, a meno che tu non gli dica che il valore è già sicuro.

Django

I template di Django fanno l'escaping di ogni {{ value }} per impostazione predefinita: <, >, &, " e ', gli stessi cinque di cui hai fatto l'escaping a mano. Le pagine dei corsi di questo sito sono costruite così.

{# safe: escaped automatically #}
<p>{{ review.text }}</p>
<input name="q" value="{{ query }}">

{# the dangerous switches: each one turns escaping off #}
{{ review.text|safe }}
{% autoescape off %}{{ review.text }}{% endautoescape %}

Nel codice Python, mark_safe(text) dice a Django "questo è già HTML, non farne l'escaping". Usalo solo su testo scritto dal tuo codice. Quando devi costruire un piccolo pezzo di HTML in Python, usa format_html, che fa l'escaping di ogni valore che gli passi:

from django.utils.html import format_html
from django.utils.safestring import mark_safe

bad = mark_safe(f"<b>{user_name}</b>")            # user_name is NOT escaped
good = format_html("<b>{}</b>", user_name)          # user_name IS escaped

Per passare dati al JavaScript della tua pagina, usa il filtro json_script invece di incollare valori in un blocco <script>. Scrive i dati come JSON in un modo che non può chiudere il tag script prima del tempo.

Jinja (e Flask)

Jinja è un altro motore di template Python molto usato. Il suo valore predefinito è diverso: un semplice Environment() non fa l'escaping. Attivalo, come fa Flask per i template .html:

from jinja2 import Environment, select_autoescape

env = Environment(autoescape=select_autoescape(["html", "htm", "xml"]))

# Jinja's dangerous switches: the |safe filter, Markup(text) in Python,
# and {% autoescape false %} blocks.

Che cosa non può fare comunque l'escaping automatico

  • Attributi senza virgolette: <div title={{ x }}> si rompe con un solo spazio. Scrivi sempre title="{{ x }}".
  • Indirizzi dei link: href="{{ url }}" subisce l'escaping, ma un indirizzo javascript: non ha niente da sottoporre a escaping. Controlla che i link inizino con https:// o http:// prima di salvarli o mostrarli.
  • Dentro i blocchi <script>: usa json_script o attributi data- invece dei buchi del template.

Un'abitudine per la revisione del codice

Cerca nel tuo progetto |safe, mark_safe, autoescape off, Markup( e, nel codice front-end, innerHTML e dangerouslySetInnerHTML. Ogni risultato dovrebbe avere accanto un motivo di una riga. Se il valore potesse mai contenere testo di un visitatore, è un bug che aspetta di succedere.

Un equivoco comune

"Il nostro framework fa l'escaping, quindi non possiamo avere XSS." I framework fanno l'escaping dei buchi. Non possono proteggere un valore che hai segnato come sicuro, un indirizzo che non hai controllato, o codice front-end che usa innerHTML. Il prossimo modulo aggiunge un secondo strato, la Content Security Policy, per gli errori che passano comunque.

Vuoi andare più a fondo? La Web Security Academy gratuita di PortSwigger ha un percorso completo sull'XSS con i suoi laboratori di esercitazione, costruiti per imparare in sicurezza.

In altri linguaggi

Gli stessi valori predefiniti, e gli stessi interruttori pericolosi, in altri stack:

// React: text in JSX is escaped for you
<p>{review.text}</p>
// the switch that turns it off (the name is a warning on purpose)
<div dangerouslySetInnerHTML={{ __html: review.text }} />

// Go: html/template escapes for the context (text, attribute, URL, script)
import "html/template"           // escapes
// import "text/template"        // does NOT escape: never use it for HTML
tmpl := template.Must(template.New("p").Parse(`<p>{{.}}</p>`))
// the switch: template.HTML(text) marks text as already safe

// PHP (Twig) auto-escapes; {{ text|raw }} turns it off
// C# (Razor) auto-escapes @text; @Html.Raw(text) turns it off

Riepilogo

  • Django fa l'escaping di ogni valore del template per impostazione predefinita; Jinja solo quando lo attivi.
  • Gli interruttori pericolosi: |safe, mark_safe, autoescape off, Markup, dangerouslySetInnerHTML, template.HTML di Go.
  • Usa format_html per costruire HTML in Python e json_script per passare dati a JavaScript.
  • L'escaping non controlla gli indirizzi dei link né corregge gli attributi senza virgolette: mettile, e permetti solo link http e https.

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.