Skip to Content

Agente de endpoint

Instale, atualize e remova o agente de endpoint em Windows, macOS e Linux, e saiba o que comunica a partir do dispositivo.

RequiresDevice Identity (DIAM)

Add-on necessário: O agente de endpoint faz parte do add-on DIAM (Device Identity).

O agente de endpoint é o software que instala em cada endpoint. Inscreve a máquina, comunica a respetiva postura de segurança de acordo com um calendário e executa as ações remotas desencadeadas a partir da consola. Sem ele, um dispositivo não pode constar do inventário. Os dispositivos inscritos com o cliente Windows anterior continuam a funcionar; consulte Legacy client para saber o que difere e como migrá-los.

Plataformas suportadas

PlataformaSuportada a partir de
WindowsWindows 11 e Windows Server 2019, x64
macOSmacOS 12 Monterey, Intel e Apple silicon
LinuxDebian 11, Ubuntu 22.04 e Red Hat Enterprise Linux 9 (incluindo Rocky e Alma), x64 e ARM64, com systemd

As versões mais antigas não são suportadas. Quando a máquina tem um TPM 2.0 (Windows, Linux) ou um Secure Enclave (Apple silicon, Macs com chip T2), o agente guarda nele a sua chave de dispositivo; nos restantes casos, utiliza uma chave guardada no disco.

O que é instalado

PlataformaPacoteO que é executado
Windows.msiO serviço DTS Endpoint Agent (DTSAgent), instalado em %ProgramFiles%\DTS\Agent e iniciado no arranque. A janela do agente inicia em cada início de sessão de um utilizador.
macOS.pkgUm daemon de sistema em /Library/DTS/Agent e a aplicação DTS Endpoint Agent na barra de menus de cada sessão de utilizador.
Linux.deb, .rpmO serviço dts-agent.service e um ícone de estado nas sessões de ambiente de trabalho. Os servidores sem ambiente de trabalho executam apenas o serviço.

O agente mantém o seu estado, incluindo a identidade do dispositivo, em %ProgramData%\DTS\Agent (Windows), /Library/Application Support/DTS/Agent (macOS) ou /var/lib/dts-agent (Linux), pelo que uma atualização no local não volta a inscrever a máquina. Os seus ficheiros de registo encontram-se na pasta logs desse local e são mantidos durante sete dias.

Requisitos

  • Direitos de administrador ou de root para instalar, uma vez que o pacote regista um serviço de sistema.
  • HTTPS de saída para a instância da plataforma. O agente estabelece a ligação e mantém-na aberta. Não é necessária qualquer regra de firewall de entrada.
  • Um proxy que inspeciona TLS funciona assim que o respetivo certificado de raiz for considerado fidedigno no arquivo do próprio sistema operativo (o arquivo da máquina no Windows, o porta-chaves Sistema no macOS, o pacote de CA da distribuição no Linux). Nada é configurado no agente.

Obter o instalador

O instalador é criado para a sua instância: o endereço da plataforma e o certificado de que o agente necessita para se inscrever estão nele incorporados, e está assinado com código. Um instalador de outra instância não funciona, e não há nada a configurar no momento da instalação.

  1. Abra Definições de dispositivos → Registo.
  2. Solicite uma compilação caso ainda não exista nenhuma e transfira-a assim que estiver pronta. O cartão mostra a versão e as respetivas somas de verificação SHA-1 e SHA-256.
  3. Verifique as somas de verificação e distribua o pacote pelos seus endpoints.

A consola disponibiliza atualmente o pacote Windows. Os pacotes para macOS e Linux ainda não estão disponíveis para transferência na consola.

Consulte Definições de dispositivos para o certificado de inscrição que ancora este processo e para a respetiva rotação.

Instalar e inscrever

Instale o pacote com direitos de administrador, manualmente ou através da sua ferramenta de distribuição de software ou MDM. Instala para todos os utilizadores e inicia o serviço. Os pacotes não aceitam opções, pelo que uma instalação silenciosa não precisa de mais do que os parâmetros habituais da plataforma:

