از 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
میتوانید تعیین کنید که صفحه وب در وضعیت مجزای میانمبدئی قرار دارد یا نه.
واژهنامه
این سند از اصطلاحات اختصاری و نامهای مشابه زیادی استفاده میکند. برای شفافسازی، واژهنامه کوچکی را آماده کردهایم:
- COEP: خطمشی جاساز میانمبدئی
- COOP: خطمشی بازکننده میانمبدئی
- CORP: Cross Origin Resource Policy (خطمشی منبع میانمبدئی)
- CORS: همرسانی منبع میانمبدئی
- CORB: Cross Origin Read Blocking (مسدود کردن خواندن میانمبدئی)
وبسایتتان را جداسازیشده میانمبدئی کنید
۱. 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 پشتیبانی کند.
- اگر منبع با CORS ارائه میشود، از مشخصه
- برای 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) را در ستون وضعیت
ببینید.

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

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

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

مشاهده مشکلات بااستفاده از 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، این پست را بهروز نگه خواهیم داشت.
منابع
- چرا برای ویژگیهای قدرتمند به «جداسازی بینمبدائی» نیاز دارید
- راهنمای فعال کردن جداسازی میانمبدئی
- پایش کل مصرف حافظه صفحه وب با
measureUserAgentSpecificMemory()
بهروزرسانیهای سند
- ۲۱ ژوئن ۲۰۲۲: اسکریپتهای 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.crossOriginIsolatedtrueرا برمیگرداند.performance.measureUserAgentSpecificMemory()درحال پایان دادن به آزمایش معرفی ویژگی جدید خود است و بهطور پیشفرض در Chrome 89 فعال است. Shared Array Buffer در Chrome Android از Chrome 88 دردسترس خواهد بود.