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.
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
| Plataforma | Suportada a partir de |
|---|---|
| Windows | Windows 11 e Windows Server 2019, x64 |
| macOS | macOS 12 Monterey, Intel e Apple silicon |
| Linux | Debian 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
| Plataforma | Pacote | O que é executado |
|---|---|---|
| Windows | .msi | O 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 | .pkg | Um 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, .rpm | O 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.
- Abra Definições de dispositivos → Registo.
- 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.
- 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.rpmA 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ágina | Mostra |
|---|---|
| Estado | Se o dispositivo está ligado, inscrito e a comunicar, e o que está a falhar neste momento. |
| Conformidade | O último resultado de conformidade do dispositivo, com as verificações que falharam. |
| Início de sessão com dois fatores | No Windows, os segundos fatores do utilizador para o início de sessão do Windows, quando o próprio dispositivo os verifica. |
| Privacidade | Cada consulta que o agente executa e os dados que enviou por último. |
| Acerca de | A 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:
| Comando | Finalidade |
|---|---|
dts-agent status | O 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 --refresh | O último resultado de conformidade, pedido novamente à plataforma. |
dts-agent revert-isolation | Levanta 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.
- Solicite a nova versão em Definições de dispositivos → Registo e transfira-a.
- 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
- 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 removeoudnf removeno Linux). No macOS, executesudo 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. - 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 removemantém o estado do agente até purgar o pacote (apt purge). A remoção do.rpme a desinstalação no Windows e no macOS removem-no.
Resolução de problemas
- O dispositivo nunca aparece no inventário. Execute
dts-agent statusno 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-isolationno dispositivo como administrador ou root.
Consulte também
- Definições de dispositivos para o instalador e o certificado de inscrição.
- Inventário de dispositivos para os dispositivos inscritos e a respetiva postura.
- Ações remotas para o que pode desencadear num endpoint.
- MFA no início de sessão do Windows para a funcionalidade de início de sessão que assenta no agente.
- Legacy client para os dispositivos que ainda executam o cliente Windows anterior.
Ações remotas
Isolar um dispositivo, alterar o seu registo MFA, fixar o seu utilizador e executar comandos de dispositivo através da API de gestão.
MFA no início de sessão do Windows
Um segundo fator no início de sessão do Windows, verificado no dispositivo ou pela plataforma, e o que ponderar previamente.