msiexec /i dts-agent-<version>.msi /qn
sudo installer -pkg dts-agent-<version>.pkg -target /
sudo apt install ./dts-agent_<version>_amd64.deb
sudo dnf install ./dts-agent-<version>.x86_64.rpm

A inscrição decorre depois por si só. O agente cria a sua chave de dispositivo, regista-se na plataforma e recebe a sua identidade de dispositivo. Nada tem de ser introduzido no endpoint. Consoante o modo de Registo de dispositivos nas definições de dispositivos, o dispositivo fica gerido de imediato ou aguarda a sua aprovação no inventário de dispositivos.

No macOS, parte da postura (por exemplo, partes das definições de segurança) requer Acesso total ao disco, que um pacote não pode conceder. Conceda-o ao agente com um perfil de preferências de privacidade (PPPC) do seu MDM; sem ele, esses valores ficam em falta e o restante é comunicado normalmente.

Nota: A identidade do dispositivo é criada na primeira inscrição e guardada na máquina. Recriar a imagem de um dispositivo, ou apagar esse estado, produz um novo registo de dispositivo. O antigo permanece no inventário até caducar ou até o eliminar.

O que o agente comunica

A postura é recolhida a cada cinco minutos e enviada como diferença face ao último relatório, com um instantâneo completo pelo menos uma vez por dia ou sempre que a plataforma o solicitar. Entre relatórios, o agente envia uma breve comunicação a cada poucos segundos, e é isso que faz com que um dispositivo apareça como ligado.

O agente comunica:

  • Sistema operativo e hardware: versão, build, arquitetura, modelo do computador, CPU e memória, e se a máquina é virtual.
  • Identidade da máquina e dos seus utilizadores: hostname, domínio, a conta com sessão iniciada e as contas de utilizador do dispositivo.
  • Configuração de rede: adaptadores com endereços MAC e IP, gateways e servidores DNS.
  • Volumes e encriptação de disco (BitLocker, FileVault, volumes Linux encriptados).
  • Software instalado com fabricante, versão e data de instalação.
  • Estado de segurança: firewall, Microsoft Defender no Windows e definições como Secure Boot, TPM, Gatekeeper, System Integrity Protection, se o Mac é gerido por um MDM e se é exigida uma palavra-passe após o bloqueio do ecrã.
  • Atualizações do sistema operativo em falta com a gravidade e a indicação de se é necessário reiniciar.
  • Se a sessão de consola está bloqueada, com a comunicação. A página do dispositivo só o mostra quando o ativar.
  • O seu próprio estado: versão, estado de isolamento e estado do registo de MFA.

Não recolhe geolocalização no endpoint (a plataforma deriva a localização aproximada a partir do endereço IP da ligação) e não recolhe histórico de navegação, conteúdos de ficheiros, teclas premidas nem capturas de ecrã. A lista de processos, com as linhas de comandos e a conta com que cada processo é executado, só é recolhida quando um administrador executa essa ação remota.

O âmbito da recolha é fixo. É o mesmo em todos os dispositivos de uma plataforma, e os utilizadores podem consultá-lo na janela do agente (abaixo). Planeie a implementação com os responsáveis pelos acordos com a comissão de trabalhadores ou pela aprovação em matéria de proteção de dados na sua organização: o inventário, a conta com sessão iniciada e a lista de processos obtida a pedido são dados pessoais na maioria das jurisdições.

A janela do agente

Cada utilizador vê o agente na área de notificação (Windows), na barra de menus (macOS) ou como ícone de estado (Linux). O respetivo menu mostra a hora do último relatório, e Verificar agora pede à plataforma um resultado de conformidade atualizado. A janela tem as seguintes páginas:

PáginaMostra
EstadoSe o dispositivo está ligado, inscrito e a comunicar, e o que está a falhar neste momento.
ConformidadeO último resultado de conformidade do dispositivo, com as verificações que falharam.
Início de sessão com dois fatoresNo Windows, os segundos fatores do utilizador para o início de sessão do Windows, quando o próprio dispositivo os verifica.
PrivacidadeCada consulta que o agente executa e os dados que enviou por último.
Acerca deA versão e Enviar diagnóstico / Guardar diagnóstico para casos de suporte.

A linha de comandos

