Программа курса Урок 63 из 156 · Внедрение скриптов (XSS)
Внедрение скриптов (XSS)

Шаблоны, которые экранируют по умолчанию

Почему это важно Склеивать 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.

Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке

Это упражнение откроется скоро

Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.