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).

info

Redtrust solo es compatible con AutoFirma 1.8.4 o superior.

El tipo de instalación adecuado depende del entorno. Usa la instalación estándar si el agente se instala 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 los certificados se cargan en el almacén del equipo, no en el del usuario.

Requisitos del sistema​

  • Microsoft Windows 10 u 11 (64 bits o ARM64), o Windows Server 2022, 2019 o 2016.
  • .NET Framework 4.8.
  • Microsoft .NET Runtime 8.0.0 (x64). A partir de Redtrust 4.42.2, el agente requiere .NET Runtime 10.
  • Visual C++ Redistributable for Visual Studio 2015-2022 x64 (o ARM64 en plataformas ARM64).
  • Visual C++ Redistributable for Visual Studio 2015-2022 x86.
  • Privilegios de administrador (solo durante la instalación).

Paso 1: Instalar el agente​

El agente de Redtrust se proporciona 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-VERSION-SUFFIX.msi para 64 bits y rt-agent-ARM64-VERSION-SUFFIX.msi para ARM64.

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

msiexec /i rt-agent-x64-VERSION-SUFFIX.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.

El proceso de instalación se guía a través de un asistente en el que puedes especificar el directorio donde se almacena el producto. El proceso dura solo unos segundos.

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 instalará 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.

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​

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?