Saltar al contenido principal
Versión: 4.42

Instalación y despliegue del agente Windows

Descripción general​

Esta guía proporciona instrucciones completas para instalar y desinstalar el agente Redtrust en entornos Windows. Incluye pasos para instalaciones estándar, instalaciones silenciosas (configuraciones automatizadas sin interacción del usuario) e instalaciones en modo servidor (para entornos desatendidos). Está destinada a administradores de sistemas o responsables del despliegue y configuración de Redtrust.

Al final de esta guía, habrás instalado el agente Redtrust y configurado la plataforma.

Contexto​

Estos son los detalles de los tres tipos de instalación:

  • Instalación estándar: Instala el agente mediante un asistente guiado.
  • Instalación en modo servidor: Diseñada para entornos donde las aplicaciones basadas en servidor en Windows necesitan certificados centralizados sin interacción del usuario. Los certificados se cargan en el almacén de certificados del equipo, no en el del usuario.
  • Instalación silenciosa: Ejecuta la instalación en segundo plano sin mostrar el asistente ni requerir interacción del usuario.

Antes de empezar​

Si vas a instalar Redtrust en Windows, asegúrate de tener el paquete de instalación, que incluye un archivo de instalación (MSI) y un archivo por lotes (BAT).

El tipo de instalación adecuado depende del entorno. Usa la instalación estándar si instalas el agente en un equipo de usuario final con sesión activa, o la instalación silenciosa para despliegues masivos por GPO, SCCM u otros sistemas. Si las aplicaciones de servidor en Windows necesitan certificados sin que haya un usuario conectado, usa la instalación en modo servidor: el agente no ejecuta procesos en el espacio de usuario y carga los certificados en el almacén del equipo, no en el del usuario.

aviso

Cierra Google Chrome y Microsoft Edge antes de instalar o actualizar el agente, sea cual sea el método de instalación. La extensión de Redtrust mantiene abierto un proceso auxiliar (RTExtensionHostNet.exe) que bloquea archivos del directorio de instalación.

Con un navegador abierto, el asistente de la instalación estándar te pide que cierres esas aplicaciones. La instalación silenciosa no muestra ningún diálogo y no recibes ese aviso.

Requisitos del sistema​

El equipo debe cumplir lo siguiente. Visual C++ Redistributable y .NET Desktop Runtime solo son obligatorios en la instalación silenciosa:

  • Microsoft Windows 10 u 11 (64 bits o ARM64), o Windows Server 2022, 2019 o 2016.
  • .NET Framework 4.8. El instalador no lo instala y detiene la instalación si falta. Algunos sistemas operativos ya lo incluyen de serie.
  • Visual C++ Redistributable for Visual Studio 2015-2022, paquetes x64 y x86.
  • Microsoft .NET Desktop Runtime, paquetes x64 y x86.
  • Privilegios de administrador (solo durante la instalación).

En equipos ARM64, instala únicamente el paquete ARM64 de Visual C++ Redistributable y de .NET Desktop Runtime.

Hasta Redtrust 4.42.1, el agente requiere .NET Desktop Runtime 8. A partir de Redtrust 4.42.2, requiere .NET Desktop Runtime 10.

Instala Visual C++ Redistributable y .NET Desktop Runtime antes de ejecutar el MSI, en versiones iguales o superiores a las que exige el instalador. Si instalas versiones anteriores, el instalador las considera ausentes.

En la instalación estándar, instalarlos antes es recomendable, pero no obligatorio. Si falta alguno de los dos, el instalador lo descarga de los servidores de Microsoft, así que el equipo necesita acceso a download.visualstudio.microsoft.com y builds.dotnet.microsoft.com.

aviso

En la instalación silenciosa es obligatorio instalar esos componentes antes. Si falta alguno, la instalación falla.

Paso 1: Instalar el agente​

Redtrust distribuye el agente como un paquete MSI, que acepta varios parámetros enumerados en la página de parámetros. Hay dos versiones disponibles: una para sistemas de 64 bits y una compilación nativa para ARM64.

