Aplicación más estricta de las políticas empresariales para chrome.debugger en Chrome 155

Publicado el 8 de septiembre de 2026; última actualización: 4 de noviembre de 2026

A partir de Chrome 155, se actualizará la forma en que se aplican las restricciones de las políticas empresariales a las extensiones que usan la API de chrome.debugger.

Este cambio solo afecta a las extensiones que se ejecutan en navegadores administrados en los que un administrador configuró de forma explícita las reglas de runtime_blocked_hosts, DisableScreenshots o Prevención de pérdida de datos (DLP).

Si una extensión se ejecuta en un navegador no administrado o en un entorno empresarial sin estas restricciones de política específicas, chrome.debugger seguirá funcionando con normalidad sin cambios.

Cronograma y lanzamiento

  • Chrome 155 Beta: 16 de septiembre de 2026
  • Lanzamiento de la versión estable de Chrome 155: 6 de octubre de 2026
  • Reversión: 3 de noviembre de 2026

Cambios clave en Chrome 155

Los siguientes cambios solo afectan a los navegadores administrados por empresas:

  • Restricciones de host: Si una política empresarial (ExtensionSettings) configura una lista de hosts bloqueados no vacía (runtime_blocked_hosts) para una extensión, se rechaza chrome.debugger.attach() en todos los destinos con lo siguiente:

    "Host access is restricted by policy."

    Esto es así incluso si se incluyen orígenes específicos en runtime_allowed_hosts.

  • Restricciones de capturas de pantalla y DLP: Si una política empresarial (DisableScreenshots o reglas de Prevención de pérdida de datos [DLP]) inhabilita la captura de pantalla, chrome.debugger.attach() falla con el siguiente mensaje:

    "Screenshot capture is restricted by policy."

Los perfiles personales y los entornos no administrados siguen teniendo acceso sin restricciones a chrome.debugger como antes.

La API de chrome.debugger otorga acceso directo al Protocolo de Herramientas para desarrolladores de Chrome (CDP) para funciones potentes, como la evaluación arbitraria de secuencias de comandos y la intercepción de redes. Debido a que el CDP opera por debajo del modelo de origen de la plataforma web, el filtrado basado en el origen no puede restringirlo de forma segura, por lo que Chrome 155 resuelve este problema con un modelo de todo o nada, que valida las políticas empresariales por adelantado en cada llamada a chrome.debugger.attach().

Controla los rechazos de conexión de forma correcta

Controla siempre los rechazos de conexión en el código de tu extensión para proporcionar comentarios claros a los usuarios empresariales:

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

Considera usar APIs de alto nivel alternativas

Si tu extensión no requiere estrictamente acceso directo al CDP, evalúa migrar a APIs de extensiones de nivel superior que admitan permisos de host detallados y funcionen junto con las listas de entidades permitidas y bloqueadas de hosts empresariales:

  • Usa la API de chrome.scripting para ejecutar secuencias de comandos y, también, insertar estilos en las páginas permitidas.
  • Usa la API de chrome.declarativeNetRequest para inspeccionar, modificar o bloquear solicitudes de red de forma declarativa.
  • Usa la API de chrome.cookies con permisos de host estándar.

Orientación para administradores empresariales

Actualización (4 de noviembre de 2026): Se revirtió la aplicación de la política de Chrome 155 a través de una actualización de configuración del servidor, que Chrome descarga automáticamente y aplica después de un reinicio. Para inhabilitar la aplicación de medidas por incumplimiento sin esperar esta actualización, inicia Chrome con la marca de línea de comandos --disable-features=ExtensionDebuggerStrictPolicyRestrictions.

Hasta que la reversión entre en vigencia, se seguirán aplicando las siguientes instrucciones.

Los administradores empresariales que gestionan las políticas de extensiones deben tener en cuenta que las extensiones que requieren el permiso del depurador no pueden funcionar con restricciones parciales de host (runtime_blocked_hosts). Si una extensión necesita chrome.debugger, no debe tener hosts bloqueados configurados en ExtensionSettings.

Si la captura de pantalla está inhabilitada con DisableScreenshots o las reglas de Prevención de pérdida de datos (DLP), chrome.debugger.attach() fallará.

Las organizaciones que requieran listas de entidades bloqueadas de hosts o restricciones de capturas de pantalla deben verificar si sus extensiones internas o aprobadas pueden migrar a APIs de nivel superior, como chrome.scripting o chrome.declarativeNetRequest.

Enviar comentarios

Para obtener más detalles, consulta la documentación de la API de chrome.debugger. Si tienes preguntas o comentarios, comunícate con el Grupo de Google de extensiones de Chromium.