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.
| Navegador | Nome do host | Chave do registro |
|---|---|---|
| Google Chrome | com.redtrust.monitorhost.chrome | HKEY_LOCAL_MACHINE\SOFTWARE\Google\Chrome\NativeMessagingHosts\com.redtrust.monitorhost.chrome |
| Microsoft Edge | com.redtrust.monitorhost.msedge | HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Edge\NativeMessagingHosts\com.redtrust.monitorhost.msedge |
| Mozilla Firefox | com.redtrust.monitorhost.firefox | HKEY_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:
| Navegador | Valor da chave |
|---|---|
| Google Chrome | C:\Program Files\RedTrust\RTExtensionExplorer\RTCHProcessExplorer.json |
| Microsoft Edge | C:\Program Files\RedTrust\RTExtensionExplorer\RTEdgeProcessExplorer.json |
| Mozilla Firefox | C:\Program Files\RedTrust\RTExtensionExplorer\RTFFProcessExplorer.json |
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âmetro | Efeito |
|---|---|
NO_CHROME=1 | O instalador ignora a extensão e a chave do Chrome. |
NO_EDGE=1 | O instalador ignora a extensão e a chave do Edge. |
NO_FIREFOX=1 | O instalador ignora a extensão e a chave do Firefox. |
UNATTENDED_BROWSERS=1 | O 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.
| Navegador | Manifest V2 | Manifest V3 | Beta |
|---|---|---|---|
| Google Chrome | pcicdcmhjogafcifkoimbfmpepdhnlje | ijdeibmhkjmgbjofgiaodomklfdnagdg | lofomkfpahkabmmocnnbmaaeooolmnlf |
| Microsoft Edge | kchdcfmphcejeinpcbgkfaejlohfcflo | mdlfgfcdgbdpidpbomkpjamoadggabmi | ggfdlfhmdenmdecomcakhdhfdjjlnepa |
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.
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?