Bardziej rygorystyczne egzekwowanie zasad firmy dotyczących chrome.debugger w Chrome 155

Opublikowano: 8 września 2026 r., ostatnia aktualizacja: 4 listopada 2026 r.

Od wersji Chrome 155 aktualizujemy sposób stosowania ograniczeń zasad firmowych do rozszerzeń korzystających z interfejsu API chrome.debugger.

Ta zmiana dotyczy tylko rozszerzeń działających w zarządzanych przeglądarkach, w których administrator wyraźnie skonfigurował zasady runtime_blocked_hosts, DisableScreenshots lub reguły zapobiegania utracie danych (DLP).

Jeśli rozszerzenie działa w niezarządzanej przeglądarce lub w środowisku firmowym bez tych konkretnych ograniczeń wynikających z zasad, chrome.debugger nadal działa normalnie bez żadnych zmian.

Harmonogram i wdrażanie

  • Chrome 155 Beta: 16 września 2026 r.
  • Wdrożenie wersji stabilnej Chrome 155: 6 października 2026 r.
  • Wycofanie: 3 listopada 2026 r.

Najważniejsze zmiany w Chrome 155

Te zmiany dotyczą tylko przeglądarek zarządzanych przez firmę:

  • Ograniczenia dotyczące hostów: jeśli zasada przedsiębiorstwa (ExtensionSettings) konfiguruje niepustą listę zablokowanych hostów (runtime_blocked_hosts) dla rozszerzenia, chrome.debugger.attach() jest odrzucane we wszystkich miejscach docelowych z:

    "Host access is restricted by policy."

    Dzieje się tak nawet wtedy, gdy w polu runtime_allowed_hosts podane są konkretne źródła.

  • Ograniczenia dotyczące zrzutów ekranu i DLP: jeśli robienie zrzutów ekranu jest wyłączone przez zasady firmy (DisableScreenshots lub reguły zapobiegania utracie danych (DLP)), metoda chrome.debugger.attach() kończy się niepowodzeniem i wyświetla się komunikat:

    "Screenshot capture is restricted by policy."

Profile osobiste i niezarządzane środowiska nadal mają nieograniczony dostęp do chrome.debugger.

Interfejs API chrome.debugger zapewnia bezpośredni dostęp do protokołu narzędzi deweloperskich w Chrome (CDP), co umożliwia korzystanie z zaawansowanych funkcji, takich jak ocena dowolnego skryptu i przechwytywanie sieci. Ponieważ CDP działa poniżej modelu origin platformy internetowej, filtrowanie oparte na origin nie może go bezpiecznie ograniczyć. Chrome 155 rozwiązuje ten problem za pomocą modelu wszystko albo nic, który sprawdza zasady przedsiębiorstwa z góry przy każdym wywołaniu chrome.debugger.attach().

Prawidłowa obsługa odrzuceń dołączenia

Zawsze obsługuj odrzucenia dołączenia w kodzie rozszerzenia, aby przekazywać użytkownikom firmowym jasne informacje:

// 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);
  }
});

Rozważ użycie alternatywnych interfejsów API wysokiego poziomu

Jeśli rozszerzenie nie wymaga bezpośredniego dostępu do CDP, rozważ przejście na interfejsy API rozszerzeń wyższego poziomu, które obsługują szczegółowe uprawnienia hosta i działają z listami dozwolonych i zablokowanych hostów w firmie:

  • Używaj interfejsu API chrome.scripting do wykonywania skryptów i wstawiania stylów na dozwolonych stronach.
  • Użyj interfejsu API chrome.declarativeNetRequest, aby deklaratywnie sprawdzać, modyfikować lub blokować żądania sieciowe.
  • Używaj interfejsu API chrome.cookies ze standardowymi uprawnieniami hosta.

Wskazówki dla administratorów firmowych

Aktualizacja (4 listopada 2026 r.): egzekwowanie zasad w Chrome 155 zostało wycofane przez aktualizację konfiguracji po stronie serwera, którą Chrome pobiera automatycznie i stosuje po ponownym uruchomieniu. Aby wyłączyć egzekwowanie bez czekania na tę aktualizację, uruchom Chrome z flagą wiersza poleceń --disable-features=ExtensionDebuggerStrictPolicyRestrictions.

Dopóki wycofanie nie wejdzie w życie, nadal obowiązują poniższe wskazówki.

Administratorzy firm zarządzający zasadami dotyczącymi rozszerzeń powinni pamiętać, że rozszerzenia wymagające uprawnień debugera nie mogą działać z częściowymi ograniczeniami hosta (runtime_blocked_hosts). Jeśli rozszerzenie wymaga uprawnień chrome.debugger, nie może mieć skonfigurowanych zablokowanych hostów w ExtensionSettings.

Jeśli robienie zrzutów ekranu jest wyłączone za pomocą zasad DisableScreenshots lub reguł zapobiegania utracie danych (DLP), interfejs chrome.debugger.attach() nie będzie działać.

Organizacje, które wymagają list zablokowanych hostów lub ograniczeń dotyczących zrzutów ekranu, powinny sprawdzić, czy ich wewnętrzne lub zatwierdzone rozszerzenia mogą zostać przeniesione do interfejsów API wyższego poziomu, takich jak chrome.scripting lub chrome.declarativeNetRequest.

Podziel się opinią

Więcej informacji znajdziesz w dokumentacji interfejsu API chrome.debugger. Jeśli masz pytania lub chcesz podzielić się opinią, skontaktuj się z nami na Grupie dyskusyjnej Google poświęconej rozszerzeniom Chromium.