CSP از اپلیکیشن Next.js در برابر حملات XSS، کلیک‌جکینگ و تزریق کد محافظت می‌کند. این مقاله نحوهٔ تنظیم هدرهای CSP با استفاده از Proxy، تولید nonce برای اسکریپت‌های امن، و فعال‌سازی رندرینگ پویا برای پشتیبانی از سیاست‌های امنیتی سخت‌گیرانه را بررسی می‌کند.

CSP از اپلیکیشن Next.js در برابر حملات XSS، کلیک‌جکینگ و تزریق کد محافظت می‌کند. این مقاله نحوهٔ تنظیم هدرهای CSP با استفاده از Proxy، تولید nonce برای اسکریپت‌های امن، و فعال‌سازی رندرینگ پویا برای پشتیبانی از سیاست‌های امنیتی سخت‌گیرانه را بررسی می‌کند.

Content Security PolicyNonceProxyDynamic RenderingContent Security PolicyNonceProxy

~3 min read · Updated Dec 11, 2025

چرا Content Security Policy مهم است؟


CSP از اپلیکیشن شما در برابر حملاتی مانند XSS، کلیک‌جکینگ و تزریق کد محافظت می‌کند. با محدود کردن منابع مجاز برای بارگذاری محتوا، اسکریپت، استایل، فونت، مدیا و iframeها، امنیت اپلیکیشن افزایش می‌یابد.


Nonce چیست؟


Nonce یک رشتهٔ تصادفی و یکتا است که در هر درخواست تولید می‌شود. با استفاده از nonce می‌توان اجرای اسکریپت‌های خاص را مجاز کرد، بدون اینکه CSP کلی اجازهٔ اجرای inline scriptها را بدهد.


افزودن nonce با Proxy


در فایل proxy.ts می‌توان nonce تولید کرد و در هدر CSP قرار داد:

export function proxy(request: NextRequest) {
  const nonce = Buffer.from(crypto.randomUUID()).toString('base64')
  const cspHeader = `
    default-src 'self';
    script-src 'self' 'nonce-${nonce}' 'strict-dynamic';
    style-src 'self' 'nonce-${nonce}';
    img-src 'self' blob: data:;
    font-src 'self';
    object-src 'none';
    base-uri 'self';
    form-action 'self';
    frame-ancestors 'none';
    upgrade-insecure-requests;
  `.replace(/\s{2,}/g, ' ').trim()

  const requestHeaders = new Headers(request.headers)
  requestHeaders.set('x-nonce', nonce)
  requestHeaders.set('Content-Security-Policy', cspHeader)

  const response = NextResponse.next({ request: { headers: requestHeaders } })
  response.headers.set('Content-Security-Policy', cspHeader)

  return response
}

تنظیم matcher برای Proxy


برای جلوگیری از اعمال CSP روی فایل‌های استاتیک یا درخواست‌های prefetch:

export const config = {
  matcher: [
    {
      source: '/((?!api|_next/static|_next/image|favicon.ico).*)',
      missing: [
        { type: 'header', key: 'next-router-prefetch' },
        { type: 'header', key: 'purpose', value: 'prefetch' },
      ],
    },
  ],
}

نحوهٔ کار nonce در Next.js


  • Proxy nonce را تولید کرده و در هدر CSP و x-nonce قرار می‌دهد
  • Next.js nonce را از هدر CSP استخراج می‌کند
  • Nonce به‌صورت خودکار به موارد زیر اعمال می‌شود:
    • اسکریپت‌های React و Next.js
    • باندل‌های جاوااسکریپت صفحه
    • استایل‌ها و اسکریپت‌های inline تولیدشده توسط Next.js
    • کامپوننت‌های <Script> با prop nonce

فعال‌سازی رندرینگ پویا


برای پشتیبانی از nonce، صفحات باید به‌صورت پویا رندر شوند. از connection() استفاده کنید:

import { connection } from 'next/server'

export default async function Page() {
  await connection()
  // محتوای صفحه
}

خواندن nonce در Server Component


از headers() برای دریافت nonce استفاده کنید:

import { headers } from 'next/headers'
import Script from 'next/script'

export default async function Page() {
  const nonce = (await headers()).get('x-nonce')

  return (
    <Script
      src="https://www.googletagmanager.com/gtag/js"
      strategy="afterInteractive"
      nonce={nonce}
    />
  )
}

رندرینگ استاتیک در برابر پویا با CSP


استفاده از nonce نیازمند رندرینگ پویا است. این یعنی:

  • غیرفعال شدن بهینه‌سازی استاتیک
  • غیرفعال شدن ISR
  • عدم کش شدن توسط CDN
  • ناسازگاری با PPR

