Saltar al contenido principal
Versión: 4.50

Hosts de mensajería nativa del agente

La extensión de Redtrust no se comunica con el agente por red, sino mediante el mecanismo de mensajería nativa del navegador. El navegador lee una clave del Registro de Windows que apunta a un archivo JSON, el manifiesto del host, y ese manifiesto declara qué ejecutable debe lanzar y qué extensiones pueden comunicarse con él. Si falta cualquiera de las dos piezas, la extensión se instala igualmente, pero nunca llega a conectar con el agente.

Esta página reúne los valores que el instalador del agente escribe en un equipo Windows, para que puedas comprobar la configuración de un equipo concreto. Si tu organización restringe la mensajería nativa mediante políticas corporativas, consulta Cómo autorizar la mensajería nativa de Redtrust en navegadores gestionados.

Claves del Registro​

El instalador crea una clave por navegador. El valor por defecto de cada clave contiene la ruta completa al manifiesto del host correspondiente.

NavegadorNombre del hostClave del 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

Estos son los valores que debe contener cada clave en una instalación estándar:

NavegadorValor de la clave
Google ChromeC:\Program Files\RedTrust\RTExtensionExplorer\RTCHProcessExplorer.json
Microsoft EdgeC:\Program Files\RedTrust\RTExtensionExplorer\RTEdgeProcessExplorer.json
Mozilla FirefoxC:\Program Files\RedTrust\RTExtensionExplorer\RTFFProcessExplorer.json
Solo en HKEY_LOCAL_MACHINE

El instalador escribe siempre estas claves en HKEY_LOCAL_MACHINE. Los tres navegadores leen también las mismas rutas bajo HKEY_CURRENT_USER, pero el agente de Redtrust no crea entradas ahí. Si existe una entrada de Redtrust en HKEY_CURRENT_USER, el navegador la usa antes que la de HKEY_LOCAL_MACHINE. Si apunta a un manifiesto antiguo o inexistente, la extensión no conecta con el agente. El instalador del agente no crea esa entrada.

Cuándo el instalador omite las claves​

El instalador crea cada clave solo si se cumplen dos condiciones:

  • El agente se instala en modo usuario: Con AGENTMODE=SERVER, el agente no registra ningún host de mensajería nativa, porque el modo servidor no usa extensiones de navegador.
  • El navegador no queda excluido: Cada entrada depende del parámetro de su navegador, según la tabla siguiente.
ParámetroEfecto
NO_CHROME=1El instalador omite la extensión y la clave de Chrome.
NO_EDGE=1El instalador omite la extensión y la clave de Edge.
NO_FIREFOX=1El instalador omite la extensión y la clave de Firefox.
UNATTENDED_BROWSERS=1El instalador omite todos los componentes de la extensión en los tres navegadores, incluidas las tres claves.

Consulta Parámetros de instalación del agente para ver la lista completa.

Manifiestos del host​

Los tres manifiestos apuntan al mismo ejecutable, C:\Program Files\RedTrust\host\RTExtensionHostNet.exe. La diferencia está en el nombre del host y en cómo cada navegador declara las extensiones autorizadas.

Chrome y Edge usan allowed_origins, con identificadores en formato URL. Ambos navegadores usan el esquema chrome-extension://, también Edge, así que no debes sustituirlo por extension:// en el manifiesto de Edge.

Manifiesto de 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/"
]
}

Manifiesto de 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/"
]
}

Firefox usa allowed_extensions, con identificadores en formato de dirección de correo electrónico en lugar de URL. Manifiesto de 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 de las extensiones​

Cada manifiesto autoriza varias variantes de la extensión a la vez, de modo que el host sigue funcionando tanto si el equipo tiene la extensión publicada como si tiene la versión beta o una basada en el manifest V2 antiguo. El parámetro EXT_V3 determina cuál se instala, pero el manifiesto mantiene listadas todas las variantes.

NavegadorManifest V2Manifest V3Beta
Google Chromepcicdcmhjogafcifkoimbfmpepdhnljeijdeibmhkjmgbjofgiaodomklfdnagdglofomkfpahkabmmocnnbmaaeooolmnlf
Microsoft Edgekchdcfmphcejeinpcbgkfaejlohfcflomdlfgfcdgbdpidpbomkpjamoadggabmiggfdlfhmdenmdecomcakhdhfdjjlnepa

Firefox no distingue entre manifest V2 y V3 en estos identificadores. Usa rtffmonitor-extension@evolium.com para la extensión publicada y rtffmonitor-beta2-extension@evolium.com para la beta.

nota

EXT_V3=1 es el valor por defecto y corresponde a la extensión con manifest V3. Chrome y Edge han retirado la compatibilidad con el manifest V2, así que los identificadores de esa columna solo son relevantes en equipos antiguos que todavía no se han actualizado.

Documentación relacionada​

¿Te ha resultado útil esta página?