Более строгое применение корпоративных правил для chrome.debugger в Chrome 155

Дата публикации: 8 сентября 2026 г. Последнее обновление: 4 ноября 2026 г.

Начиная с Chrome 155, ограничения корпоративных правил применяются к расширениям, использующим API chrome.debugger, по-новому.

Это изменение затронет только расширения, работающие в управляемых браузерах, в которых администратор явно настроил правила runtime_blocked_hosts, DisableScreenshots или защиты от потери данных (DLP).

Если расширение работает в браузере, для которого не настроено управление, или в корпоративной среде без указанных ограничений, chrome.debugger продолжит работать в обычном режиме.

Сроки и запуск

  • Бета-версия Chrome 155: 16 сентября 2026 г.
  • Выпуск стабильной версии Chrome 155: 6 октября 2026 г.
  • Откат: 3 ноября 2026 г.

Основные изменения в Chrome 155

Следующие изменения касаются только управляемых браузеров в организациях:

  • Ограничения хостов. Если корпоративное правило (ExtensionSettings) настраивает непустой список заблокированных хостов (runtime_blocked_hosts) для расширения, chrome.debugger.attach() отклоняется на всех целевых объектах со следующими ошибками:

    "Host access is restricted by policy."

    даже если в runtime_allowed_hosts указаны определенные источники.

  • Ограничения на создание скриншотов и DLP. Если создание скриншотов отключено корпоративным правилом (DisableScreenshots или правилами защиты от потери данных (DLP)), chrome.debugger.attach() не выполняется и возвращает ошибку:

    "Screenshot capture is restricted by policy."

В личных профилях и неуправляемых средах доступ к chrome.debugger по-прежнему не ограничен.

API chrome.debugger предоставляет прямой доступ к Chrome DevTools Protocol (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);
  }
});

Используйте альтернативные высокоуровневые API

Если вашему расширению не требуется прямой доступ к CDP, перейдите на API расширений более высокого уровня, которые поддерживают детализированные разрешения для хостов и работают со списками разрешенных и заблокированных хостов.

  • Используйте API chrome.scripting, чтобы выполнять скрипты и вставлять стили на разрешенные страницы.
  • Используйте API chrome.declarativeNetRequest, чтобы проверять, изменять или блокировать сетевые запросы декларативно.
  • Используйте API chrome.cookies со стандартными разрешениями хоста.

Рекомендации для администраторов корпоративных аккаунтов

Обновление от 4 ноября 2026 г. Принудительное применение правил в Chrome 155 было отменено с помощью обновления конфигурации на стороне сервера, которое Chrome скачивает автоматически и применяет после перезапуска. Чтобы отключить принудительное применение, не дожидаясь этого обновления, запустите Chrome с параметром командной строки --disable-features=ExtensionDebuggerStrictPolicyRestrictions.

Пока откат не вступит в силу, действуют следующие рекомендации.

Администраторам Enterprise, управляющим правилами для расширений, следует учитывать, что расширения, которым требуется разрешение на отладку, не могут работать с частичными ограничениями хостов (runtime_blocked_hosts). Если расширению требуется chrome.debugger, в правиле ExtensionSettings не должно быть заблокированных хостов.

Если создание скриншотов отключено с помощью правила DisableScreenshots или правил защиты от потери данных (DLP), то chrome.debugger.attach() не сработает.

Организациям, которым требуются черные списки хостов или ограничения на скриншоты, следует проверить, можно ли перевести их внутренние или одобренные расширения на API более высокого уровня, например chrome.scripting или chrome.declarativeNetRequest.

Отправить отзыв

Дополнительную информацию можно найти в документации по API chrome.debugger. Если у вас есть вопросы или отзывы, свяжитесь с нами через Google Группу Chromium Extensions.