پرش به محتوای اصلی

راهنمای سازنده و تحلیلگر CSP

زمان مطالعه: ۳ دقیقه

این ابزار چیست؟

سیاست امنیت محتوا (CSP) هدری است که به مرورگر می‌گوید صفحه از کجا اجازه دارد اسکریپت، تصویر، فونت و دیگر منابع را بارگذاری کند. یک CSP خوب بیشتر حمله‌های تزریق اسکریپت (XSS) را بی‌اثر می‌کند، اما نوشتنش دقیق است: یک 'unsafe-inline' اضافه کل محافظت را از بین می‌برد و یک منبع جاافتاده بخشی از سایت را از کار می‌اندازد.

این ابزار دو بخش دارد: «ساخت سیاست» از پیش‌تنظیم پایه یا سخت‌گیر با nonce شروع می‌کند و هدر HTTP و تگ meta می‌سازد؛ «تحلیل سیاست موجود» یک CSP را می‌گیرد و ایرادهایش را با شدت جدی، متوسط یا کم و پیشنهاد اصلاح نشان می‌دهد. همه‌چیز در مرورگر شما انجام می‌شود.

گام‌به‌گام

  1. از یک پیش‌تنظیم شروع کنید

    در «ساخت سیاست»، «پایه (فقط همین دامنه)» یا «سخت‌گیر (nonce + strict-dynamic)» را بردارید.

  2. دستورها را تنظیم کنید

    برای هر دستور مثل script-src، img-src یا connect-src منبع‌های لازم را اضافه کنید؛ منبع‌های نامعتبر همان‌جا مشخص می‌شوند.

  3. اول فقط گزارش بگیرید

    با «فقط گزارش (Report-Only)» هدر طوری ساخته می‌شود که مرورگر چیزی را مسدود نکند و فقط تخلف‌ها را گزارش دهد؛ پس از اطمینان آن را خاموش کنید.

  4. هدر یا تگ meta را بردارید

    «هدر HTTP» را در وب‌سرور بگذارید. «تگ meta» برای جایی است که به هدر دسترسی ندارید، اما برخی دستورها مثل frame-ancestors در آن کار نمی‌کنند و کنار گذاشته می‌شوند.

  5. سیاست موجود را تحلیل کنید

    در «تحلیل سیاست موجود» CSP یک سایت را، با Content-Security-Policy: یا بدون آن، بچسبانید تا ایرادهایش فهرست شود.

نمونه‌های کاربردی

  • سیاستی که محافظت نمی‌کند

    'unsafe-inline' در script-src اسکریپت تزریق‌شده را هم اجرا می‌کند و چند دستور مهم هم نیست.

    default-src *; script-src 'self' 'unsafe-inline'

    نتیجه: ۵ ایراد: ۲ جدی (unsafe-inline و نبود object-src 'none')، ۲ متوسط (base-uri و frame-ancestors)، ۱ کم (form-action)

  • پیش‌تنظیم پایه

    همه‌ی منابع فقط از همین دامنه، بدون افزونه، بدون iframe شدن در سایت دیگر و با ارتقای درخواست‌های http.

    نتیجه: Content-Security-Policy: default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'; upgrade-insecure-requests

اشتباه‌های رایج

  • افزودن 'unsafe-inline' برای رفع خطای یک اسکریپت: این کار CSP را در برابر XSS بی‌اثر می‌کند. اسکریپت را به فایل جدا ببرید یا برایش nonce یا hash بگذارید.
  • استفاده از nonce ثابت: nonce باید برای هر پاسخ در سرور تازه ساخته شود. مقداری که این ابزار نشان می‌دهد فقط نمونه است.
  • اعمال مستقیم سیاست سخت روی سایت در حال کار: اول با Report-Only چند روز گزارش بگیرید تا منبع‌های جاافتاده پیدا شوند.
  • تکیه بر تگ meta برای جلوگیری از clickjacking: frame-ancestors در meta کار نمی‌کند و باید در هدر HTTP بیاید.

nonce و strict-dynamic

در سیاست سخت‌گیر، به‌جای فهرست کردن همه‌ی دامنه‌های مجاز، سرور برای هر پاسخ یک مقدار تصادفی به نام nonce می‌سازد و آن را هم در هدر و هم روی برچسب‌های script خودش می‌گذارد. مرورگر فقط اسکریپت‌هایی را اجرا می‌کند که nonce درست دارند؛ اسکریپت تزریق‌شده آن را نمی‌داند.

'strict-dynamic' اجازه می‌دهد اسکریپت‌های مورد اعتماد، اسکریپت‌های دیگری را هم بارگذاری کنند. این ترکیب هم امن‌تر از فهرست دامنه‌هاست و هم نگه‌داری‌اش آسان‌تر است.

پرسش‌های متداول

سیاست CSP را از کجا شروع کنم؟
اول آن را با هدر Content-Security-Policy-Report-Only بفرستید تا ببینید چه چیزهایی مسدود می‌شود، بعد که گزارش‌ها تمیز شد آن را به هدر اصلی ببرید. الگوی «سخت‌گیر» با nonce و strict-dynamic بهترین محافظت در برابر XSS را می‌دهد.
چرا 'unsafe-inline' این‌قدر خطرناک است؟
چون مرورگر هر اسکریپت درون‌خطی را اجرا می‌کند و نمی‌تواند کد خودتان را از کد تزریق‌شده‌ی مهاجم جدا کند؛ یعنی بیشتر فایده‌ی CSP در برابر XSS از بین می‌رود. به‌جایش nonce یا hash را به کار ببرید.
فرق هدر با تگ meta چیست؟
تگ meta فقط برای وقتی است که به هدرها دسترسی ندارید؛ frame-ancestors، report-uri، report-to و sandbox در meta اثری ندارند و حالت فقط‌گزارش هم ممکن نیست. هر جا بتوانید هدر HTTP را به کار ببرید.

ابزارهای مرتبط