Aplicação mais rigorosa da política empresarial para chrome.debugger no Chrome 155

Publicado em: 8 de setembro de 2026, última atualização: 4 de novembro de 2026

A partir do Chrome 155, as atualizações do Chrome vão mudar a forma como as restrições de políticas corporativas se aplicam às extensões que usam a API chrome.debugger.

Essa mudança afeta apenas as extensões em execução em navegadores gerenciados em que um administrador configurou explicitamente as regras runtime_blocked_hosts, DisableScreenshots ou de Prevenção contra perda de dados (DLP).

Se uma extensão for executada em um navegador não gerenciado ou em um ambiente corporativo sem essas restrições de política específicas, o chrome.debugger vai continuar funcionando normalmente sem mudanças.

Cronograma e lançamento

  • Chrome 155 Beta: 16 de setembro de 2026
  • Lançamento do Chrome 155 Stable: 6 de outubro de 2026
  • Reversão: 3 de novembro de 2026

Principais mudanças no Chrome 155

As mudanças a seguir afetam apenas os navegadores gerenciados por empresas:

  • Restrições de host: se uma política corporativa (ExtensionSettings) configurar uma lista de hosts bloqueados não vazia (runtime_blocked_hosts) para uma extensão, chrome.debugger.attach() será rejeitado em todos os destinos com:

    "Host access is restricted by policy."

    Isso acontece mesmo que origens específicas sejam incluídas em runtime_allowed_hosts.

  • Restrições de captura de tela e DLP: se a captura de tela estiver desativada por uma política empresarial (DisableScreenshots ou regras de Prevenção contra perda de dados (DLP)), chrome.debugger.attach() vai falhar com:

    "Screenshot capture is restricted by policy."

Os perfis pessoais e os ambientes não gerenciados continuam tendo acesso irrestrito ao chrome.debugger como antes.

A API chrome.debugger concede acesso direto ao Chrome DevTools Protocol (CDP) para recursos avançados, incluindo avaliação de scripts arbitrários e interceptação de rede. Como o CDP opera abaixo do modelo de origem da plataforma da Web, a filtragem baseada em origem não pode restringi-lo com segurança. Por isso, o Chrome 155 resolve esse problema com um modelo de tudo ou nada, validando as políticas corporativas com antecedência em cada chamada chrome.debugger.attach().

Processar rejeições de anexação de maneira adequada

Sempre trate as rejeições de anexação no código da extensão para dar um feedback claro aos usuários corporativos:

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

Considere APIs alternativas de alto nível

Se a extensão não exigir estritamente o acesso direto ao CDP, considere migrar para APIs de extensão de nível mais alto que oferecem suporte a permissões de host granulares e funcionam com listas de permissões e de bloqueio de hosts corporativos:

Orientação para administradores de empresas

Atualização (4 de novembro de 2026): a aplicação da política do Chrome 155 foi revertida por uma atualização de configuração do lado do servidor, que o Chrome baixa automaticamente e aplica após uma reinicialização. Para desativar a aplicação sem esperar por essa atualização, inicie o Chrome com a flag de linha de comando --disable-features=ExtensionDebuggerStrictPolicyRestrictions.

Até que a reversão entre em vigor, as orientações a seguir ainda se aplicam.

Os administradores corporativos que gerenciam políticas de extensão precisam observar que as extensões que exigem a permissão do depurador não podem operar com restrições parciais de host (runtime_blocked_hosts). Se uma extensão precisar de chrome.debugger, ela não poderá ter hosts bloqueados configurados em ExtensionSettings.

Se a captura de tela estiver desativada usando as regras DisableScreenshots ou de Prevenção contra perda de dados (DLP), chrome.debugger.attach() vai falhar.

As organizações que exigem listas de bloqueio de host ou restrições de captura de tela precisam verificar se as extensões internas ou aprovadas podem migrar para APIs de nível mais alto, como chrome.scripting ou chrome.declarativeNetRequest.

Compartilhar feedback

Para mais detalhes, consulte a documentação da API chrome.debugger. Se tiver dúvidas ou feedback, entre em contato com o Grupo do Google de extensões do Chromium.