CSP para Next.js com AdSense e Yandex Metrica: nonce, estrito-dinâmico e somente relatório
Por que a lista de permissões não decola
A primeira tentativa geralmente se parece com isto: script-src 'self' https://pagead2.googlesyndication.com https://mc.yandex.ru. Dia sim, dia não, o console fica cheio de violações. O AdSense e a rede de publicidade Yandex carregam scripts, frames e pixels de muitos domínios, a lista muda sem aviso prévio e os leilões atraem anunciantes terceirizados. É impossível manter uma lista atualizada e muito ampla (https:) não protege.
O Google recomenda um CSP estrito para tais casos: a confiança não é emitida para o domínio, mas para uma tag específica <script> por meio de um nonce único, e 'strict-dynamic' permite que scripts carregados pelo script confiável carreguem suas dependências.
Política
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;Análise do não óbvio:
https:e'unsafe-inline'emscript-srcsão uma alternativa para navegadores mais antigos. Navegadores que entendemnoncee'strict-dynamic'os ignoram.img-src,frame-src,connect-srcficam abertos de acordo com o protocolo: a publicidade mostra fotos e frames de domínios arbitrários e a Metrica envia os dados para seus endereços. A principal proteção contra XSS está emscript-src.style-src 'unsafe-inline'é necessário porque os scripts de publicidade inserem estilos inline. O risco aqui é muito menor do que com scripts.frame-ancestors 'self'proíbe incorporar seu site em frames de outras pessoas.
Nonce em Next.js
O Nonce deve ser novo para cada resposta, por isso é gerado no 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 lê o CSP dos cabeçalhos de solicitação, extrai o nonce e o coloca em seus scripts de estrutura. Seus próprios scripts obtêm o nonce explicitamente:
// 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>
);
}O snippet embutido Metrica cria o elemento <script> dinamicamente - graças ao 'strict-dynamic' é permitido porque foi criado por um script com o nonce correto. O mesmo se aplica ao (adsbygoogle = window.adsbygoogle || []).push({}) inline em blocos de anúncios: ele também precisa do atributo nonce.
Preço nonce: renderização dinâmica
O Nonce é único para cada resposta, o que significa que o HTML não pode ser gerado antecipadamente e servido a partir do cache. Ler headers() no layout torna todas as páginas dinâmicas: a geração estática e ISR para HTML param de funcionar, a carga do servidor e o tempo de resposta aumentam. Para um site de conteúdo com publicidade, este é um compromisso significativo. Alternativas:
- hashes (
'sha256-...') para scripts embutidos fixos em vez de nonce - compatível com estática, mas os hashes terão que ser atualizados toda vez que o snippet for alterado; - CSP somente com
object-src,base-uri,frame-ancestorse sem restrições de script - proteção fraca contra XSS, mas não quebra o cache.
Somente primeiro relatório
O código acima envia Content-Security-Policy-Report-Only: o navegador reporta violações, mas não bloqueia nada. Receptor de relatório simples:
// 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 });
}Colete relatórios de vários dias sobre tráfego real. Filtre violações de extensões do navegador (chrome-extension://, moz-extension://) - isso é ruído. Quando apenas as violações esperadas permanecerem, renomeie o cabeçalho para Content-Security-Policy.
O que verificar depois de ligar
- Os anúncios são exibidos em páginas com vários blocos de anúncios, não apenas no primeiro.
- As visitas estão rodando no Metrica, as metas estão funcionando e o Webvisor está funcionando, se for utilizado.
- A navegação do cliente via
<Link>não causa nenhuma violação: o nonce está incluído em todos os scripts do layout.
Quando o CSP estrito não é necessário
Para um site sem entrada do usuário, sem autorização e com conteúdo completamente estático, o risco de XSS é baixo e a perda de geração estática é perceptível. Comece com frame-ancestors, object-src 'none' e base-uri 'none' - eles não quebram o cache - e volte ao nonce conforme formulários, comentários e HTML personalizado aparecem.
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.