فرض سياسات المؤسسة بشكل أكثر صرامة على chrome.debugger في الإصدار 155 من Chrome

تاريخ النشر: 8 سبتمبر 2026

بدءًا من الإصدار 155 من Chrome، يغيّر Chrome طريقة تطبيق قيود سياسات المؤسسة على الإضافات باستخدام واجهة برمجة التطبيقات chrome.debugger.

لا يؤثّر هذا التغيير إلا في الإضافات التي تعمل على المتصفّحات المُدارة التي أعدّ فيها المشرف صراحةً runtime_blocked_hosts أو DisableScreenshots أو قواعد "منع فقدان البيانات".

إذا كانت الإضافة تعمل على متصفّح غير مُدار أو في بيئة مؤسسة بدون قيود السياسات المحدّدة هذه، سيستمر chrome.debugger في العمل بشكلٍ طبيعي بدون أي تغييرات.

المخطط الزمني وعملية الطرح

  • الإصدار التجريبي من Chrome 155: 16 سبتمبر 2026
  • طرح الإصدار الثابت من Chrome 155: 6 أكتوبر 2026

التغييرات الرئيسية في الإصدار 155 من Chrome

لا تؤثّر التغييرات التالية إلا في المتصفّحات المُدارة في المؤسسات:

  • قيود المضيف: إذا كانت إحدى سياسات المؤسسة (ExtensionSettings) تضبط قائمة غير فارغة بالمضيفين المحظورين (runtime_blocked_hosts) لأحد الإضافات، يتم رفض chrome.debugger.attach() على جميع الأهداف التي تتضمّن ما يلي:

    "Host access is restricted by policy."

    وينطبق ذلك حتى إذا تم تضمين مصادر محدّدة في runtime_allowed_hosts.

  • قيود لقطات الشاشة ومنع فقدان البيانات: إذا تم إيقاف إمكانية أخذ لقطات الشاشة من خلال سياسة مؤسسة (DisableScreenshots أو قواعد منع فقدان البيانات)، سيتعذّر تنفيذ chrome.debugger.attach() وسيظهر الخطأ التالي:

    "Screenshot capture is restricted by policy."

ستظل الملفات الشخصية والبيئات غير المُدارة تتيح الوصول غير المحدود إلى chrome.debugger كما في السابق.

تمنح واجهة برمجة التطبيقات chrome.debugger إمكانية الوصول المباشر إلى "بروتوكول أدوات مطوّري البرامج في Chrome" (CDP) للاستفادة من إمكانات قوية، بما في ذلك تقييم النصوص البرمجية العشوائية واعتراض الشبكة. بما أنّ CDP تعمل تحت نموذج المصدر الخاص بمنصة الويب، لا يمكن للفلترة المستندة إلى المصدر تقييدها بأمان، لذا يحلّ Chrome 155 هذه المشكلة باستخدام نموذج إما الكل أو لا شيء، مع التحقّق من صحة سياسات المؤسسة مسبقًا عند طلب chrome.debugger.attach().

التعامل مع حالات رفض المرفقات بسلاسة

عليك دائمًا التعامل مع حالات رفض الربط في رمز الإضافة لتقديم ملاحظات واضحة لمستخدمي المؤسسة:

// Promise-based (Manifest V3)
try {
  await chrome.debugger.attach({ tabId }, "1.3");
} catch (error) {
  if (error.message.includes("Host access is restricted by policy")) {
    console.warn("Debugger attach blocked: Extension has host restrictions configured by enterprise policy.");
  } else if (error.message.includes("Screenshot capture is restricted by policy")) {
    console.warn("Debugger attach blocked: Screenshots or DLP restrictions are enforced by enterprise policy.");
  } else {
    console.warn("Debugger attach failed:", error.message);
  }
}

// Callback-based
chrome.debugger.attach({ tabId }, "1.3", () => {
  if (chrome.runtime.lastError) {
    console.warn("Debugger attach failed:", chrome.runtime.lastError.message);
  }
});

استخدام واجهات برمجة تطبيقات بديلة عالية المستوى

إذا لم يكن الإذن المباشر بالوصول إلى منصة بيانات العملاء (CDP) مطلوبًا بشكل صارم في إضافتك، يمكنك تقييم إمكانية نقلها إلى واجهات برمجة تطبيقات إضافات ذات مستوى أعلى تتيح أذونات مضيف دقيقة وتعمل جنبًا إلى جنب مع قوائم المضيفين المسموح بها والمحظورة في المؤسسات:

  • استخدِم واجهة برمجة التطبيقات chrome.scripting لتنفيذ النصوص البرمجية وإدراج الأنماط في الصفحات المسموح بها.
  • استخدِم واجهة برمجة التطبيقات chrome.declarativeNetRequest لفحص طلبات الشبكة أو تعديلها أو حظرها بشكل تعريفي.
  • استخدِم واجهة برمجة التطبيقات chrome.cookies مع أذونات المضيف العادية.

إرشادات لمشرفي المؤسسات

على مشرفي المؤسسة الذين يديرون سياسات الإضافات الانتباه إلى أنّ الإضافات التي تتطلّب إذن تصحيح الأخطاء لا يمكنها العمل مع القيود الجزئية على المضيفين (runtime_blocked_hosts). إذا كانت الإضافة تتطلّب chrome.debugger، يجب ألا تتضمّن مضيفين محظورين تم ضبطهم في ExtensionSettings.

إذا تم إيقاف التقاط لقطات الشاشة باستخدام DisableScreenshots أو قواعد "منع فقدان البيانات" (DLP)، سيتعذّر تنفيذ chrome.debugger.attach().

على المؤسسات التي تتطلّب قوائم حظر المضيفين أو قيودًا على لقطات الشاشة التحقّق مما إذا كان بإمكان الإضافات الداخلية أو المعتمَدة الانتقال إلى واجهات برمجة تطبيقات ذات مستوى أعلى، مثل chrome.scripting أو chrome.declarativeNetRequest.

مشاركة الملاحظات

لمزيد من التفاصيل، يُرجى الرجوع إلى chrome.debugger مستندات واجهة برمجة التطبيقات. إذا كانت لديك أسئلة أو ملاحظات، يمكنك التواصل معنا من خلال مجموعة Google المتعلقة بإضافات Chromium.