Cliente Windows

O agente é um serviço do Windows que faz as máquinas aparecerem no módulo de Manutenção de Endpoints. Sem ele, o módulo mostra uma lista vazia.

Documentação completa no repositório

Esta página cobre o que se precisa saber para decidir e para instalar. A referência detalhada — opções do instalador, formato de configuração, códigos de erro — vive no README do repositório IMAIS-DTI/openscale_client, que é a fonte de verdade e acompanha cada versão do agente. O repositório é privado hoje; o acesso vem junto com o acesso ao produto.

Princípios que determinam o comportamento

Três decisões de projeto explicam quase tudo que o agente faz:

Só disca para fora. O agente abre conexão HTTPS de saída e nunca escuta em porta alguma. Consequências: funciona em qualquer sub-rede sem rota adicional, não amplia superfície de ataque na estação, e não exige nada do firewall do cliente além de saída HTTPS.

Leve por requisito. A referência de projeto é uma máquina de escritório modesta — i3 com 8 GB. As metas são menos de 1% de CPU médio e menos de 60 MB de memória em repouso, com picos apenas no ciclo de coleta. Um coletor que compete com o usuário é desinstalado pelo próprio usuário.

Executa como serviço do sistema. Precisa disso para ler inventário, gerenciar software e abrir sessão remota. Também significa que a instalação exige privilégio administrativo.

O que ele coleta

Categoria	Conteúdo
Vitais	CPU, memória e disco, na cadência do sinal de vida
Inventário	Programas instalados, serviços, informações de rede, versão do sistema
Identificação	Nome do host, usuário conectado, endereço IP interno e externo
Identificadores de acesso remoto	Códigos das ferramentas de acesso remoto presentes na máquina

Isto é dado pessoal

Nome de usuário, nome de host e endereço IP identificam pessoas. Antes de instalar em frota, defina a base legal, a retenção e quem tem permissão de ver — ver Dados pessoais e LGPD. A permissão de acesso remoto é concessão separada da de ver o host, exatamente para permitir essa distinção.

Como uma máquina entra na frota

A cadeia tem três elos, e o token intermediário é o que permite instalar em lote sem distribuir senha:

1. Token de instalação — gerado no produto (ou pela API), com número de usos e validade. Prefixo ose_enroll_, exibido uma única vez.
2. Registro — o instalador envia o token e recebe as credenciais permanentes daquela máquina, incluindo o acesso ao armazenamento de evidências.
3. Operação — a máquina passa a enviar sinal de vida, buscar trabalho e reportar resultado com as próprias credenciais. O token de instalação não é mais usado.

Um token com 50 usos serve para um lote de 50 máquinas. O padrão é 1 uso — para frota, informe o número.

Gerar por API: ver Primeiros passos com a API.

Instalação em frota

O instalador aceita o endereço do servidor como parâmetro, o que permite distribuição por política de grupo sem ninguém digitar nada em máquina alguma.

# Instalação silenciosa, servidor e token vindos de parâmetro
msiexec /i openscale-client.msi /qn `
  SERVERURL="https://openscale.suaempresa.com.br" `
  ENROLLTOKEN="ose_enroll_…"

Os nomes exatos das propriedades acompanham a versão do instalador e estão no README do repositório.

Não embuta o token em script versionado

Token de instalação em script de inicialização dentro de repositório é a falha mais fácil de cometer e a mais difícil de perceber — ele vale para tantas máquinas quantos usos tiver, e sobrevive no histórico do Git mesmo depois de removido do arquivo. Passe-o por parâmetro da política de grupo, ou use um token de uso único por máquina.

Cadência, e o que ela custa

Variável no servidor	Padrão	Efeito
AGENT_HEARTBEAT_INTERVAL_SECONDS	60	Frequência do sinal de vida e da telemetria de vitais
AGENT_JOBS_POLL_SECONDS	30	Frequência com que a máquina busca trabalho pendente

A cadência do sinal de vida é o principal determinante de crescimento do banco: cerca de 11 kB por amostra. Com 500 máquinas a cada 60 segundos, são ~227 GB por mês sem poda. Ver dimensionamento.

O que o agente permite fazer

Depois de registrado, o host aparece no módulo de Manutenção e aceita, conforme a permissão de quem opera:

• Ver vitais, processos, rede, atualizações do sistema e regras de firewall
• Instalar e remover software, executar limpeza e scripts (manutencao.software)
• Abrir sessão remota, terminal e explorador de arquivos (manutencao.remoto)
• Receber tarefas agendadas sobre a frota

Limitações

• Somente Windows. Não há agente para Linux ou macOS, e não está planejado.
• Evidência vai direto ao armazenamento, por URL assinada — a máquina precisa alcançar o armazenamento de objetos, não só a aplicação. Ver Portas e exposição.