تأثیر بر عملکرد


  • کندتر شدن بارگذاری اولیه صفحات
  • افزایش بار سرور
  • هزینهٔ بیشتر میزبانی

چه زمانی از nonce استفاده کنیم؟


  • اگر سیاست امنیتی شما 'unsafe-inline' را ممنوع کرده
  • اگر اپلیکیشن داده‌های حساس را مدیریت می‌کند
  • اگر نیاز به اجرای اسکریپت‌های خاص دارید
  • اگر الزامات قانونی یا امنیتی دارید

جمع‌بندی


استفاده از CSP با nonce در Next.js امنیت اپلیکیشن را به‌طور چشمگیری افزایش می‌دهد. اگرچه نیازمند رندرینگ پویا و منابع بیشتر است، برای اپلیکیشن‌هایی با حساسیت بالا یا الزامات امنیتی، یک انتخاب ضروری است.


Written & researched by Dr. Shahin Siami

Related Articles

مسیریابی پیشرفته و هوک‌های عملکرد در Next.js — راهنمای توسعه‌دهنده برای App Router

Next.js مجموعه‌ای غنی از هوک‌های کلاینت و ابزارهای کش و ناوبری را در اختیار توسعه‌دهندگان قرار می‌دهد. از خواندن پارامترهای مسیر تا گزارش Web Vitals و مدیریت کش، این مقاله مهم‌ترین ابزارهای App Router را با مثال‌های کاربردی معرفی می‌کند.

Continue

مدیریت احراز هویت و کش در Next.js — راهنمای توسعه‌دهنده برای امنیت و عملکرد پویا

Next.js با معرفی قابلیت‌های آزمایشی جدید، امکان کنترل دقیق‌تر دسترسی و کش داده‌ها را فراهم کرده است. تابع unauthorized برای مدیریت خطای 401 و هدایت کاربران به صفحه ورود، unstable_cache برای کش هوشمند عملیات سنگین، updateTag برای بازسازی آنی داده‌ها، و useLinkStatus برای نمایش وضعیت ناوبری استفاده می‌شوند. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات مهم بررسی می‌کند.

Continue

redirect و refresh در Next.js — ریدایرکت‌های هوشمند و تازه‌سازی مسیر در Server Actions

تابع redirect در Next.js برای هدایت کاربر به مسیر جدید استفاده می‌شود و بسته به نوع استفاده، پاسخ HTTP با وضعیت 307 یا 303 ارسال می‌کند. این تابع در Server Components، Client Components، Route Handlers و Server Actions قابل استفاده است. تابع refresh نیز برای تازه‌سازی مسیر کلاینت از درون Server Action استفاده می‌شود. این مقاله نحوه استفاده از هر دو تابع را با مثال‌های کاربردی و نکات مهم توضیح می‌دهد.

Continue

Next.js با معرفی NextRequest و NextResponse، APIهای Request و Response مرورگر را گسترش داده و ابزارهای قدرتمندی برای مدیریت کوکی‌ها، هدرها، ریدایرکت‌ها، بازنویسی مسیرها و پاسخ‌های JSON فراهم کرده است. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات امنیتی توضیح می‌دهد.

Next.js با معرفی NextRequest و NextResponse، APIهای Request و Response مرورگر را گسترش داده و ابزارهای قدرتمندی برای مدیریت کوکی‌ها، هدرها، ریدایرکت‌ها، بازنویسی مسیرها و پاسخ‌های JSON فراهم کرده است. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات امنیتی توضیح می‌دهد.

Continue

headers، ImageResponse، notFound و permanentRedirect در Next.js — مدیریت درخواست‌ها، تولید تصویر، خطا و ریدایرکت

Next.js ابزارهای قدرتمندی برای مدیریت درخواست‌ها و پاسخ‌ها در کامپوننت‌های سروری فراهم کرده است. تابع headers برای خواندن هدرهای HTTP ورودی، ImageResponse برای تولید تصاویر داینامیک، notFound برای نمایش صفحه خطای 404، و permanentRedirect برای ریدایرکت دائمی کاربران استفاده می‌شوند. این مقاله نحوه استفاده از هر یک را با مثال‌های کاربردی توضیح می‌دهد.

Continue

راهنمای کامل استفاده از metadata و generateMetadata در Next.js

در نسخه‌های مدرن Next.js، مدیریت metadata صفحات بسیار قدرتمندتر و ساده‌تر شده است. metadata به‌صورت خودکار در تگ <head> صفحات تزریق می‌شود و نقش مهمی در SEO، اشتراک‌گذاری اجتماعی و تجربه کاربری دارد. این مقاله دو روش اصلی تعریف metadata را بررسی می‌کند: استفاده از آبجکت ثابت metadata و تابع داینامیک generateMetadata.

Continue