Pular para o conteúdo principal
Version: 4.42

Instalação e implantação do agente Windows

Visão geral​

Este guia fornece instruções completas para instalar e desinstalar o agente Redtrust em ambientes Windows. Inclui etapas para instalações padrão, instalações silenciosas (configurações automatizadas sem interação do usuário) e instalações em modo servidor (para ambientes desatendidos). Este guia é destinado a administradores de sistemas ou responsáveis pela implantação e configuração do Redtrust.

Ao final deste guia, você terá instalado o agente Redtrust e configurado a plataforma.

Contexto​

Esses são os detalhes dos três tipos de instalação:

  • Instalação padrão: instala o agente por meio de um assistente guiado.
  • Instalação em modo servidor: projetada para ambientes onde aplicativos baseados em servidor no Windows precisam de certificados centralizados sem interação do usuário. Os certificados são carregados no armazenamento de certificados do computador, não no do usuário.
  • Instalação silenciosa: executa a instalação em segundo plano sem exibir o assistente ou exigir entrada do usuário.

Antes de começar​

Se você estiver instalando o Redtrust no Windows, certifique-se de ter o pacote de instalação, que inclui um arquivo de instalação (MSI) e um arquivo em lote (BAT).

O tipo de instalação adequado depende do ambiente. Use a instalação padrão se você instalar o agente em um computador de usuário final com sessão ativa, ou a instalação silenciosa para implantações em massa por GPO, SCCM ou sistemas similares. Se os aplicativos de servidor no Windows precisam acessar certificados sem um usuário conectado, use a instalação em modo servidor: o agente não executa processos no espaço do usuário e carrega os certificados no armazenamento de certificados do computador, não no do usuário.

aviso

Feche o Google Chrome e o Microsoft Edge antes de instalar ou atualizar o agente, qualquer que seja o método de instalação. A extensão do Redtrust mantém em execução um processo auxiliar (RTExtensionHostNet.exe) que bloqueia arquivos do diretório de instalação.

Com um navegador aberto, o assistente da instalação padrão pede que você feche esses aplicativos. A instalação silenciosa não exibe nenhuma caixa de diálogo e você não recebe esse aviso.

Requisitos do sistema​

O computador deve atender ao seguinte. O Visual C++ Redistributable e o .NET Desktop Runtime são obrigatórios apenas na instalação silenciosa:

  • Microsoft Windows 10 ou 11 (64 bits ou ARM64), ou Windows Server 2022, 2019 ou 2016.
  • .NET Framework 4.8. O instalador não o instala e interrompe a instalação se ele estiver ausente. Alguns sistemas operacionais já o incluem por padrão.
  • Visual C++ Redistributable for Visual Studio 2015-2022, pacotes x64 e x86.
  • Microsoft .NET Desktop Runtime, pacotes x64 e x86.
  • Privilégios de administrador (apenas durante a instalação).

Em computadores ARM64, instale apenas o pacote ARM64 do Visual C++ Redistributable e do .NET Desktop Runtime.

Até o Redtrust 4.42.1, o agente requer o .NET Desktop Runtime 8. A partir do Redtrust 4.42.2, requer o .NET Desktop Runtime 10.

Instale o Visual C++ Redistributable e o .NET Desktop Runtime antes de executar o MSI, em versões iguais ou superiores às exigidas pelo instalador. Se você instalar versões anteriores, o instalador as considera ausentes.

Na instalação padrão, instalá-los antes é recomendável, mas não obrigatório. Se algum dos dois estiver ausente, o instalador o baixa dos servidores da Microsoft, portanto o computador precisa de acesso a download.visualstudio.microsoft.com e a builds.dotnet.microsoft.com.

aviso

Na instalação silenciosa, é obrigatório instalar esses componentes antes. Se algum estiver ausente, a instalação falha.

Etapa 1: Instalar o agente​

O Redtrust distribui o agente como um pacote MSI, que aceita diversos parâmetros listados na página de parâmetros. Duas versões estão disponíveis: uma para 64 bits e uma compilação nativa para ARM64.

O nome do arquivo MSI inclui a arquitetura: rt-agent-x64-VERSÃO-SUFIXO.msi para 64 bits e rt-agent-ARM64-VERSÃO-SUFIXO.msi para ARM64.

Um exemplo de instalação do agente seria:

msiexec /i rt-agent-x64-VERSÃO-SUFIXO.msi RTPRIMARY=SERVIDOR_PRIMÁRIO RTSECONDARY=SERVIDOR_SECUNDÁRIO CLIENTID=SEU_CLIENT_ID LANGUAGE=pt-BR AuthMode=ActiveDirectory

Onde:

  • SERVIDOR_PRIMÁRIO e SERVIDOR_SECUNDÁRIO são os endereços dos servidores Redtrust primário e secundário.
  • SEU_CLIENT_ID é o identificador de cliente da sua instalação do Redtrust.

Um assistente guia você durante a instalação e permite escolher o diretório de instalação. O processo leva apenas alguns segundos.

Tela de boas-vindas do assistente de instalação do Redtrust com os botões Voltar, Próximo e Cancelar

info

Os valores de LANGUAGE e AuthMode que aparecem nos comandos são exemplos; consulte a página de parâmetros de instalação para ver os valores válidos e outros parâmetros suportados. Executar o instalador sem parâmetros instalará o agente com configurações padrão.

Etapa 2: Configurar o navegador​

Após instalar o agente, configure os navegadores para habilitar o gerenciamento de certificados do Redtrust. Siga as etapas definidas em Como configurar seu navegador.

nota

Se você instalou o agente no modo navegadores autônomos (UNATTENDED_BROWSERS=1), ignore esta etapa: a extensão do navegador não é instalada nem é necessária. Esta opção está disponível a partir da versão 4.42.3. Consulte Configurar navegadores autônomos.

nota

Se a sua organização gerencia os navegadores por meio de políticas corporativas, autorize também o host de mensagens nativas do Redtrust. Sem essa autorização, a extensão é instalada mas nunca chega a se conectar ao agente. Consulte Como autorizar mensagens nativas do Redtrust em navegadores gerenciados.

Etapa 3: Verificar a instalação​

Teste a instalação fazendo upload e usando um certificado, conforme explicado no tutorial de configuração inicial.

Desinstalação​

aviso

Feche o Google Chrome e o Microsoft Edge antes de desinstalar. Com um navegador aberto, o processo auxiliar da extensão (RTExtensionHostNet.exe) bloqueia arquivos do diretório de instalação e a desinstalação pode não ser concluída, o que deixa a extensão antiga do Redtrust registrada.

Verifique se a desinstalação terminou antes de instalar a nova versão. Se a extensão antiga e a nova coexistirem no navegador, o agente não funciona corretamente.

O Redtrust pode ser desinstalado de duas maneiras:

Desinstalação interativa

Use a interface padrão de Programas e Recursos do Windows para remover o Redtrust.

Desinstalação autônoma

Para desinstalação não assistida, use o comando msiexec:

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

Para recuperar o GUID do agente instalado, consulte o registro do Windows com o seguinte comando do PowerShell:

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

Esse comando produz detalhes como:

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

O valor de PSChildName é o GUID que você passa ao msiexec.

Próximas etapas​

Agora que você verificou a instalação, pode seguir um destes tutoriais:

Esta página foi útil?