بااستفاده از COOP و COEP، وب‌سایتتان را «میان‌مبدئی مجزا» کنید

از COOP و COEP برای راه‌اندازی محیط ایزوله میان‌مبدئی و فعال کردن ویژگی‌های قدرتمندی مثل SharedArrayBuffer، performance.measureUserAgentSpecificMemory()، و زمان‌سنج با وضوح بالا با دقت بهتر استفاده کنید.

تاریخ انتشار: ۱۳ آوریل ۲۰۲۰، آخرین به‌روزرسانی: ۲۱ ژوئن ۲۰۲۲

این سند نحوه استفاده از COOP و COEP را نشان می‌دهد. می‌توانید در «میان‌مبدئی مجزا» کردن وب‌سایت بااستفاده از COOP و COEP درباره دلیل اهمیت این موضوع بیشتر بخوانید.

برخی‌از میاناهای برنامه‌سازی کاربردی وب خطر حملات کانال جانبی مانند Spectre را افزایش می‌دهند. برای کاهش این خطر، مرورگرها محیطی جداسازی‌شده و مبتنی بر موافقت ارائه می‌دهند که «جداسازی‌شده میان‌مبدئی» نامیده می‌شود. با وضعیت جداسازی‌شده میان‌مبدئی، صفحه وب می‌تواند از ویژگی‌های ممتاز استفاده کند، ازجمله:

میانای برنامه‌سازی کاربردی شرح
SharedArrayBuffer برای رشته‌های WebAssembly لازم است. این ویژگی از Chrome نسخه ۸۸ در Android دردسترس است. نسخه رایانه به‌طور پیش‌فرض با کمک جداسازی سایت فعال است، اما به حالت جداسازی بین‌مبدائی نیاز دارد و به‌طور پیش‌فرض در Chrome 92 غیرفعال خواهد شد.
performance.measureUserAgentSpecificMemory() در Chrome 89 دردسترس است.
performance.now()، performance.timeOrigin در بسیاری‌از مرورگرها دردسترس است و وضوح آن به ۱۰۰ میکروثانیه یا بیشتر محدود است. با جداسازی میان‌مبدئی، وضوح می‌تواند ۵ میکروثانیه یا بیشتر باشد.
ویژگی‌هایی که در حالت جداسازی‌شده میان‌مبدئی دردسترس خواهند بود.

وضعیت جداسازی‌شده میان‌مبدئی همچنین از تغییرات document.domain جلوگیری می‌کند. (امکان تغییر document.domain اجازه برقراری ارتباط بین اسناد یک سایت را می‌دهد و به‌عنوان یک گریزگاه در خط‌مشی same-origin درنظر گرفته شده است.)

برای موافقت کردن با حالت جداسازی‌شده میان‌مبدئی، باید سرایندهای HTTP زیر را در سند اصلی ارسال کنید:

Cross-Origin-Embedder-Policy: require-corp
Cross-Origin-Opener-Policy: same-origin

این سرصفحه‌ها به مرورگر دستور می‌دهند بار کردن منابع یا iframeهایی را که برای بار شدن توسط اسناد میان‌مبدئی موافقت نکرده‌اند مسدود کند و از تعامل مستقیم پنجره‌های میان‌مبدئی با سند شما جلوگیری کند. این همچنین به این معنی است که منابعی که به‌صورت میان‌مبدئی بار می‌شوند نیاز به موافقت دارند.

با بررسی self.crossOriginIsolated می‌توانید تعیین کنید که صفحه وب در وضعیت مجزای میان‌مبدئی قرار دارد یا نه.

واژه‌نامه

این سند از اصطلاحات اختصاری و نام‌های مشابه زیادی استفاده می‌کند. برای شفاف‌سازی، واژه‌نامه کوچکی را آماده کرده‌ایم:

وب‌سایتتان را جداسازی‌شده میان‌مبدئی کنید

۱. Cross-Origin-Opener-Policy: same-origin را در سند سطح بالا تنظیم کنید

با فعال کردن COOP: same-origin در سند سطح بالا، پنجره‌های دارای همان مبدأ و پنجره‌های بازشده از سند، گروه زمینه مرور جداگانه‌ای دارند، مگراینکه در همان مبدأ با همان تنظیم COOP باشند. بنابراین، جداسازی برای پنجره‌های بازشده اعمال می‌شود و ارتباط متقابل بین هر دو پنجره غیرفعال می‌شود.

