سرفصل‌ها درس 74 از 156 · اشخاص ثالث در سایت خودتان
اشخاص ثالث در سایت خودتان

Permissions-Policy

چرا مهم است مرورگرها می‌توانند به دوربین، میکروفون، موقعیت مکانی و بیشتر دسترسی پیدا کنند. فروشگاه شما به هیچ‌کدام نیاز ندارد. اگر یک اسکریپت تزریق‌شده یا یک قاب جاسازی‌شده در سایت شما دوربین را بخواهد، بازدیدکننده نام شما را در درخواست اجازه می‌بیند. Permissions-Policy به شما اجازه می‌دهد بگویید «هیچ‌کس در صفحه‌های من حتی اجازهٔ درخواست ندارد».

قوانین خانه روی یخچال را تصور کنید: «هیچ‌کس از ماشین استفاده نمی‌کند. باغ فقط برای خانواده است.» مهمانان ممکن است دوست‌داشتنی باشند، اما قوانین پیش از آنکه کسی بپرسد تصمیم می‌گیرند. Permissions-Policy فهرستی از قوانین خانه برای قابلیت‌های قدرتمند مرورگر است.

Permissions-Policy: یک سرآیند پاسخ که به مرورگر می‌گوید صفحهٔ شما و قاب‌های درون آن مجازند از کدام قابلیت‌های قدرتمند استفاده کنند. قابلیتی که خاموش شده قابل استفاده نیست و مرورگر حتی درخواست اجازه را نشان نمی‌دهد.

نحو

Permissions-Policy: camera=(), microphone=(), geolocation=(), payment=(self "https://pay.example")
  • feature=(): یک فهرست خالی. هیچ‌کس نمی‌تواند از آن استفاده کند، حتی صفحهٔ خودتان.
  • feature=(self): فقط مبدأ خودتان (طرح و میزبان شما، مثل https://shopd.example).
  • feature=(self "https://pay.example"): مبدأ شما و همان یک مبدأ فهرست‌شده (در گیومه).
  • feature=*: هر کسی، که به‌ندرت همان چیزی است که می‌خواهید.

قابلیت‌هایی که شاید در یک سایت معمولی خاموش کنید: camera، microphone، geolocation، usb، bluetooth، midi، payment (اگر از Payment Request مرورگر استفاده نمی‌کنید)، display-capture، و حسگرهای حرکتی مثل accelerometer و gyroscope.

قاب‌ها هم اجازه لازم دارند

قابی از سایتی دیگر فقط وقتی یک قابلیت قدرتمند می‌گیرد که شما آن را روی برچسب هم با ویژگی allow اعطا کنید:

<iframe src="https://maps.example/embed" allow="geolocation"></iframe>

هر دو باید موافق باشند: سرآیند باید آن مبدأ را مجاز کند و برچسب قاب باید آن را درخواست کند. فقط آنچه هر قاب واقعاً لازم دارد اعطا کنید. بسیاری از جاسازی‌ها بدون هیچ چیز به‌خوبی کار می‌کنند.

پشتیبانی، صادقانه

مرورگرهای مبتنی بر Chromium این سرآیند را اعمال می‌کنند. پشتیبانی در موتورهای دیگر متفاوت است و رو به افزایش بوده، در حالی که ویژگی allow روی iframeها به‌طور گسترده کار می‌کند (بررسی‌شده در اکتبر 2026). پس سرآیند را بفرستید و با allow هم دقیق باشید. ممکن است نام قدیمی Feature-Policy را در راهنماهای قدیمی‌تر ببینید، و توصیه به افزودن interest-cohort=(). آن یک آزمایش تبلیغاتی را خاموش می‌کرد که مرورگرها از آن زمان کنارش گذاشته‌اند، پس دیگر کار مفیدی نمی‌کند.

یک تصور نادرست رایج: «بازدیدکنندگان از قبل درخواست اجازه می‌بینند، پس این بی‌فایده است». درخواستی با نام سایت شما دقیقاً همان چیزی است که یک اسکریپت تزریق‌شدهٔ زیرک می‌خواهد، چون مردم به سایت شما اعتماد دارند. خاموش کردن قابلیت یعنی چیزی نمی‌ماند که کسی را برای پذیرفتنش فریب دهند.

در Django

Django این سرآیند را برایتان تنظیم نمی‌کند. یک تکهٔ کوچک middleware (کدی که روی هر پاسخ اجرا می‌شود) این کار را می‌کند:

def permissions_policy(get_response):
    def middleware(request):
        response = get_response(request)
        response["Permissions-Policy"] = "camera=(), microphone=(), geolocation=()"
        return response
    return middleware
در زبان‌های دیگر
// JavaScript (Express)
app.use((req, res, next) => {
  res.set("Permissions-Policy", "camera=(), microphone=(), geolocation=()");
  next();
});
# nginx
add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
// Go (net/http)
w.Header().Set("Permissions-Policy", "camera=(), microphone=(), geolocation=()")

امتحان کنید DevTools را روی یک سایت باز کنید، در زبانهٔ Network سند اصلی را انتخاب کنید و در سرآیندهای پاسخ آن دنبال Permissions-Policy بگردید. در مرورگرهای مبتنی بر Chromium، پنل Application هم بخشی به نام «Frames» دارد که فهرست می‌کند هر قاب از کدام قابلیت‌ها می‌تواند استفاده کند.

خلاصه

  • Permissions-Policy قابلیت‌های قدرتمند را پیش از آنکه کسی بتواند درخواستشان کند خاموش می‌کند.
  • feature=() یعنی هیچ‌کس؛ (self) یعنی فقط شما؛ مبدأهای فهرست‌شده در گیومه می‌آیند.
  • قاب‌های سایت‌های دیگر هم به ویژگی allow نیاز دارند، و فقط برای آنچه واقعاً لازم دارند.

مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید

این تمرین به‌زودی باز می‌شود

درس پیش از آن را تمام کنید تا این یکی باز شود. کل دوره رایگان است، حساب کاربری لازم نیست، و می‌توانید همین الان این درس را بخوانید.