Pular para o conteúdo principal
Version: 4.42

Como autorizar mensagens nativas do Redtrust em navegadores gerenciados

Visão geral​

Este guia explica como autorizar as mensagens nativas do Redtrust no Chrome e no Edge quando as políticas corporativas restringem o uso delas. Ele se destina a administradores de TI que gerenciam os navegadores da organização.

As mensagens nativas permitem que a extensão se comunique com o agente instalado na máquina. Para isso, o navegador inicia um programa intermediário, o host do Redtrust, e precisa permitir o uso dele. Enquanto estiver bloqueado, a extensão não consegue se comunicar com o agente, mesmo instalada e habilitada.

Para conhecer os valores que o agente grava em cada máquina, consulte Hosts de mensagens nativas do agente.

nota

Se você instalar o agente com NO_CHROME=1 ou NO_EDGE=1, o instalador não registra o host desse navegador e não há nada a autorizar nele. Com UNATTENDED_BROWSERS=1, o instalador não registra o host de nenhum navegador.

Etapas​

Etapa 1: Adicionar o host do Redtrust à NativeMessagingAllowlist​

NativeMessagingAllowlist é a política que lista os hosts de mensagens nativas autorizados. Ela tem prioridade sobre a NativeMessagingBlocklist, a lista de bloqueio, portanto basta adicionar o host do Redtrust à lista de autorizados.

Este é o valor que deve ser adicionado conforme o navegador:

NavegadorValor que deve ser adicionado
Google Chromecom.redtrust.monitorhost.chrome
Microsoft Edgecom.redtrust.monitorhost.msedge

Adicione esses valores à política NativeMessagingAllowlist com a ferramenta que você usa para gerenciar os navegadores, nas máquinas onde o agente do Redtrust está instalado. Seja qual for a ferramenta, a política termina como valores nestas chaves do registro do Windows de cada máquina:

NavegadorChave da política
Google ChromeHKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\NativeMessagingAllowlist
Microsoft EdgeHKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\NativeMessagingAllowlist

Dentro da chave, cada host é um valor de cadeia com um número consecutivo como nome (1, 2, 3 e assim por diante), portanto use o próximo número livre. Se a chave não existir, crie-a: as chaves de Policies só aparecem quando há alguma política configurada. Não deixe espaços no início nem no fim do valor, porque um espaço sobrando impede que o navegador reconheça o host.

Se você gerencia os navegadores pelo Active Directory/GPO, habilite a política na seção de mensagens nativas dos modelos administrativos do navegador e adicione o host como uma entrada da lista. Por exemplo, a política do Chrome fica em Administrative Templates > Google > Google Chrome > Native Messaging, e a do Edge em Administrative Templates > Microsoft Edge > Native Messaging. Para mais detalhes sobre a política, consulte a documentação dela no Chrome e do Edge.

Se você editar o registro diretamente em uma máquina que gerencia de forma centralizada, a próxima atualização de políticas pode sobrescrever a alteração.

Chave do host e chave de políticas

O agente registra o host em SOFTWARE\Google\Chrome\NativeMessagingHosts\, uma chave própria que não precisa de alterações para configurar esta política.

A política é configurada em SOFTWARE\Policies\Google\Chrome\ e determina quais hosts o navegador autoriza. Você pode consultar os dois locais em Hosts de mensagens nativas do agente.

O valor desta política identifica o host. A autorização da extensão é gerenciada separadamente por meio de ExtensionInstallAllowlist, que não participa desta configuração.

Não use os nomes antigos

NativeMessagingWhitelist e NativeMessagingBlacklist são os nomes antigos dessas políticas, e as versões atuais do Chrome e do Edge as ignoram. Se você configurá-las, o navegador as exibe na página de políticas com o erro Unknown policy. e elas não têm nenhum efeito. Use sempre NativeMessagingAllowlist.

Etapa 2: Aplicar as alterações​

O navegador pode aplicar a política sem ser reiniciado: a próxima etapa verifica o resultado. Se a extensão continuar sem se conectar ao agente, feche o navegador por completo, incluindo os processos em segundo plano, para que ele leia novamente a política e as chaves de mensagens nativas.

Para o Chrome:

taskkill /IM "chrome.exe" /F

Para o Edge:

taskkill /IM "msedge.exe" /F
aviso

O comando taskkill /F fecha o navegador de forma forçada e o usuário perde as abas abertas e os formulários não salvos. Avise o usuário antes ou reinicie a máquina em uma janela de manutenção.

Etapa 3: Verificar a política aplicada​

  1. Abra chrome://policy no Chrome ou edge://policy no Edge.
  2. Clique em Reload policies e procure NativeMessagingAllowlist na lista.
  3. Verifique se o host do Redtrust aparece entre os valores dela e se a política não mostra nenhum erro.
  4. Para revisar a configuração em detalhe ou enviá-la ao suporte do Redtrust, clique em Export to JSON.

Resumo​

A extensão do Redtrust precisa de duas coisas para se comunicar com o agente: a chave do registro que o instalador cria na máquina e a permissão do navegador para usar esse host. Nos ambientes que restringem as mensagens nativas por política, basta adicionar o nome do host à NativeMessagingAllowlist, verificar o resultado na página de políticas e reiniciar o navegador se a extensão continuar sem se conectar.

Próximas etapas​

Depois que o host estiver autorizado, você pode:

Esta página foi útil?