# Legacy client

Il precedente client Windows per dispositivi, che cosa fa solo lui e come trasferire i suoi dispositivi all'Endpoint Agent.

Requires: Device Identity (DIAM)

> **Add-on richiesto:** il legacy client fa parte dell'add-on **DIAM** (Device Identity).

Il **legacy client** è il client Windows con cui i dispositivi si registravano prima dell'[Endpoint Agent](https://dts-identity.com/it/docs/endpoints/device-client.md). I dispositivi che lo eseguono ancora continuano a funzionare: segnalano la propria postura, partecipano ai [criteri di conformità dei dispositivi](https://dts-identity.com/it/docs/security/conditional-access/device-compliance-policies.md) e ricevono le [azioni remote](https://dts-identity.com/it/docs/endpoints/remote-actions.md). Le nuove funzionalità vengono sviluppate solo per l'Endpoint Agent, che sostituisce il legacy client. Pianificare il passaggio descritto [più sotto](#moving-to-the-endpoint-agent).

Per vedere quale client esegue un dispositivo, aprirlo nell'[inventario dei dispositivi](https://dts-identity.com/it/docs/endpoints/device-inventory.md): la scheda **Panoramica** mostra **DTS Client** (il legacy client) oppure **Endpoint Agent** sotto **Endpoint Client**.

## Differenze rispetto all'Endpoint Agent

| | Legacy client | Endpoint Agent |
|---|---|---|
| Piattaforme | Windows su x64 | Windows, macOS e Linux |
| Isolamento di rete | Windows; sopravvive a una disinstallazione | Windows, macOS e Linux; rimosso quando l'agent viene disinstallato |
| Blocco di singole destinazioni | Sì | No |
| Secondo fattore all'accesso a Windows | Verificato sul dispositivo | Verificato sul dispositivo o [dalla piattaforma](https://dts-identity.com/it/docs/endpoints/windows-logon-mfa.md#verified-by-the-platform) |
| Programma di installazione | Non firmato digitalmente | Firmato digitalmente |

Alcune [azioni remote](https://dts-identity.com/it/docs/endpoints/remote-actions.md) e alcuni metodi API esistono solo per il legacy client e vengono rifiutati per un dispositivo con l'Endpoint Agent: l'esecuzione di un eseguibile di un prodotto, la modifica dello stato dell'agent di un prodotto, le interrogazioni dei prodotti in tempo reale e il blocco o lo sblocco delle destinazioni.

## Che cosa viene installato

| Componente | Ruolo |
|---|---|
| **Servizio del client** | Un servizio Windows denominato `ClientGuard`, avviato automaticamente all'avvio del sistema. Mantiene la connessione con la piattaforma, raccoglie i dati sulla postura ed esegue i comandi. |
| **Applicazione desktop** | Una piccola applicazione nell'area di notifica che mostra all'utente lo stato del dispositivo e l'esito di conformità e gestisce la [registrazione del secondo fattore](https://dts-identity.com/it/docs/endpoints/windows-logon-mfa.md). Si avvia automaticamente per ogni utente. |

Entrambi vengono installati in una cartella `ClientGuard` sotto **Programmi**. Il client conserva il proprio stato, compresa l'identità del dispositivo, al di fuori di quella cartella, per cui un aggiornamento sul posto non comporta una nuova registrazione della macchina.

## Requisiti

- **Windows su x64.**
- **Diritti di amministratore locale** per l'installazione, poiché il programma di installazione registra un servizio Windows.
- **Connettività in uscita verso la propria istanza della piattaforma.** Il client apre la connessione e la mantiene aperta. Non è necessaria alcuna regola firewall in entrata.
- Il programma di installazione **non è firmato digitalmente**, quindi Windows SmartScreen avvisa al primo avvio. Verificare i checksum indicati accanto al download nella console prima della distribuzione.

## Che cosa segnala il client

La postura viene raccolta ogni cinque minuti e inviata come differenza rispetto all'ultima segnalazione, con un'istantanea completa almeno una volta al giorno oppure ogni volta che la piattaforma la richiede. Fra una segnalazione e l'altra il client invia un breve check-in ogni pochi secondi, ed è questo che fa risultare connesso un dispositivo.

Segnala il sistema operativo e l'hardware, l'hostname, il dominio e l'account connesso, la configurazione di rete, i volumi e le schede video, il software installato, lo stato dei prodotti di sicurezza (firewall, protezione in tempo reale, definizioni, minacce, cifratura del disco), le patch del sistema operativo mancanti, e la propria versione, lo stato di isolamento e lo stato della registrazione MFA. Non raccoglie geolocalizzazione, cronologia di navigazione, contenuti di file, sequenze di tasti o schermate. L'**elenco dei processi** viene raccolto solo quando un amministratore esegue quella [azione remota](https://dts-identity.com/it/docs/endpoints/remote-actions.md).

## Aggiornare

Il client **non** si aggiorna da solo. Un aggiornamento è un nuovo programma di installazione, distribuito allo stesso modo del primo. L'installazione aggiorna sul posto e conserva l'identità del dispositivo.

## Disinstallare [#uninstall]

La rimozione pulita del client richiede tre passaggi, e l'ordine è determinante.

1. **Annullare prima l'isolamento se il dispositivo è isolato.** Le regole di isolamento sono regole del firewall locale che sopravvivono alla disinstallazione. Una macchina disinstallata mentre è isolata resta scollegata dalla rete, e non è più raggiungibile per correggere la situazione da remoto.
2. **Disinstallare il client** tramite **Impostazioni → App** in Windows oppure tramite il proprio strumento di distribuzione software. Questo rimuove il servizio, l'applicazione desktop e i file di programma.
3. **Eliminare il dispositivo** nell'[inventario](https://dts-identity.com/it/docs/endpoints/device-inventory.md). La disinstallazione non avvisa la piattaforma, quindi il record resta finché non viene rimosso.

> **Nota:** una disinstallazione standard lascia sulla macchina lo stato locale del client, compresi i suoi dati di registrazione. Se si sta dismettendo un dispositivo anziché ricrearne l'immagine, trattare quello stato come dati da cancellare insieme al resto del disco.

Se il client è danneggiato al punto che Windows non riesce a disinstallarlo, rivolgersi al supporto anziché rimuovere a mano servizi e chiavi di registro. Una rimozione manuale errata può lasciare una macchina isolata senza via di ritorno.

## Passaggio all'Endpoint Agent [#moving-to-the-endpoint-agent]

Installare il pacchetto Windows dell'Endpoint Agent sopra il legacy client, allo stesso modo di qualsiasi altro pacchetto (vedere [Endpoint Agent](https://dts-identity.com/it/docs/endpoints/device-client.md#install-and-enroll)). Il programma di installazione rimuove il servizio e la registrazione del legacy client nel corso dell'installazione. Quindi:

- Il dispositivo si registra di nuovo con l'Endpoint Agent e compare come **nuovo dispositivo** nell'inventario. Eliminare il record del legacy client non appena quello nuovo inizia a segnalare.
- Un dispositivo che il legacy client aveva **isolato resta isolato**: l'Endpoint Agent rileva l'isolamento al primo avvio, e lo si rimuove come di consueto dalla pagina del dispositivo. Non occorre rimuoverlo prima dell'aggiornamento.
- La cartella `C:\Program Files\DTS Client` e alcuni piccoli file di stato del legacy client restano sul disco. Sono innocui; eliminarli a mano se lo si desidera.
- I secondi fattori registrati sul dispositivo per l'accesso a Windows continuano a funzionare: l'Endpoint Agent li rileva una volta al primo avvio e rimuove le copie del legacy client.

Eseguire una prova pilota del passaggio su alcuni dispositivi fisicamente raggiungibili, in particolare dispositivi con MFA all'accesso a Windows.

## Risoluzione dei problemi

- **Il dispositivo non compare mai nell'inventario.** Verificare che il servizio `ClientGuard` sia in esecuzione e che l'endpoint raggiunga in uscita la propria istanza. Un programma di installazione creato per un'altra istanza non si registrerà mai.
- **Un dispositivo resta isolato dopo la disinstallazione del client.** Reinstallare il client, annullare l'isolamento, quindi disinstallare nell'ordine corretto. Oppure installare l'Endpoint Agent, che rileva l'isolamento e consente di rimuoverlo.

## Vedere anche

- [Endpoint Agent](https://dts-identity.com/it/docs/endpoints/device-client.md): il client che sostituisce questo.
- [Inventario dei dispositivi](https://dts-identity.com/it/docs/endpoints/device-inventory.md): i dispositivi registrati e la loro postura.
- [Azioni remote](https://dts-identity.com/it/docs/endpoints/remote-actions.md): che cosa è possibile attivare su un endpoint.
