Pular para o conteúdo principal
Version: 4.42

Hosts de mensagens nativas do agente

A extensão do Redtrust não se comunica com o agente pela rede, e sim pelo mecanismo de mensagens nativas do navegador. O navegador lê uma chave do registro do Windows que aponta para um arquivo JSON, o manifesto do host, e esse manifesto declara qual executável deve ser iniciado e quais extensões podem se comunicar com ele. Se qualquer uma das duas peças estiver ausente, a extensão é instalada mesmo assim, mas nunca chega a se conectar ao agente.

Esta página reúne os valores que o instalador do agente grava em uma máquina Windows, para que você possa verificar a configuração de uma máquina específica. Se a sua organização restringir as mensagens nativas por meio de políticas corporativas, consulte Como autorizar mensagens nativas do Redtrust em navegadores gerenciados.

Chaves do registro​

O instalador cria uma chave por navegador. O valor padrão de cada chave contém o caminho completo para o manifesto do host correspondente.

NavegadorNome do hostChave do registro
Google Chromecom.redtrust.monitorhost.chromeHKEY_LOCAL_MACHINE\SOFTWARE\Google\Chrome\NativeMessagingHosts\com.redtrust.monitorhost.chrome
Microsoft Edgecom.redtrust.monitorhost.msedgeHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Edge\NativeMessagingHosts\com.redtrust.monitorhost.msedge
Mozilla Firefoxcom.redtrust.monitorhost.firefoxHKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\NativeMessagingHosts\com.redtrust.monitorhost.firefox

Estes são os valores que cada chave deve conter em uma instalação padrão:

NavegadorValor da chave
Google ChromeC:\Program Files\RedTrust\RTExtensionExplorer\RTCHProcessExplorer.json
Microsoft EdgeC:\Program Files\RedTrust\RTExtensionExplorer\RTEdgeProcessExplorer.json
Mozilla FirefoxC:\Program Files\RedTrust\RTExtensionExplorer\RTFFProcessExplorer.json
Apenas em HKEY_LOCAL_MACHINE

O instalador sempre grava essas chaves em HKEY_LOCAL_MACHINE. Os três navegadores também leem os mesmos caminhos em HKEY_CURRENT_USER, mas o agente do Redtrust não cria entradas lá. Se existir uma entrada do Redtrust em HKEY_CURRENT_USER, o navegador a usa antes da entrada de HKEY_LOCAL_MACHINE. Se ela apontar para um manifesto antigo ou inexistente, a extensão não consegue se conectar ao agente. O instalador do agente não cria essa entrada.

Quando o instalador ignora as chaves​

O instalador cria cada chave somente quando duas condições são atendidas:

  • O agente é instalado no modo usuário: com AGENTMODE=SERVER, o agente não registra nenhum host de mensagens nativas, porque o modo servidor não usa extensões de navegador.
  • O navegador não está excluído: cada entrada depende do parâmetro do seu navegador, conforme a tabela a seguir.
ParâmetroEfeito
NO_CHROME=1O instalador ignora a extensão e a chave do Chrome.
NO_EDGE=1O instalador ignora a extensão e a chave do Edge.
NO_FIREFOX=1O instalador ignora a extensão e a chave do Firefox.
UNATTENDED_BROWSERS=1O instalador ignora todos os componentes da extensão nos três navegadores, incluindo as três chaves.

Consulte Parâmetros de instalação do agente para ver a lista completa.

Manifestos do host​

Os três manifestos apontam para o mesmo executável, C:\Program Files\RedTrust\host\RTExtensionHostNet.exe. O que muda é o nome do host e a forma como cada navegador declara as extensões autorizadas.

O Chrome e o Edge usam allowed_origins, com identificadores em formato de URL. Os dois navegadores usam o esquema chrome-extension://, inclusive o Edge, portanto não o substitua por extension:// no manifesto do Edge.

Manifesto do Chrome (RTCHProcessExplorer.json):

{
"name": "com.redtrust.monitorhost.chrome",
"description": "RedTrust Monitor Extension Host",
"path": "C:\\Program Files\\RedTrust\\host\\RTExtensionHostNet.exe",
"type": "stdio",
"allowed_origins": [
"chrome-extension://pcicdcmhjogafcifkoimbfmpepdhnlje/",
"chrome-extension://ijdeibmhkjmgbjofgiaodomklfdnagdg/",
"chrome-extension://lofomkfpahkabmmocnnbmaaeooolmnlf/"
]
}

Manifesto do Edge (RTEdgeProcessExplorer.json):

{
"name": "com.redtrust.monitorhost.msedge",
"description": "RedTrust Monitor Extension Host",
"path": "C:\\Program Files\\RedTrust\\host\\RTExtensionHostNet.exe",
"type": "stdio",
"allowed_origins": [
"chrome-extension://kchdcfmphcejeinpcbgkfaejlohfcflo/",
"chrome-extension://mdlfgfcdgbdpidpbomkpjamoadggabmi/",
"chrome-extension://ggfdlfhmdenmdecomcakhdhfdjjlnepa/"
]
}

O Firefox usa allowed_extensions, com identificadores em formato de endereço de email em vez de URL. Manifesto do Firefox (RTFFProcessExplorer.json):

{
"name": "com.redtrust.monitorhost.firefox",
"description": "RedTrust Monitor Extension Host",
"path": "C:\\Program Files\\RedTrust\\host\\RTExtensionHostNet.exe",
"type": "stdio",
"allowed_extensions": [
"rtffmonitor-extension@evolium.com",
"rtffmonitor-beta2-extension@evolium.com"
]
}

Identificadores das extensões​

Cada manifesto autoriza várias variantes da extensão ao mesmo tempo, de modo que o host continua funcionando tanto com a extensão publicada quanto com a versão beta ou com uma versão baseada no manifest V2 antigo. O parâmetro EXT_V3 determina qual delas é instalada, mas o manifesto mantém todas as variantes listadas.

NavegadorManifest V2Manifest V3Beta
Google Chromepcicdcmhjogafcifkoimbfmpepdhnljeijdeibmhkjmgbjofgiaodomklfdnagdglofomkfpahkabmmocnnbmaaeooolmnlf
Microsoft Edgekchdcfmphcejeinpcbgkfaejlohfcflomdlfgfcdgbdpidpbomkpjamoadggabmiggfdlfhmdenmdecomcakhdhfdjjlnepa

O Firefox não faz distinção entre manifest V2 e V3 nesses identificadores. Ele usa rtffmonitor-extension@evolium.com para a extensão publicada e rtffmonitor-beta2-extension@evolium.com para a beta.

nota

EXT_V3=1 é o valor padrão e corresponde à extensão com manifest V3. O Chrome e o Edge encerraram a compatibilidade com o manifest V2, portanto os identificadores dessa coluna só são relevantes em máquinas antigas que ainda não foram atualizadas.

Documentação relacionada​

Esta página foi útil?