# Legacy client

O cliente Windows de dispositivos anterior, o que só ele faz e como migrar os seus dispositivos para o agente de endpoint.

Requires: Device Identity (DIAM)

> **Add-on necessário:** O legacy client faz parte do add-on **DIAM** (Device Identity).

O **legacy client** é o cliente Windows com o qual os dispositivos se inscreviam antes do [agente de endpoint](https://dts-identity.com/pt/docs/endpoints/device-client.md). Os dispositivos que ainda o executam continuam a funcionar: comunicam a sua postura, participam nas [políticas de conformidade de dispositivos](https://dts-identity.com/pt/docs/security/conditional-access/device-compliance-policies.md) e recebem [ações remotas](https://dts-identity.com/pt/docs/endpoints/remote-actions.md). As novas funcionalidades são desenvolvidas apenas para o agente de endpoint, que substitui o legacy client. Planeie a migração descrita [abaixo](#moving-to-the-endpoint-agent).

Para ver que cliente um dispositivo executa, abra-o no [inventário de dispositivos](https://dts-identity.com/pt/docs/endpoints/device-inventory.md): o separador **Visão geral** mostra **DTS Client** (o legacy client) ou **Endpoint Agent** em **Endpoint Client**.

## O que difere do agente de endpoint

| | Legacy client | Agente de endpoint |
|---|---|---|
| Plataformas | Windows em x64 | Windows, macOS e Linux |
| Isolamento de rede | Windows; sobrevive a uma desinstalação | Windows, macOS e Linux; levantado quando o agente é desinstalado |
| Bloqueio de destinos individuais | Sim | Não |
| Segundo fator no início de sessão do Windows | Verificado no dispositivo | Verificado no dispositivo ou [pela plataforma](https://dts-identity.com/pt/docs/endpoints/windows-logon-mfa.md#verified-by-the-platform) |
| Instalador | Não assinado com código | Assinado com código |

Algumas [ações remotas](https://dts-identity.com/pt/docs/endpoints/remote-actions.md) e métodos da API existem apenas para o legacy client e são recusados para um dispositivo com o agente de endpoint: executar um executável de produto, alterar o estado do agente de um produto, as consultas de produtos em tempo real e bloquear ou desbloquear destinos.

## O que é instalado

| Componente | Função |
|---|---|
| **Serviço do cliente** | Um serviço do Windows chamado `ClientGuard`, iniciado automaticamente no arranque. Mantém a ligação à plataforma, recolhe dados de postura e executa comandos. |
| **Aplicação de ambiente de trabalho** | Uma pequena aplicação na área de notificação que mostra ao utilizador o estado e o resultado de conformidade do dispositivo e trata do [registo do segundo fator](https://dts-identity.com/pt/docs/endpoints/windows-logon-mfa.md). Inicia automaticamente para todos os utilizadores. |

Ambos são instalados numa pasta `ClientGuard` em **Ficheiros de Programas**. O cliente mantém o seu próprio estado, incluindo a identidade do dispositivo, fora dessa pasta, pelo que uma atualização no local não volta a inscrever a máquina.

## Requisitos

- **Windows em x64.**
- **Direitos de administrador local** para instalar, uma vez que o instalador regista um serviço do Windows.
- **Conectividade de saída para a instância da plataforma.** O cliente estabelece a ligação e mantém-na aberta. Não é necessária qualquer regra de firewall de entrada.
- O instalador **não está assinado com código**, pelo que o Windows SmartScreen apresenta um aviso na primeira execução. Verifique as somas de verificação apresentadas junto à transferência na consola antes de distribuir.

## O que o cliente 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 cliente envia uma breve comunicação a cada poucos segundos, e é isso que faz com que um dispositivo apareça como ligado.

Comunica o sistema operativo e o hardware, o hostname, o domínio e a conta com sessão iniciada, a configuração de rede, os volumes e as placas gráficas, o software instalado, o estado dos produtos de segurança (firewall, proteção em tempo real, definições, ameaças, encriptação de disco), os patches do sistema operativo em falta e a sua própria versão, o estado de isolamento e o estado do registo de MFA. Não recolhe geolocalização, histórico de navegação, conteúdos de ficheiros, teclas premidas nem capturas de ecrã. A **lista de processos** só é recolhida quando um administrador executa essa [ação remota](https://dts-identity.com/pt/docs/endpoints/remote-actions.md).

## Atualizar

O cliente **não** se atualiza a si próprio. Uma atualização é um novo instalador, distribuído da mesma forma que o primeiro. A instalação atualiza no local e preserva a identidade do dispositivo.

## Desinstalar [#uninstall]

Remover o cliente de forma limpa implica três passos, e a ordem é importante.

1. **Reverta primeiro o isolamento se o dispositivo estiver isolado.** As regras de isolamento são regras de firewall locais que sobrevivem à desinstalação. Uma máquina desinstalada enquanto está isolada permanece cortada da rede, e deixa de ser possível alcançá-la para corrigir isso remotamente.
2. **Desinstale o cliente** através de **Definições → Aplicações** no Windows, ou através da sua ferramenta de distribuição de software. Isto remove o serviço, a aplicação de ambiente de trabalho e os ficheiros de programa.
3. **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:** Uma desinstalação normal deixa o estado local do cliente na máquina, incluindo os seus dados de inscrição. Se estiver a desativar um dispositivo em vez de recriar a sua imagem, trate esse estado como dados a apagar juntamente com o resto do disco.

Se o cliente estiver de tal modo danificado que o Windows não o consiga desinstalar, contacte o suporte em vez de remover serviços e chaves de registo manualmente. Uma remoção manual incorreta pode deixar uma máquina isolada sem forma de regressar.

## Migrar para o agente de endpoint [#moving-to-the-endpoint-agent]

Instale o pacote Windows do agente de endpoint por cima do legacy client, da mesma forma que distribui qualquer pacote (consulte [Agente de endpoint](https://dts-identity.com/pt/docs/endpoints/device-client.md#install-and-enroll)). O instalador remove o serviço e o registo do legacy client no âmbito da instalação. Em seguida:

- O dispositivo volta a inscrever-se com o agente de endpoint e aparece como **novo dispositivo** no inventário. Elimine o registo antigo assim que o novo começar a comunicar.
- Um dispositivo que o legacy client tinha **isolado permanece isolado**: o agente de endpoint assume o isolamento no seu primeiro arranque, e levanta-o a partir da página do dispositivo como habitualmente. Não é necessário levantá-lo antes da atualização.
- A pasta `C:\Program Files\DTS Client` e alguns pequenos ficheiros de estado do legacy client permanecem no disco. São inofensivos; elimine-os manualmente se assim o pretender.
- Os segundos fatores registados no dispositivo para o início de sessão do Windows continuam a funcionar: o agente de endpoint assume-os uma vez no seu primeiro arranque e remove as cópias do legacy client.

Faça um piloto da migração em alguns dispositivos que consiga alcançar fisicamente, em particular dispositivos com MFA no início de sessão do Windows.

## Resolução de problemas

- **O dispositivo nunca aparece no inventário.** Confirme que o serviço `ClientGuard` está em execução e que o endpoint consegue alcançar a sua instância a partir da rede de saída. Um instalador criado para outra instância nunca se inscreve.
- **Um dispositivo continua isolado depois de desinstalar o cliente.** Reinstale o cliente, reverta o isolamento e desinstale depois pela ordem correta. Ou instale o agente de endpoint, que assume o isolamento e lhe permite levantá-lo.

## Consulte também

- [Agente de endpoint](https://dts-identity.com/pt/docs/endpoints/device-client.md) para o cliente que substitui este.
- [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.
