Application plus stricte des règles d'entreprise pour chrome.debugger dans Chrome 155

Date de publication : 8 septembre 2026, Dernière mise à jour : 4 novembre 2026

À partir de Chrome 155, Chrome modifie la façon dont les restrictions des règles d'entreprise s'appliquent aux extensions qui utilisent l'API chrome.debugger.

Ce changement ne concerne que les extensions exécutées sur des navigateurs gérés pour lesquels un administrateur a explicitement configuré runtime_blocked_hosts, DisableScreenshots ou des règles de protection contre la perte de données.

Si une extension s'exécute sur un navigateur non géré ou dans un environnement d'entreprise sans ces restrictions spécifiques, chrome.debugger continue de fonctionner normalement sans aucune modification.

Calendrier et déploiement

  • Chrome 155 bêta : 16 septembre 2026
  • Déploiement de la version stable de Chrome 155 : 6 octobre 2026
  • Rollback : 3 novembre 2026

Principaux changements dans Chrome 155

Les modifications suivantes ne concernent que les navigateurs gérés par l'entreprise :

  • Restrictions d'hôte : si une règle d'entreprise (ExtensionSettings) configure une liste d'hôtes bloqués non vide (runtime_blocked_hosts) pour une extension, chrome.debugger.attach() est rejeté sur toutes les cibles avec :

    "Host access is restricted by policy."

    Cela s'applique même si des origines spécifiques sont incluses dans runtime_allowed_hosts.

  • Restrictions concernant les captures d'écran et la protection contre la perte de données : si la capture d'écran est désactivée par une règle d'entreprise (DisableScreenshots ou règles de protection contre la perte de données), chrome.debugger.attach() échoue avec le message suivant :

    "Screenshot capture is restricted by policy."

Les profils personnels et les environnements non gérés continuent d'avoir un accès chrome.debugger illimité, comme auparavant.

L'API chrome.debugger accorde un accès direct au protocole Chrome DevTools (CDP) pour des fonctionnalités puissantes, y compris l'évaluation de scripts arbitraires et l'interception réseau. Comme le CDP fonctionne sous le modèle d'origine de la plate-forme Web, le filtrage basé sur l'origine ne peut pas le restreindre de manière sécurisée. Chrome 155 résout donc ce problème avec un modèle tout ou rien, en validant les règles d'entreprise à l'avance sur chaque appel chrome.debugger.attach().

Gérer les refus d'association de manière appropriée

Gérez toujours les rejets d'association dans le code de votre extension pour fournir des commentaires clairs aux utilisateurs de la version Enterprise :

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

Envisager d'autres API de haut niveau

Si votre extension ne nécessite pas strictement un accès direct au CDP, envisagez de migrer vers des API d'extension de niveau supérieur qui acceptent les autorisations d'hôte précises et fonctionnent avec les listes d'autorisation et de blocage d'hôtes d'entreprise :

  • Utilisez l'API chrome.scripting pour exécuter des scripts et insérer des styles dans les pages autorisées.
  • Utilisez l'API chrome.declarativeNetRequest pour inspecter, modifier ou bloquer les requêtes réseau de manière déclarative.
  • Utilisez l'API chrome.cookies avec des autorisations d'hôte standards.

Conseils destinés aux administrateurs d'entreprise

Mise à jour (4 novembre 2026) : L'application de la règle Chrome 155 a été annulée par une mise à jour de la configuration côté serveur, que Chrome télécharge automatiquement et applique après un redémarrage. Pour désactiver l'application sans attendre cette mise à jour, lancez Chrome avec le flag de ligne de commande --disable-features=ExtensionDebuggerStrictPolicyRestrictions.

En attendant, les conseils suivants s'appliquent toujours.

Les administrateurs d'entreprise qui gèrent les règles d'extension doivent noter que les extensions nécessitant l'autorisation du débogueur ne peuvent pas fonctionner avec des restrictions d'hôte partielles (runtime_blocked_hosts). Si une extension nécessite chrome.debugger, elle ne doit pas avoir d'hôtes bloqués configurés dans ExtensionSettings.

Si la capture d'écran est désactivée à l'aide de DisableScreenshots ou de règles de protection contre la perte de données (DLP), chrome.debugger.attach() échouera.

Les organisations qui ont besoin de listes de blocage d'hôtes ou de restrictions de capture d'écran doivent vérifier si leurs extensions internes ou approuvées peuvent migrer vers des API de niveau supérieur telles que chrome.scripting ou chrome.declarativeNetRequest.

Envoyer des commentaires

Pour en savoir plus, consultez la documentation de l'API chrome.debugger. Si vous avez des questions ou des commentaires, contactez-nous sur le groupe Google Chromium Extensions.