Шаблоны, которые экранируют по умолчанию
Почему это важно Склеивать HTML вручную вы будете редко. Настоящие сайты используют шаблоны, а хорошие системы шаблонов экранируют каждое значение за вас. Ваша задача в основном в том, чтобы не выключить это случайно и узнавать те немногие переключатели, которые это делают.
Аналогия: машина, которая тормозит за вас
Современные машины тормозят сами, если вы вот-вот во что-то врежетесь. Функцию можно выключить, и иногда для этого есть веская причина. Но каждый раз, когда она выключена, стоит спросить почему. С автоэкранированием так же: в хороших инструментах оно включено по умолчанию, и есть несколько чётко названных способов его выключить.
Шаблон: HTML-файл с пропусками, например {{ name }}, которые сервер заполняет для каждой страницы. Движок шаблонов - это код, заполняющий пропуски.
Автоэкранирование: движок шаблонов экранирует каждое значение, которое вставляет в пропуск, если вы не скажете, что значение уже безопасно.
Django
Шаблоны Django по умолчанию экранируют каждое {{ value }}: <, >, &, " и ', те же пять символов, которые вы экранировали вручную. Страницы курсов этого сайта построены именно так.
{# 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 %}В коде Python mark_safe(text) говорит Django: "это уже HTML, не экранируй". Используйте его только для текста, который написал ваш собственный код. Когда нужно собрать небольшой кусок HTML в Python, используйте format_html, который экранирует каждое переданное значение:
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Чтобы передать данные в JavaScript страницы, используйте фильтр json_script, а не вставляйте значения в блок <script>. Он записывает данные как JSON так, что они не могут раньше времени закрыть тег script.
Jinja (и Flask)
Jinja - ещё один популярный движок шаблонов для Python. Его поведение по умолчанию другое: обычный Environment() не экранирует. Включите его, как это делает Flask для шаблонов .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.Чего автоэкранирование всё равно не может
- Атрибуты без кавычек:
<div title={{ x }}>ломается от одного пробела. Всегда пишитеtitle="{{ x }}". - Адреса ссылок:
href="{{ url }}"экранируется, но в адресеjavascript:нечего экранировать. Проверяйте, что ссылки начинаются сhttps://илиhttp://, прежде чем сохранять или показывать их. - Внутри блоков
<script>: используйтеjson_scriptили атрибутыdata-вместо пропусков шаблона.
Привычка для код-ревью
Ищите в проекте |safe, mark_safe, autoescape off, Markup(, а во фронтенд-коде - innerHTML и dangerouslySetInnerHTML. У каждого найденного места должна быть причина в одну строку рядом. Если значение когда-нибудь может содержать текст посетителя, это ошибка, которая ждёт своего часа.
Распространённое заблуждение
"Наш фреймворк экранирует, поэтому XSS у нас быть не может." Фреймворки экранируют пропуски. Они не могут защитить значение, которое вы пометили безопасным, адрес, который вы не проверили, или фронтенд-код с innerHTML. Следующий модуль добавляет второй слой, Content Security Policy, для ошибок, которые всё же проскальзывают.
Хотите глубже? В бесплатной Web Security Academy от PortSwigger есть полный курс по XSS с собственными учебными лабораториями, созданными для безопасного обучения.
На других языках
Те же настройки по умолчанию и те же опасные переключатели в других стеках:
// 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Итоги
- Django по умолчанию экранирует каждое значение шаблона; Jinja - только когда вы это включите.
- Опасные переключатели:
|safe,mark_safe,autoescape off,Markup,dangerouslySetInnerHTML,template.HTMLв Go. - Используйте
format_html, чтобы собирать HTML в Python, иjson_script, чтобы передавать данные в JavaScript. - Экранирование не проверяет адреса ссылок и не исправляет атрибуты без кавычек: берите их в кавычки и разрешайте только ссылки http и https.
Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке
Это упражнение откроется скоро
Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.
Этот браузер блокирует cookies для learn.floati.life, поэтому завершенные здесь уроки не могут открыться по порядку. Разрешите cookies для этого сайта и перезагрузите страницу.