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 escapedPour 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 toujourstitle="{{ x }}". - Les adresses de liens :
href="{{ url }}"est échappé, mais une adressejavascript:n'a rien à échapper. Vérifie que les liens commencent parhttps://ouhttp://avant de les stocker ou de les afficher. - À l'intérieur des blocs
<script>: utilisejson_scriptou des attributsdata-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 offRé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, letemplate.HTMLde Go. - Utilise
format_htmlpour construire du HTML en Python etjson_scriptpour 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.
Ce navigateur bloque les cookies pour learn.floati.life, donc les leçons que tu as terminées ici ne peuvent pas s'ouvrir dans l'ordre. Autorise les cookies pour ce site et recharge la page.