Data di pubblicazione: 8 settembre 2026, Ultimo aggiornamento: 4 novembre 2026
A partire da Chrome 155, Chrome aggiorna il modo in cui le limitazioni delle policy aziendali si applicano alle estensioni che utilizzano l'API chrome.debugger.
Questa modifica interessa solo le estensioni in esecuzione su browser gestiti in cui un amministratore ha configurato esplicitamente runtime_blocked_hosts, DisableScreenshots o regole di Prevenzione della perdita di dati (DLP).
Se un'estensione viene eseguita su un browser non gestito o in un ambiente aziendale senza queste limitazioni specifiche delle policy, chrome.debugger continua a funzionare normalmente senza modifiche.
Tempistiche e implementazione
- Chrome 155 Beta: 16 settembre 2026
- Implementazione della versione stabile di Chrome 155: 6 ottobre 2026
- Rollback: 3 novembre 2026
Modifiche principali in Chrome 155
Le seguenti modifiche riguardano solo i browser gestiti dall'azienda:
Limitazioni degli host: se una policy aziendale (
ExtensionSettings) configura un elenco di host bloccati non vuoto (runtime_blocked_hosts) per un'estensione,chrome.debugger.attach()viene rifiutato su tutti i target con:"Host access is restricted by policy."Questo vale anche se in
runtime_allowed_hostssono incluse origini specifiche.Limitazioni relative agli screenshot e alla DLP: se l'acquisizione di screenshot è disattivata da una policy aziendale (
DisableScreenshotso regole di Prevenzione della perdita di dati (DLP)),chrome.debugger.attach()non va a buon fine e viene visualizzato il messaggio:"Screenshot capture is restricted by policy."
I profili personali e gli ambienti non gestiti continuano ad avere accesso illimitato a chrome.debugger come prima.
L'API chrome.debugger concede l'accesso diretto a Chrome DevTools Protocol (CDP) per funzionalità avanzate, tra cui la valutazione di script arbitrari e l'intercettazione di rete. Poiché il CDP opera al di sotto del modello di origine della piattaforma web, il filtro basato sull'origine non può limitarlo in modo sicuro, pertanto Chrome 155 risolve questo problema con un modello "tutto o niente", convalidando in anticipo le policy aziendali su ogni chiamata chrome.debugger.attach().
Azioni consigliate per gli sviluppatori
Gestisci i rifiuti di collegamento in modo corretto
Gestisci sempre i rifiuti di collegamento nel codice dell'estensione per fornire un feedback chiaro agli utenti aziendali:
// 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);
}
});
Prendi in considerazione API di alto livello alternative
Se la tua estensione non richiede espressamente l'accesso diretto al CDP, valuta la possibilità di eseguire la migrazione ad API di estensione di livello superiore che supportano autorizzazioni host granulari e funzionano insieme alle liste consentite e bloccate degli host aziendali:
- Utilizza l'API
chrome.scriptingper eseguire script e inserire stili nelle pagine consentite. - Utilizza l'API
chrome.declarativeNetRequestper ispezionare, modificare o bloccare le richieste di rete in modo dichiarativo. - Utilizza l'API
chrome.cookiescon autorizzazioni host standard.
Indicazioni per gli amministratori aziendali
Aggiornamento (4 novembre 2026): l'applicazione delle policy di Chrome 155 è stata annullata tramite un aggiornamento della configurazione lato server, che Chrome scarica automaticamente e applica dopo un riavvio. Per disattivare l'applicazione senza attendere questo aggiornamento, avvia Chrome con il flag della riga di comando --disable-features=ExtensionDebuggerStrictPolicyRestrictions.
Fino a quando il rollback non entrerà in vigore, si applicano le seguenti indicazioni.
Gli amministratori aziendali che gestiscono le policy delle estensioni devono tenere presente che le estensioni che richiedono l'autorizzazione del debugger non possono funzionare con limitazioni parziali dell'host (runtime_blocked_hosts). Se un'estensione richiede chrome.debugger, non deve avere host bloccati configurati in ExtensionSettings.
Se l'acquisizione di screenshot è disattivata utilizzando DisableScreenshots o le regole di Prevenzione della perdita di dati (DLP), chrome.debugger.attach() non andrà a buon fine.
Le organizzazioni che richiedono liste bloccate di host o limitazioni relative agli screenshot devono verificare se le loro estensioni interne o approvate possono eseguire la migrazione ad API di livello superiore come chrome.scripting o chrome.declarativeNetRequest.
Condividi feedback
Per maggiori dettagli, consulta la documentazione dell'API chrome.debugger. In caso di domande o feedback, contattaci tramite il gruppo Google Chromium Extensions.