گروه بافت مرور مجموعه‌ای از پنجره‌ها است که می‌توانند به یکدیگر ارجاع دهند. برای مثال، سند سطح بالا و سندهای فرزند آن که با <iframe> جاسازی شده‌اند. اگر وب‌سایتی (https://a.example) پنجره گفتگویی (https://b.example) را باز کند، پنجره بازکننده و پنجره گفتگو بافت مرور یکسانی دارند، بنابراین با میاناهای برنامه‌سازی کاربردی DOM مثل window.opener به یکدیگر دسترسی دارند.

تصویری که «گروه محتوای مرور» را با کاربری که با عناصر صفحه تعامل دارد نشان می‌دهد.

می‌توانید بررسی کنید که آیا بازکننده پنجره و بازشده آن در گروه‌های زمینه مرور جداگانه هستند یا نه از DevTools.

۲. فعال کردن CORP یا CORS در منابع

مطمئن شوید که همه منابع صفحه با سرایندهای HTTP CORP یا CORS بارگیری شده باشند. این مرحله برای مرحله چهارم، فعال کردن COEP الزامی است.

بسته به ماهیت منبع، باید این کارها را انجام دهید:

  • اگر انتظار می‌رود منبع فقط از همان مبدأ بار شود، سرایند Cross-Origin-Resource-Policy: same-origin را تنظیم کنید.
  • اگر انتظار می‌رود منبع فقط از همان سایت اما میان‌مبدئی بار شود، سرایند Cross-Origin-Resource-Policy: same-site را تنظیم کنید.
  • اگر منبع از میان‌مبدأ(های) تحت کنترل شما بارگیری شده است، درصورت امکان، سرصفحه Cross-Origin-Resource-Policy: cross-origin را تنظیم کنید.
  • برای منابع میان‌مبدئی که کنترلی بر آن‌ها ندارید:
    • اگر منبع با CORS ارائه می‌شود، از مشخصه crossorigin در تگ HTML بارگیری استفاده کنید. (برای مثال، <img src="***" crossorigin>.)
    • از مالک منبع بخواهید از CORS یا CORP پشتیبانی کند.
  • برای iframe، همان اصول را دنبال کنید و Cross-Origin-Resource-Policy: cross-origin (یا same-site، same-origin بسته به بافت) را تنظیم کنید.
  • اسکریپت‌های بارشده با WebWorker باید از همان مبدأ ارائه شوند، بنابراین به سرصفحه CORP یا CORS نیاز ندارید.
  • برای سند یا کارگری که با COEP: require-corp ارائه می‌شود، زیرمنابع میان‌مبدئی بارشده بدون CORS باید سرصفحه Cross-Origin-Resource-Policy: cross-origin را برای انتخاب جاسازی شدن تنظیم کنند. برای مثال، این موضوع برای <script>، importScripts، <link>، <video>، <iframe>، و غیره اعمال می‌شود.

جداسازی در iframes

می‌توانید جداسازی میان‌مبدئی را در سند جاسازی‌شده در iframe با اعمال خط‌مشی اجازه‌های allow="cross-origin-isolated" در برچسب <iframe> و برآورده کردن این شرایط فعال کنید. کل زنجیره اسناد، ازجمله قاب‌های والد و قاب‌های فرزند، نیز باید میان‌مبدئی ایزوله شوند.

۳. برای ارزیابی منابع جاسازی‌شده، از سرصفحه COEP Report-Only HTTP استفاده کنید

قبل‌از فعال کردن کامل COEP، می‌توانید بااستفاده از سرصفحه Cross-Origin-Embedder-Policy-Report-Only، اجرای آزمایشی انجام دهید تا بررسی کنید که آیا خط‌مشی واقعاً کار می‌کند یا نه. گزارش‌ها را بدون مسدود کردن محتوای جاسازی‌شده دریافت خواهید کرد.

این را به‌طور بازگشتی بر همه اسناد ازجمله سند سطح بالا، iframe، و اسکریپت‌های کارگر اعمال کنید. برای اطلاعات درباره سرایند HTTP «فقط گزارش»، به مشاهده مشکلات بااستفاده از Reporting API مراجعه کنید.

۴. فعال کردن COEP

این مرحله را فقط زمانی می‌توانید انجام دهید که مطمئن شده باشید CORP یا CORS برای منابع فعال است.

وقتی مطمئن شدید که همه‌چیز کار می‌کند و همه منابع می‌توانند با موفقیت بار شوند، سرایند Cross-Origin-Embedder-Policy-Report-Only را به سرایند Cross-Origin-Embedder-Policy با همان مقدار برای همه اسناد، ازجمله اسنادی که با iframe و اسکریپت‌های worker جاسازی شده‌اند، تغییر دهید.

تعیین اینکه آیا جداسازی موفقیت‌آمیز بوده است یا نه

وقتی صفحه وب در حالت مجزای میان‌مبدئی باشد و همه منابع و پنجره‌ها در همان گروه بافت مرور مجزا باشند، ویژگی self.crossOriginIsolated مقدار true را برمی‌گرداند. می‌توانید از این میانای برنامه‌سازی کاربردی برای تعیین اینکه آیا گروه زمینه مرور را باموفقیت جدا کرده‌اید و به ویژگی‌هایی مثل performance.measureUserAgentSpecificMemory() دسترسی پیدا کرده‌اید یا نه استفاده کنید.

مشکلات را اشکال‌زدایی کند

ممکن است با COOP و COEP مشکلاتی داشته باشید. می‌توانید از ابزارهای توسعه‌دهنده مرورگر یا API گزارش‌دهی برای اشکال‌زدایی استفاده کنید.

اشکال‌زدایی کردن با Chrome DevTools

برای منابعی که در صفحه ارائه می‌شوند، مانند تصاویر، تشخیص مشکلات COEP نسبتاً آسان است، زیرا درخواست مسدود می‌شود و صفحه باید نشان دهد که تصویر وجود ندارد. بااین‌حال، برای منابعی که لزوماً تأثیر بصری ندارند، مانند اسکریپت‌ها یا سبک‌ها، مشکلات COEP ممکن است نادیده گرفته شوند. برای آن‌ها، از پانل DevTools Network استفاده کنید.

اگر مشکلی در COEP وجود داشته باشد، باید (blocked:NotSameOriginAfterDefaultedToSameOriginByCoep) را در ستون وضعیت ببینید.

مشکلات COEP در ستون «وضعیت» پانل «شبکه».

سپس می‌توانید روی ورودی کلیک کنید تا جزئیات بیشتری ببینید.

جزئیات مشکل COEP پس‌از کلیک کردن روی منبع شبکه در پانل «شبکه»، در برگه «سرصفحه‌ها» نشان داده می‌شود.

همچنین می‌توانید وضعیت iframe و پنجره‌های گفتگو را ازطریق پانل برنامه تعیین کنید. به بخش «قاب‌ها» در سمت راست بروید و «بالا» را ازهم باز کنید تا تفکیک ساختار منبع را ببینید.

می‌توانید وضعیت iframe را بررسی کنید، مثلاً دردسترس بودن SharedArrayBuffer، و غیره.

بازرس iframe در Chrome DevTools.

همچنین می‌توانید وضعیت پنجره کادر گفتگو را بررسی کنید، مثلاً اینکه آیا میان‌مبدئی جداشده است یا نه.

بازرس پنجره کادر گفتگوی Chrome DevTools

مشاهده مشکلات بااستفاده از Reporting API

Reporting API سازوکار دیگری است که ازطریق آن می‌توانید مشکلات مختلف را شناسایی کنید. می‌توانید Reporting API را پیکربندی کنید تا به مرورگر کاربرانتان دستور دهد هرگاه COEP بارگیری منبعی را مسدود کرد یا COOP پنجره گفتگویی را جدا کرد، گزارشی ارسال کند. ‫Chrome از Reporting API از نسخه ۶۹ برای کاربردهای مختلفی ازجمله COEP و COOP پشتیبانی کرده است.

با نحوه پیکربندی Reporting API و راه‌اندازی سرور برای دریافت گزارش‌ها آشنا شوید.

گزارش COEP نمونه

یک نمونه بار مفید گزارش COEP وقتی منبع میان‌مبدئی مسدود شده است به این شکل است:

[{
  "age": 25101,
  "body": {
    "blocked-url": "https://third-party-test.example.org/check.svg?",
    "blockedURL": "https://third-party-test.example.org/check.svg?",
    "destination": "image",
    "disposition": "enforce",
    "type": "corp"
  },
  "type": "coep",
  "url": "https://cross-origin-isolation.example.com/?coep=require-corp&coop=same-origin&",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4249.0 Safari/537.36"
}]

گزارش COOP نمونه

یک نمونه بار داده گزارش COOP وقتی کادر گفتگویی به‌صورت مجزا باز می‌شود، به این شکل است:

[{
  "age": 7,
  "body": {
    "disposition": "enforce",
    "effectivePolicy": "same-origin",
    "nextResponseURL": "https://third-party-test.example.org/popup?report-only&coop=same-origin&",
    "type": "navigation-from-response"
  },
  "type": "coop",
  "url": "https://cross-origin-isolation.example.com/coop?coop=same-origin&",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4246.0 Safari/537.36"
}]

وقتی گروه‌های مختلف بافت مرور سعی می‌کنند به یکدیگر دسترسی پیدا کنند (فقط در حالت «فقط گزارش»)، COOP نیز گزارشی ارسال می‌کند. برای مثال، گزارش مربوط به زمانی که postMessage() امتحان می‌شود به این شکل خواهد بود:

[{
  "age": 51785,
  "body": {
    "columnNumber": 18,
    "disposition": "reporting",
    "effectivePolicy": "same-origin",
    "lineNumber": 83,
    "property": "postMessage",
    "sourceFile": "https://cross-origin-isolation.example.com/popup.js",
    "type": "access-from-coop-page-to-openee"
  },
  "type": "coop",
  "url": "https://cross-origin-isolation.example.com/coop?report-only&coop=same-origin&",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4246.0 Safari/537.36"
},
{
  "age": 51785,
  "body": {
    "disposition": "reporting",
    "effectivePolicy": "same-origin",
    "property": "postMessage",
    "type": "access-to-coop-page-from-openee"
  },
  "type": "coop",
  "url": "https://cross-origin-isolation.example.com/coop?report-only&coop=same-origin&",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4246.0 Safari/537.36"
}]

ربودن مالکیت توپ

از ترکیبی از سرایندهای COOP و COEP HTTP برای انتخاب یک صفحه وب در یک حالت خاص میان‌مبدئی مجزا استفاده کنید. می‌توانید self.crossOriginIsolated را بررسی کنید تا مشخص کنید آیا صفحه وب در حالت ایزوله میان‌مبدئی است یا نه.

با دردسترس قرار گرفتن ویژگی‌های جدید برای این حالت ایزوله میان‌مبدئی و ایجاد بهبودهای بیشتر در DevTools پیرامون COOP و COEP، این پست را به‌روز نگه خواهیم داشت.

منابع

به‌روزرسانی‌های سند

  • ‫۲۱ ژوئن ۲۰۲۲: اسکریپت‌های Worker نیز هنگام فعال بودن جداسازی میان‌مبدئی نیاز به مراقبت دارند. توضیحاتی اضافه شد.
  • ۵ اوت ۲۰۲۱: JS Self-Profiling API به‌عنوان یکی از میاناهای برنامه‌سازی کاربردی که به جداسازی میان‌مبدئی نیاز دارد ذکر شده است، اما با بازتاب دادن تغییر اخیر در جهت، برداشته شده است.
  • ۶ مه ۲۰۲۱: براساس بازخوردها و مشکلات گزارش‌شده، تصمیم گرفتیم زمان‌بندی استفاده از SharedArrayBuffer را در سایت‌های ایزوله‌نشده میان‌مبدئی تنظیم کنیم تا در Chrome M92 محدود شود.
  • ۱۶ آوریل ۲۰۲۱: یادداشت‌هایی درباره حالت COEP بدون اطلاعات کاربری و COOP same-origin-allow-popups به‌عنوان شرطی آسان‌تر برای جداسازی میان‌مبدئی اضافه شد.
  • ۵ مارس ۲۰۲۱: محدودیت‌های SharedArrayBuffer، performance.measureUserAgentSpecificMemory()، و عملکردهای اشکال‌زدایی برداشته شد، که اکنون به‌طور کامل در Chrome 89 فعال شده‌اند. قابلیت‌های آتی، performance.now() و performance.timeOrigin، که دقت بالاتری خواهند داشت اضافه شد.
  • ‫۱۹ فوریه ۲۰۲۱: یادداشتی درباره خط‌مشی ویژگی allow="cross-origin-isolated" و عملکرد اشکال‌زدایی در DevTools اضافه شد.
  • ۱۵ اکتبر ۲۰۲۰: self.crossOriginIsolated از Chrome 87 دردسترس است. با توجه به این موضوع، document.domain تغییرناپذیر است وقتی self.crossOriginIsolated true را برمی‌گرداند. performance.measureUserAgentSpecificMemory() درحال پایان دادن به آزمایش معرفی ویژگی جدید خود است و به‌طور پیش‌فرض در Chrome 89 فعال است. Shared Array Buffer در Chrome Android از Chrome 88 دردسترس خواهد بود.