CSP для Next.js с AdSense и Яндекс Метрикой: nonce, strict-dynamic и Report-Only
Почему allowlist не взлетит
Первая попытка обычно выглядит так: script-src 'self' https://pagead2.googlesyndication.com https://mc.yandex.ru. Через день консоль заполнена нарушениями. AdSense и рекламная сеть Яндекса подгружают скрипты, фреймы и пиксели с множества доменов, список меняется без предупреждения, а аукционы подтягивают сторонних рекламодателей. Поддерживать актуальный перечень невозможно, а слишком широкий (https:) не защищает.
Google для таких случаев рекомендует строгую CSP: доверие выдаётся не домену, а конкретному тегу <script> через одноразовый nonce, а 'strict-dynamic' разрешает скриптам, загруженным доверенным скриптом, подгружать свои зависимости.
Политика
script-src 'nonce-{NONCE}' 'strict-dynamic' https: 'unsafe-inline';
object-src 'none';
base-uri 'none';
frame-ancestors 'self';
img-src 'self' data: https:;
frame-src https:;
connect-src 'self' https:;
style-src 'self' 'unsafe-inline';
font-src 'self' data:;
report-uri /api/csp-report;Разбор неочевидного:
https:и'unsafe-inline'вscript-src— запасной вариант для старых браузеров. Браузеры, понимающиеnonceи'strict-dynamic', их игнорируют.img-src,frame-src,connect-srcоставлены широкими по протоколу: реклама показывает картинки и фреймы с произвольных доменов, а Метрика отправляет данные на свои адреса. Главная защита от XSS — вscript-src.style-src 'unsafe-inline'нужен, потому что рекламные скрипты вставляют инлайновые стили. Риск здесь значительно ниже, чем у скриптов.frame-ancestors 'self'запрещает встраивать ваш сайт в чужие фреймы.
Nonce в Next.js
Nonce должен быть новым на каждый ответ, поэтому он генерируется в middleware:
// middleware.ts
import { NextResponse, type NextRequest } from "next/server";
export function middleware(request: NextRequest) {
const nonce = Buffer.from(crypto.randomUUID()).toString("base64");
const csp = [
`script-src 'nonce-${nonce}' 'strict-dynamic' https: 'unsafe-inline'`,
`object-src 'none'`,
`base-uri 'none'`,
`frame-ancestors 'self'`,
`img-src 'self' data: https:`,
`frame-src https:`,
`connect-src 'self' https:`,
`style-src 'self' 'unsafe-inline'`,
`font-src 'self' data:`,
`report-uri /api/csp-report`,
].join("; ");
const requestHeaders = new Headers(request.headers);
requestHeaders.set("x-nonce", nonce);
requestHeaders.set("Content-Security-Policy-Report-Only", csp);
const response = NextResponse.next({ request: { headers: requestHeaders } });
response.headers.set("Content-Security-Policy-Report-Only", csp);
return response;
}
export const config = {
matcher: [{ source: "/((?!api|_next/static|_next/image|favicon.ico).*)" }],
};Next.js читает CSP из заголовков запроса, извлекает nonce и сам проставляет его на свои скрипты фреймворка. Ваши собственные скрипты получают nonce явно:
// app/layout.tsx
import { headers } from "next/headers";
import Script from "next/script";
export default async function RootLayout({ children }: { children: React.ReactNode }) {
const nonce = (await headers()).get("x-nonce") ?? undefined;
return (
<html lang="ru">
<body>
{children}
<Script
id="adsense"
nonce={nonce}
async
src={`https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=${process.env.NEXT_PUBLIC_ADSENSE_CLIENT}`}
crossOrigin="anonymous"
strategy="afterInteractive"
/>
<Script id="metrika" nonce={nonce} strategy="afterInteractive">
{`(function(m,e,t,r,i,k,a){m[i]=m[i]||function(){(m[i].a=m[i].a||[]).push(arguments)};
m[i].l=1*new Date();k=e.createElement(t),a=e.getElementsByTagName(t)[0],k.async=1,k.src=r,a.parentNode.insertBefore(k,a)})
(window, document, "script", "https://mc.yandex.ru/metrika/tag.js", "ym");
ym(${process.env.NEXT_PUBLIC_YM_ID}, "init", { clickmap: true, trackLinks: true, accurateTrackBounce: true });`}
</Script>
</body>
</html>
);
}Инлайновый сниппет Метрики создаёт элемент <script> динамически — благодаря 'strict-dynamic' он разрешён, потому что его создал скрипт с правильным nonce. То же касается инлайнового (adsbygoogle = window.adsbygoogle || []).push({}) в рекламных блоках: ему тоже нужен атрибут nonce.
Цена nonce: динамический рендеринг
Nonce уникален для каждого ответа, значит, HTML нельзя сгенерировать заранее и раздавать из кеша. Чтение headers() в layout делает все страницы динамическими: статическая генерация и ISR для HTML перестают работать, растёт нагрузка на сервер и время ответа. Для контентного сайта с рекламой это существенный компромисс. Альтернативы:
- хеши (
'sha256-...') для фиксированных инлайновых скриптов вместо nonce — совместимо со статикой, но хеши придётся обновлять при каждом изменении сниппета; - CSP только с
object-src,base-uri,frame-ancestorsи без ограничения скриптов — слабая защита от XSS, но не ломает кеширование.
Сначала Report-Only
Код выше отправляет Content-Security-Policy-Report-Only: браузер сообщает о нарушениях, но ничего не блокирует. Простой приёмник отчётов:
// app/api/csp-report/route.ts
export async function POST(req: Request) {
const body = await req.text();
console.warn("csp-report", body.slice(0, 2000));
return new Response(null, { status: 204 });
}Соберите отчёты за несколько дней на реальном трафике. Нарушения от браузерных расширений (chrome-extension://, moz-extension://) отфильтруйте — это шум. Когда остаются только ожидаемые нарушения, переименуйте заголовок в Content-Security-Policy.
Что проверить после включения
- Объявления показываются на страницах с несколькими рекламными блоками, а не только на первом.
- В Метрике идут визиты, работают цели и Вебвизор, если он используется.
- Клиентская навигация через
<Link>не вызывает нарушений: nonce проставлен на всех скриптах из layout.
Когда строгая CSP не нужна
Для сайта без пользовательского ввода, без авторизации и с полностью статическим контентом риск XSS низкий, а потеря статической генерации ощутима. Начните с frame-ancestors, object-src 'none' и base-uri 'none' — они не ломают кеш — и возвращайтесь к nonce, когда появятся формы, комментарии и пользовательский HTML.
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.