Programma Les 63 van 156 · Scriptinjectie (XSS)
Scriptinjectie (XSS)

Templates die standaard ontsnappen

Waarom dit ertoe doet Je zult zelden HTML met de hand aan elkaar plakken. echte sites gebruiken templates, en goede templatesystemen ontsnappen elke waarde voor je. Jouw taak is vooral om dat niet per ongeluk uit te zetten en om de weinige schakelaars die dat wel doen te herkennen.

Een analogie: een auto die voor je remt

Moderne auto's remmen automatisch als je iets gaat raken. Je kunt deze functie uitzetten, en soms is daar een goede reden voor. Maar elke keer dat het uit staat, is het de moeite waard om te vragen waarom. Auto-escaping is hetzelfde: standaard aan in goede tools, met een paar duidelijk benoemde manieren om het uit te zetten.

Template: een HTML-bestand met gaten, zoals {{ name }}, die de server invult voor elke pagina. De template engine is de code die de gaten invult.

Auto-escaping: de template engine ontsnapt elke waarde die hij in een gat zet, tenzij je vertelt dat de waarde al veilig is.

Django

Django templates escapen elke {{ value }} standaard: <, >, &, " en ', dezelfde vijf die je handmatig hebt geëscaped. De cursuspagina's van deze site zijn zo gebouwd.

{# 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 %}

In Python code vertelt mark_safe(text) aan Django "dit is al HTML, ontsnap het niet". Gebruik het alleen op tekst die je eigen code schreef. Wanneer je een klein stuk HTML in Python moet bouwen, gebruik je format_html, wat elke waarde die je invoert ontsnapt:

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

Om gegevens naar de JavaScript van je pagina te sturen, gebruik je de json_script filter in plaats van waarden in een <script> blok te plakken. Het schrijft de gegevens als JSON op een manier die de script tag niet voortijdig kan sluiten.

Jinja (en Flask)

Jinja is een andere populaire Python template engine. De standaard is anders: een gewone Environment() doet not escape. Zet het aan, zoals Flask dat doet voor .html templates:

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.

Wat auto-escaping nog steeds niet kan doen

  • Niet geciteerde attributen: <div title={{ x }}> breekt met een enkele spatie. Schrijf altijd title="{{ x }}".
  • Link-adressen: href="{{ url }}" is ontsnapt, maar een javascript:-adres heeft niets om te ontsnappen. Controleer of links beginnen met https:// of http:// voordat je ze opslaat of laat zien.
  • Binnen <script> blokken: gebruik json_script of data- attributen in plaats van template gaps.

een gewoonte voor code review

Zoek in je project naar |safe, mark_safe, autoescape off, Markup( en, in front-end code, innerHTML en dangerouslySetInnerHTML. Elke match moet een reden van één regel ernaast hebben. Als de waarde ooit bezoekerstekst zou kunnen bevatten, is het een bug die wacht om te gebeuren.

A veelvoorkomende misvatting

"Ons framework escape, dus kunnen we geen XSS hebben." Frameworks escapen de gaps. Ze kunnen een waarde die je veilig markeerde niet beschermen, een adres dat je niet hebt gecontroleerd, of front-end code die innerHTML gebruikt. De volgende module voegt een tweede laag toe, Content Security Policy, voor de fouten die nog steeds doorglippen.

Wil je dieper gaan? PortSwigger's gratis Web Security Academy heeft een volledige XSS track met eigen oefenlabs, gebouwd om veilig te leren.

In andere talen

Dezelfde standaardinstellingen, en dezelfde gevaarlijke schakelaars, in andere stacks:

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

Samenvatting

  • Django ontsnapt elke template waarde standaard; Jinja alleen wanneer je het aanzet.
  • De gevaarlijke schakelaars: |safe, mark_safe, autoescape off, Markup, dangerouslySetInnerHTML, Go's template.HTML.
  • Gebruik format_html om HTML in Python te bouwen en json_script om data aan JavaScript te geven.
  • Escaping controleert geen linkadressen of herstelt niet ongequoteerde attributen: quote ze en sta alleen http en https links toe.

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.