Instalar o agente em um computador

Antes de começar

• Computador com Windows 10 ou Windows 11, 64 bits.
• Uma conta de administrador nesse computador.
• Acesso à internet por HTTPS (porta 443) até o endereço do painel.
• No painel, um usuário com permissão para gerar tokens de instalação.

1. Baixe o agente

No painel, abra Instalar agente e clique em Baixar agente. O arquivo é um ZIP com dois programas. A página mostra o SHA-256 do pacote, para quem quiser conferir a integridade do download.

Extraia o conteúdo em uma pasta qualquer, por exemplo C:\Instalar.

2. Gere um token de instalação

Ainda em Instalar agente, preencha Novo token de instalação: uma descrição, a validade em dias e, se quiser, um limite de usos, um grupo e um departamento de destino.

O token aparece uma única vez, junto com o comando pronto. Copie-o nesse momento; depois o painel mostra só o começo dele.

3. Rode o comando como administrador

Abra o Prompt de Comando como administrador, vá até a pasta onde extraiu o agente e cole o comando mostrado pelo painel. Ele tem este formato:

SynapseOneSvc.exe --install --server https://seu-endereco --token soe_xxxxxxxxxxxxxxxx

O que a instalação faz

• copia os dois programas para C:\Program Files\SynapseOne;
• registra o serviço SynapseOne Agent, com início automático;
• cadastra o computador na sua organização com o token informado;
• inicia o ícone do SynapseOne ao lado do relógio para o usuário conectado;
• inclui o programa em Aplicativos instalados, com desinstalador.

A credencial que o computador recebe fica cifrada no próprio computador. O token não é guardado depois do cadastro.

4. Confira no painel

Em Dispositivos, o computador aparece em cerca de um minuto, já com o inventário de hardware. A lista de programas e os dados de segurança chegam nos minutos seguintes.

Instalar em vários computadores

O mesmo token serve para vários computadores, até a validade e o limite de usos definidos. O comando pode ser distribuído pela ferramenta que você já usa — política de grupo, script de logon ou um software de implantação —, desde que rode com privilégio de administrador.

Se algo não der certo

• “Token inválido”: o token expirou, foi revogado ou atingiu o limite de usos. Gere outro.
• O computador não aparece: confira se ele alcança o endereço do painel por HTTPS e veja Agente offline ou aguardando licença.
• O antivírus bloqueou: veja O agente e o Microsoft Defender. Não desative a proteção.