# 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.

Requires: Device 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](https://dts-identity.com/pt/docs/endpoints/remote-actions.md) desencadeadas a partir da consola. Sem ele, um dispositivo não pode constar do [inventário](https://dts-identity.com/pt/docs/endpoints/device-inventory.md). Os dispositivos inscritos com o cliente Windows anterior continuam a funcionar; consulte [Legacy client](https://dts-identity.com/pt/docs/endpoints/legacy-client.md) 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 [#requirements]

- **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](https://dts-identity.com/pt/docs/endpoints/device-settings.md) para o certificado de inscrição que ancora este processo e para a respetiva rotação.

## Instalar e inscrever [#install-and-enroll]

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](https://dts-identity.com/pt/docs/endpoints/device-settings.md), o dispositivo fica gerido de imediato ou aguarda a sua aprovação no [inventário de dispositivos](https://dts-identity.com/pt/docs/endpoints/device-inventory.md).

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](https://dts-identity.com/pt/docs/endpoints/device-settings.md).
- **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](https://dts-identity.com/pt/docs/endpoints/remote-actions.md).

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](https://dts-identity.com/pt/docs/endpoints/windows-logon-mfa.md), 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.

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 [#uninstall]

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](https://dts-identity.com/pt/docs/endpoints/device-inventory.md). 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](#requirements).
- **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](https://dts-identity.com/pt/docs/endpoints/remote-actions.md) **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

- [Definições de dispositivos](https://dts-identity.com/pt/docs/endpoints/device-settings.md) para o instalador e o certificado de inscrição.
- [Inventário de dispositivos](https://dts-identity.com/pt/docs/endpoints/device-inventory.md) para os dispositivos inscritos e a respetiva postura.
- [Ações remotas](https://dts-identity.com/pt/docs/endpoints/remote-actions.md) para o que pode desencadear num endpoint.
- [MFA no início de sessão do Windows](https://dts-identity.com/pt/docs/endpoints/windows-logon-mfa.md) para a funcionalidade de início de sessão que assenta no agente.
- [Legacy client](https://dts-identity.com/pt/docs/endpoints/legacy-client.md) para os dispositivos que ainda executam o cliente Windows anterior.
