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

راهنمای سازنده‌ی SRI

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

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

وقتی یک فایل جاوااسکریپت یا CSS را از CDN یا سرور دیگری در صفحه می‌گذارید، اگر کسی آن فایل را در مبدأ تغییر دهد، کد مخربش روی سایت شما اجرا می‌شود. Subresource Integrity یا SRI این خطر را می‌بندد: هش فایل را در ویژگی integrity برچسب می‌نویسید و مرورگر فایلی را که هشش فرق کند اجرا نمی‌کند.

این ابزار برای متن یا فایل‌های شما integrity با SHA-256، SHA-384 یا SHA-512 می‌سازد، برچسب script یا link آماده می‌دهد و یک فایل را با integrity موجود می‌سنجد. هش با Web Crypto در مرورگر شما حساب می‌شود؛ فایل‌ها بارگذاری نمی‌شوند و هیچ نشانی‌ای از اینترنت دریافت نمی‌شود.

گام‌به‌گام

  1. کار را انتخاب کنید

    «ساخت integrity» برای ساختن مقدار تازه یا «بررسی با integrity» برای سنجیدن فایلی که دارید.

  2. متن یا فایل را بدهید

    محتوای فایل را بچسبانید یا تا ۲۰ فایل را انتخاب کنید؛ هر فایل تا ۵۰ مگابایت.

  3. الگوریتم و برچسب را انتخاب کنید

    SHA-384 انتخاب رایج است؛ «هر سه» چند هش را کنار هم می‌گذارد. نوع برچسب script یا link و نشانی فایل را بدهید تا برچسب کامل ساخته شود.

  4. برچسب را در صفحه بگذارید

    برچسب ساخته‌شده crossorigin="anonymous" هم دارد که برای فایل‌های دامنه‌ی دیگر لازم است.

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

  • یک اسکریپت کوچک

    integrity این یک خط کد با SHA-384 ساخته می‌شود؛ در برچسب، نشانی فایل خودتان را بگذارید.

    console.log('سلام');

    نتیجه: sha384-FeXsFkYIFv7i9mLS7W89lwzSBOJERtHFAr2kLHDzp1uQJX8VwX6hW68RzPw3cPvi

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

  • ساختن integrity از فایلی غیر از همانی که سرو می‌شود: اگر CDN نسخه‌ی فشرده‌ی دیگری یا نسخه‌ی تازه‌تری می‌دهد، هش نمی‌خواند و فایل بارگذاری نمی‌شود. همان فایل نهایی را هش کنید.
  • استفاده از SRI برای نشانی بدون نسخه: فایلی مثل latest/app.js با هر به‌روزرسانی عوض می‌شود و صفحه می‌شکند. نشانی نسخه‌دار را بگذارید.
  • فراموش کردن crossorigin: بدون آن، مرورگر نمی‌تواند هش فایل دامنه‌ی دیگر را بسنجد و آن را بارگذاری نمی‌کند.
  • تغییر یک نویسه در متن پیش از هش: حتی یک فاصله یا خط پایانی اضافه هش را عوض می‌کند. اگر ممکن است، به‌جای چسباندن، خود فایل را بدهید.

integrity چه شکلی دارد؟

مقدار integrity نام الگوریتم، یک خط تیره و هش فایل به شکل base64 است، مثل sha384-… . می‌توان چند مقدار را با فاصله کنار هم گذاشت؛ مرورگر قوی‌ترین الگوریتمی را که می‌شناسد بررسی می‌کند.

SRI فقط تضمین می‌کند فایل همان است که انتظار دارید، نه اینکه امن است. فایل را پیش از ساختن integrity از منبع معتبر بگیرید و بازبینی کنید.

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

SRI به چه کاری می‌آید؟
وقتی اسکریپت یا CSS را از CDN بارگذاری می‌کنید، مرورگر هش فایل دریافتی را با مقدار integrity مقایسه می‌کند و اگر فایل تغییر کرده باشد آن را اجرا نمی‌کند. این‌طوری دست‌کاری CDN به سایت شما نمی‌رسد.
چرا crossorigin="anonymous" لازم است؟
مرورگر فقط پاسخ‌هایی را که با CORS خوانده شده‌اند بررسی می‌کند. بدون این ویژگی، فایل از دامنه‌ی دیگر بررسی‌پذیر نیست و بارگذاری آن خطا می‌دهد.
کدام الگوریتم را انتخاب کنم؟
SHA-384 رایج‌ترین انتخاب است. اگر چند هش بدهید، مرورگر فقط قوی‌ترین الگوریتم موجود را بررسی می‌کند و کافی است یکی از هش‌های همان الگوریتم بخواند.
آیا فایل یا آدرس من به سرور فرستاده می‌شود؟
خیر؛ هش با Web Crypto در همین مرورگر حساب می‌شود و این ابزار هیچ آدرسی را دریافت نمی‌کند. آدرس فقط در متن تگ نوشته می‌شود.

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