El nombre del archivo MSI incluye la arquitectura: rt-agent-x64-VERSIÓN-SUFIJO.msi para 64 bits y rt-agent-ARM64-VERSIÓN-SUFIJO.msi para ARM64.

Un ejemplo de instalación del agente puede ser el siguiente:

msiexec /i rt-agent-x64-VERSIÓN-SUFIJO.msi RTPRIMARY=SERVIDOR_PRIMARIO RTSECONDARY=SERVIDOR_SECUNDARIO CLIENTID=TU_CLIENT_ID LANGUAGE=es-ES AuthMode=MÉTODO_AUTENTICACIÓN

Donde:

  • SERVIDOR_PRIMARIO y SERVIDOR_SECUNDARIO son las direcciones de los servidores Redtrust primario y secundario.
  • TU_CLIENT_ID es el identificador de cliente de tu instalación de Redtrust.
  • MÉTODO_AUTENTICACIÓN es el modo de autenticación del agente. Los valores posibles son LocalUsers, LDAP, ActiveDirectory, ActivationCode, SAML2 y OAUTH2. Si no lo especificas, se usa ActiveDirectory por defecto.

Un asistente te guía durante la instalación y te permite elegir el directorio de instalación. El proceso dura solo unos segundos.

Pantalla de bienvenida del asistente de instalación de Redtrust con los botones Atrás, Siguiente y Cancelar

info

El valor de LANGUAGE que aparece en los comandos es un ejemplo; consulta la página parámetros de instalación para ver los valores válidos y los demás parámetros admitidos. Ejecutar el instalador sin parámetros instala el agente con las configuraciones por defecto.

Paso 2: Configurar el navegador​

Tras instalar el agente, configura los navegadores para habilitar la gestión de certificados de Redtrust. Sigue los pasos definidos en Cómo configurar tu navegador.

nota

Si instalaste el agente en modo navegadores desatendidos (UNATTENDED_BROWSERS=1), omite este paso: la extensión del navegador no se instala ni es necesaria. Esta opción está disponible a partir de la versión 4.42.3. Consulta Configurar navegadores desatendidos.

nota

Si tu organización gestiona los navegadores mediante políticas corporativas, autoriza además el host de mensajería nativa de Redtrust. Sin esa autorización, la extensión se instala pero no llega a conectar con el agente. Consulta Cómo autorizar la mensajería nativa de Redtrust en navegadores gestionados.

Paso 3: Verificar la instalación​

Prueba la instalación subiendo y usando un certificado, como se explica en el tutorial de configuración inicial.

Desinstalación​

aviso

Cierra Google Chrome y Microsoft Edge antes de desinstalar. Con un navegador abierto, el proceso auxiliar de la extensión (RTExtensionHostNet.exe) bloquea archivos del directorio de instalación y la desinstalación puede no completarse, con lo que la extensión antigua de Redtrust sigue registrada.

Comprueba que la desinstalación ha terminado antes de instalar la versión nueva. Si la extensión antigua y la nueva conviven en el navegador, el agente no funciona correctamente.

Puedes desinstalar Redtrust de dos formas:

Desinstalación interactiva

Utiliza la interfaz estándar de Programas y Características de Windows para desinstalar Redtrust.

Desinstalación desatendida

Para la desinstalación desasistida, utiliza el comando msiexec:

msiexec /x {5F567E45-9801-4122-9213-1731DBC44E11} /q

Para recuperar el Globally Unique Identifier (GUID) del agente instalado, consulta el registro de Windows con el siguiente comando de PowerShell:

Get-ItemProperty HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\* |
Where-Object { $_.DisplayName -like "*Redtrust*" } |
Select-Object DisplayName, DisplayVersion, PSChildName

Este comando muestra detalles como:

DisplayName    : RedTrust
DisplayVersion : 4.10.5
PSChildName : {5F567E45-9801-4122-9213-1731DBC44E11}

El valor de PSChildName es el GUID que debes pasar a msiexec.

Próximos pasos​

Ahora que has verificado la instalación, puedes seguir alguno de estos tutoriales:

¿Te ha resultado útil esta página?