Programme Leçon 63 sur 156 · L'injection de script (XSS)
L'injection de script (XSS)

Des templates qui échappent par défaut

Pourquoi c'est important Tu assembleras rarement du HTML à la main. Les vrais sites utilisent des templates, et les bons systèmes de templates échappent chaque valeur pour toi. Ton travail consiste surtout à ne pas désactiver ça par accident, et à reconnaître les quelques interrupteurs qui le font.

Une analogie : une voiture qui freine pour toi

Les voitures modernes freinent automatiquement si tu vas heurter quelque chose. Tu peux désactiver la fonction, et il y a parfois une bonne raison. Mais chaque fois qu'elle est désactivée, ça vaut la peine de se demander pourquoi. L'échappement automatique, c'est pareil : actif par défaut dans les bons outils, avec quelques moyens clairement nommés de le désactiver.

Template : un fichier HTML avec des trous, comme {{ name }}, que le serveur remplit pour chaque page. Le moteur de templates est le code qui remplit les trous.

Échappement automatique : le moteur de templates échappe chaque valeur qu'il met dans un trou, sauf si tu lui dis que la valeur est déjà sûre.

Django

Les templates Django échappent chaque {{ value }} par défaut : <, >, &, " et ', les cinq mêmes que tu as échappés à la main. Les pages de cours de ce site sont construites ainsi.

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

Dans le code Python, mark_safe(text) dit à Django « c'est déjà du HTML, ne l'échappe pas ». Ne l'utilise que sur du texte écrit par ton propre code. Quand tu dois construire un petit morceau de HTML en Python, utilise format_html, qui échappe chaque valeur que tu lui passes :

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

Pour passer des données au JavaScript de ta page, utilise le filtre json_script au lieu de coller des valeurs dans un bloc <script>. Il écrit les données en JSON d'une façon qui ne peut pas fermer la balise de script trop tôt.

Jinja (et Flask)

Jinja est un autre moteur de templates Python populaire. Son comportement par défaut est différent : un simple Environment() n'échappe pas. Active-le, comme le fait Flask pour les templates .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.

Ce que l'échappement automatique ne peut toujours pas faire

  • Les attributs sans guillemets : <div title={{ x }}> casse avec une seule espace. Écris toujours title="{{ x }}".
  • Les adresses de liens : href="{{ url }}" est échappé, mais une adresse javascript: n'a rien à échapper. Vérifie que les liens commencent par https:// ou http:// avant de les stocker ou de les afficher.
  • À l'intérieur des blocs <script> : utilise json_script ou des attributs data- au lieu de trous de template.

Une habitude pour la relecture de code

Cherche dans ton projet |safe, mark_safe, autoescape off, Markup( et, dans le code front-end, innerHTML et dangerouslySetInnerHTML. Chaque résultat doit avoir une raison d'une ligne à côté. Si la valeur peut un jour contenir du texte de visiteur, c'est un bogue qui attend son heure.

Une idée reçue

« Notre framework échappe, donc on ne peut pas avoir de XSS. » Les frameworks échappent les trous. Ils ne peuvent pas protéger une valeur que tu as marquée sûre, une adresse que tu n'as pas vérifiée, ou un code front-end qui utilise innerHTML. Le module suivant ajoute une deuxième couche, la Content Security Policy, pour les erreurs qui passent encore.

Tu veux aller plus loin ? La Web Security Academy gratuite de PortSwigger a un parcours XSS complet avec ses propres labos d'entraînement, conçus pour apprendre sans risque.

Dans d'autres langages

Les mêmes comportements par défaut, et les mêmes interrupteurs dangereux, dans d'autres environnements :

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

Récap

  • Django échappe chaque valeur de template par défaut ; Jinja seulement quand tu l'actives.
  • Les interrupteurs dangereux : |safe, mark_safe, autoescape off, Markup, dangerouslySetInnerHTML, le template.HTML de Go.
  • Utilise format_html pour construire du HTML en Python et json_script pour passer des données au JavaScript.
  • L'échappement ne vérifie pas les adresses de liens et ne corrige pas les attributs sans guillemets : mets-les entre guillemets et n'autorise que les liens http et https.

Tu as repéré un problème dans cette leçon ? Signale-le · Pose une question sur cette leçon

Cet exercice s'ouvre bientôt

Termine la leçon précédente pour débloquer celle-ci. Tout le cours est gratuit, aucun compte n'est requis, et tu peux lire cette leçon dès maintenant.