O agente instala um comando dts-agent para os administradores e o suporte no dispositivo:

ComandoFinalidade
dts-agent statusO estado do agente em JSON: ligação, inscrição, o último relatório, isolamento e cada passo que está a falhar neste momento, com a respetiva mensagem. A primeira coisa a consultar quando um dispositivo se comporta de forma anómala.
dts-agent compliance --refreshO último resultado de conformidade, pedido novamente à plataforma.
dts-agent revert-isolationLevanta localmente o isolamento de rede, executado como administrador ou root. Para um dispositivo cuja ligação à plataforma foi cortada pelo isolamento. O levantamento fica registado.

Comportamento quando a plataforma está inacessível

O agente continua a tentar com intervalos crescentes de até cinco minutos e volta a ligar-se por si só. Os relatórios de postura não ficam em fila enquanto a ligação estiver interrompida, pelo que, após uma indisponibilidade, a plataforma vê o estado atual e não o histórico perdido. O dispositivo aparece offline na consola cerca de dez segundos após a última comunicação. Uma VPN de túnel completo que encaminhe tudo pela rede da empresa também tem de permitir a ligação à sua instância; caso contrário, o dispositivo permanece offline enquanto a VPN estiver ativa.

Atualizar

O agente não se atualiza a si próprio. Uma atualização é um novo pacote, distribuído da mesma forma que o primeiro.

  1. Solicite a nova versão em Definições de dispositivos → Registo e transfira-a.
  2. Distribua-a pelos endpoints com a sua ferramenta de distribuição de software ou MDM.

A instalação atualiza no local e preserva a identidade do dispositivo, pelo que os dispositivos não se voltam a inscrever e o respetivo histórico é mantido. Teste a atualização num grupo piloto antes de a distribuir por todo o parque.

Desinstalar

  1. Desinstale o agente da forma habitual da plataforma (Definições → Aplicações no Windows, a sua ferramenta de distribuição de software ou MDM, apt remove ou dnf remove no Linux). No macOS, execute sudo dts-agent uninstall. A desinstalação levanta primeiro um isolamento de rede e, em seguida, remove o serviço, os ficheiros de programa, o estado do agente e a sua chave de dispositivo.
  2. Elimine o dispositivo no inventário. A desinstalação não notifica a plataforma, pelo que o registo permanece até o remover.

Nota: No Debian e no Ubuntu, apt remove mantém o estado do agente até purgar o pacote (apt purge). A remoção do .rpm e a desinstalação no Windows e no macOS removem-no.

Resolução de problemas

  • O dispositivo nunca aparece no inventário. Execute dts-agent status no dispositivo: indica o passo que falha. Confirme que o endpoint consegue alcançar a sua instância a partir da rede de saída e que o modo de inscrição aceita novos dispositivos. Um instalador criado para outra instância nunca se inscreve.
  • O estado comunica um erro de ligação, mas a rede funciona. Normalmente, trata-se de um proxy que inspeciona TLS e cujo certificado de raiz não se encontra no arquivo do sistema operativo. Consulte Requisitos.
  • Um dispositivo aparece duas vezes. A imagem da máquina foi recriada ou a máquina perdeu o estado local e voltou a inscrever-se. Elimine o registo antigo.
  • Os dados de software ou de patches parecem desatualizados. A postura é comunicada de acordo com um calendário. Utilize a ação remota Request full update para forçar um relatório completo.
  • O browser pede autorização para aceder à rede local durante o início de sessão. As verificações de conformidade no início de sessão funcionam com a página de início de sessão a consultar o agente na própria máquina. O Chrome 142 e versões mais recentes, bem como o Edge, pedem autorização ao utilizador antes de um website poder alcançar um endereço local. Os utilizadores podem permiti-lo uma vez por site. Em frotas geridas, permita-o centralmente para o seu endereço de início de sessão com a política de browser LoopbackNetworkAllowedForUrls; caso contrário, todos os utilizadores veem o pedido.
  • Um dispositivo cortado pelo isolamento já não pode ser libertado a partir da consola. Execute dts-agent revert-isolation no dispositivo como administrador ou root.

Consulte também

Nesta página