# Endpoint Agent

Installare, aggiornare e rimuovere l'Endpoint Agent su Windows, macOS e Linux, e che cosa segnala dal dispositivo.

Requires: Device Identity (DIAM)

> **Add-on richiesto:** l'Endpoint Agent fa parte dell'add-on **DIAM** (Device Identity).

L'**Endpoint Agent** è il software da installare su ogni endpoint. Registra la macchina, ne segnala la postura di sicurezza secondo una pianificazione ed esegue le [azioni remote](https://dts-identity.com/it/docs/endpoints/remote-actions.md) attivate dalla console. Senza di esso un dispositivo non può comparire nell'[inventario](https://dts-identity.com/it/docs/endpoints/device-inventory.md). I dispositivi registrati con il precedente client Windows continuano a funzionare; le differenze e il modo di trasferirli sono descritti in [Legacy client](https://dts-identity.com/it/docs/endpoints/legacy-client.md).

## Piattaforme supportate

| Piattaforma | Supportata a partire da |
|---|---|
| **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 (inclusi Rocky e Alma), x64 e ARM64, con systemd |

Le versioni precedenti non sono supportate. Dove la macchina dispone di un TPM 2.0 (Windows, Linux) o di un Secure Enclave (Apple silicon, Mac con chip T2), l'agent conserva lì la propria chiave del dispositivo; altrimenti utilizza una chiave memorizzata su disco.

## Che cosa viene installato

| Piattaforma | Pacchetto | Che cosa viene eseguito |
|---|---|---|
| Windows | `.msi` | Il servizio **DTS Endpoint Agent** (`DTSAgent`), installato in `%ProgramFiles%\DTS\Agent` e avviato all'avvio del sistema. La finestra dell'agent si avvia a ogni accesso di un utente. |
| macOS | `.pkg` | Un daemon di sistema in `/Library/DTS/Agent` e l'app **DTS Endpoint Agent** nella barra dei menu di ogni sessione utente. |
| Linux | `.deb`, `.rpm` | Il servizio `dts-agent.service` e un'icona di stato nelle sessioni desktop. I server senza desktop eseguono solo il servizio. |

L'agent conserva il proprio stato, compresa l'identità del dispositivo, in `%ProgramData%\DTS\Agent` (Windows), `/Library/Application Support/DTS/Agent` (macOS) o `/var/lib/dts-agent` (Linux), per cui un aggiornamento sul posto non comporta una nuova registrazione della macchina. I suoi file di log si trovano nella cartella `logs` al suo interno e vengono conservati per sette giorni.

## Requisiti [#requirements]

- **Diritti di amministratore o di root** per l'installazione, poiché il pacchetto registra un servizio di sistema.
- **HTTPS in uscita verso la propria istanza della piattaforma.** L'agent apre la connessione e la mantiene aperta. Non è necessaria alcuna regola firewall in entrata.
- **Un proxy che ispeziona il TLS** funziona non appena il suo certificato radice è considerato attendibile nell'archivio del sistema operativo (l'archivio della macchina su Windows, il portachiavi di sistema su macOS, il bundle CA della distribuzione su Linux). Sull'agent non si configura nulla.

## Ottenere il programma di installazione

Il programma di installazione viene creato per la propria istanza: l'indirizzo della piattaforma e il certificato di cui l'agent ha bisogno per registrarsi sono incorporati al suo interno, ed è firmato digitalmente. Un programma di installazione di un'altra istanza non funziona, e al momento dell'installazione non c'è nulla da configurare.

1. Aprire **Impostazioni dei dispositivi → Registrazione**.
2. Richiedere una build se non ne esiste ancora una, quindi **scaricarla** una volta pronta. La scheda mostra la versione e i relativi checksum SHA-1 e SHA-256.
3. Verificare i checksum e distribuire il pacchetto ai propri endpoint.

La console offre attualmente il pacchetto per Windows. I pacchetti per macOS e Linux non sono ancora disponibili per il download nella console.

Il certificato di registrazione che fa da ancora a questo processo e la sua rotazione sono descritti in [Impostazioni dei dispositivi](https://dts-identity.com/it/docs/endpoints/device-settings.md).

## Installare e registrare [#install-and-enroll]

Installare il pacchetto con diritti di amministratore, a mano oppure tramite il proprio strumento di distribuzione software o MDM. Installa per tutti gli utenti e avvia il servizio. I pacchetti non prevedono opzioni, quindi un'installazione automatica non richiede altro che le consuete opzioni della piattaforma:

```
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
```

La registrazione avviene poi da sola. L'agent crea la propria chiave del dispositivo, si registra presso la piattaforma e riceve la propria identità di dispositivo. Sull'endpoint non c'è nulla da inserire. A seconda della modalità **Registrazione dei dispositivi** nelle [impostazioni dei dispositivi](https://dts-identity.com/it/docs/endpoints/device-settings.md), il dispositivo viene gestito subito oppure attende la Sua approvazione nell'[inventario dei dispositivi](https://dts-identity.com/it/docs/endpoints/device-inventory.md).

Su **macOS**, una parte della postura (ad esempio parti delle impostazioni di sicurezza) richiede l'accesso completo al disco, che un pacchetto non può concedere. Lo conceda all'agent con un profilo di preferenze sulla privacy (PPPC) del proprio MDM; senza di esso quei valori mancano e il resto viene segnalato come di consueto.

> **Nota:** l'identità del dispositivo viene creata alla prima registrazione e memorizzata sulla macchina. Ricreare l'immagine di un dispositivo, o cancellare quello stato, produce un **nuovo** record di dispositivo. Quello vecchio resta nell'inventario finché non decade o non viene eliminato.

## Che cosa segnala l'agent

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 l'agent invia un breve check-in ogni pochi secondi, ed è questo che fa risultare connesso un dispositivo.

L'agent segnala:

- **Sistema operativo e hardware**: versione, build, architettura, modello del computer, CPU e memoria, se la macchina è virtuale.
- **Identità della macchina e dei suoi utenti**: hostname, dominio, l'account attualmente connesso e gli account utente del dispositivo.
- **Configurazione di rete**: schede con indirizzi MAC e IP, gateway e server DNS.
- **Volumi e cifratura del disco** (BitLocker, FileVault, volumi Linux cifrati).
- **Software installato** con produttore, versione e data di installazione.
- **Stato di sicurezza**: firewall, Microsoft Defender su Windows, e impostazioni come Secure Boot, TPM, Gatekeeper, System Integrity Protection, se il Mac è gestito da un MDM e se è richiesta una password dopo il blocco dello schermo.
- **Aggiornamenti del sistema operativo mancanti** con gravità e indicazione se sia necessario un riavvio.
- **Se la sessione della console è bloccata**, insieme al check-in. La pagina del dispositivo lo mostra solo se lo si [abilita](https://dts-identity.com/it/docs/endpoints/device-settings.md).
- **Il proprio stato**: versione, stato di isolamento e stato della registrazione MFA.

Sull'endpoint **non rileva la geolocalizzazione** (la piattaforma ricava la posizione approssimativa dall'indirizzo IP della connessione) e **non raccoglie cronologia di navigazione, contenuti di file, sequenze di tasti o schermate**. L'**elenco dei processi**, con le righe di comando e l'account con cui viene eseguito ciascun processo, viene raccolto solo quando un amministratore esegue quella [azione remota](https://dts-identity.com/it/docs/endpoints/remote-actions.md).

L'ambito della raccolta è fisso. È lo stesso su ogni dispositivo di una piattaforma, e gli utenti possono consultarlo nella finestra dell'agent (vedere sotto). Pianificare la distribuzione con chi è responsabile degli accordi sindacali o dell'approvazione in materia di protezione dei dati nella propria organizzazione: l'inventario, l'account connesso e l'elenco dei processi raccolto su richiesta sono dati personali nella maggior parte degli ordinamenti.

## La finestra dell'agent

Ogni utente vede l'agent nell'area di notifica (Windows), nella barra dei menu (macOS) oppure come icona di stato (Linux). Il suo menu mostra l'ora dell'ultima segnalazione, e **Controlla ora** chiede alla piattaforma un nuovo esito di conformità. La finestra ha queste pagine:

| Pagina | Mostra |
|---|---|
| **Stato** | Se il dispositivo è connesso, registrato e sta segnalando, e qualsiasi elemento che al momento non riesce. |
| **Conformità** | L'ultimo esito di conformità del dispositivo con i controlli non superati. |
| **Accesso a due fattori** | Su Windows, i secondi fattori dell'utente per l'[accesso a Windows](https://dts-identity.com/it/docs/endpoints/windows-logon-mfa.md), quando è il dispositivo stesso a verificarli. |
| **Privacy** | Ogni interrogazione eseguita dall'agent e i dati inviati per ultimi. |
| **Informazioni** | La versione, e **Invia diagnostica** / **Salva diagnostica** per le richieste di supporto. |

## La riga di comando

L'agent installa un comando `dts-agent` per amministratori e supporto sul dispositivo:

| Comando | Scopo |
|---|---|
| `dts-agent status` | Lo stato dell'agent in formato JSON: connessione, registrazione, ultima segnalazione, isolamento e ogni passaggio che al momento non riesce, con il relativo messaggio. La prima cosa da controllare quando un dispositivo si comporta in modo anomalo. |
| `dts-agent compliance --refresh` | L'ultimo esito di conformità, richiesto di nuovo alla piattaforma. |
| `dts-agent revert-isolation` | Rimuove localmente l'isolamento di rete, eseguito come amministratore o root. Per un dispositivo che l'isolamento ha separato dalla piattaforma. La rimozione viene registrata. |

## Comportamento quando la piattaforma non è raggiungibile

L'agent continua a riprovare a intervalli crescenti fino a cinque minuti e si riconnette da solo. Le segnalazioni sulla postura non vengono accodate durante la disconnessione, per cui dopo un'interruzione la piattaforma vede lo stato attuale, non lo storico perso. Il dispositivo compare offline nella console circa dieci secondi dopo il suo ultimo check-in. Una VPN full tunnel che instrada tutto attraverso la rete aziendale deve consentire anche la connessione verso la propria istanza, altrimenti il dispositivo resta offline finché la VPN è attiva.

## Aggiornare

L'agent **non** si aggiorna da solo. Un aggiornamento è un nuovo pacchetto, distribuito allo stesso modo del primo.

1. Richiedere la nuova versione in **Impostazioni dei dispositivi → Registrazione** e scaricarla.
2. Distribuirla agli endpoint con il proprio strumento di distribuzione software o MDM.

L'installazione aggiorna sul posto e conserva l'identità del dispositivo, quindi i dispositivi non si registrano di nuovo e la loro cronologia viene mantenuta. Verificare l'aggiornamento su un gruppo pilota prima di distribuirlo a tutto il parco macchine.

## Disinstallare [#uninstall]

1. **Disinstallare l'agent** nel modo consueto della piattaforma (**Impostazioni → App** su Windows, il proprio strumento di distribuzione software o MDM, `apt remove` o `dnf remove` su Linux). Su macOS eseguire `sudo dts-agent uninstall`. La disinstallazione rimuove prima un eventuale isolamento di rete, quindi il servizio, i file di programma, lo stato dell'agent e la sua chiave del dispositivo.
2. **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:** su Debian e Ubuntu, `apt remove` conserva lo stato dell'agent finché non si esegue il purge del pacchetto (`apt purge`). La rimozione del `.rpm` e la disinstallazione su Windows e macOS lo rimuovono.

## Risoluzione dei problemi

- **Il dispositivo non compare mai nell'inventario.** Eseguire `dts-agent status` sul dispositivo: indica il passaggio che non riesce. Verificare che l'endpoint raggiunga in uscita la propria istanza e che la modalità di registrazione accetti nuovi dispositivi. Un programma di installazione creato per un'altra istanza non si registra mai.
- **Lo stato segnala un errore di connessione, ma la rete funziona.** Di solito si tratta di un proxy che ispeziona il TLS, il cui certificato radice non si trova nell'archivio del sistema operativo. Vedere [Requisiti](#requirements).
- **Un dispositivo compare due volte.** Alla macchina è stata ricreata l'immagine, oppure ha perso il proprio stato locale e si è registrata di nuovo. Eliminare il record precedente.
- **I dati su software o patch sembrano obsoleti.** La postura viene segnalata secondo una pianificazione. Usare l'[azione remota](https://dts-identity.com/it/docs/endpoints/remote-actions.md) **Request full update** per forzare una segnalazione completa.
- **Durante l'accesso il browser chiede l'autorizzazione ad accedere alla rete locale.** I controlli di conformità all'accesso funzionano facendo interrogare dalla pagina di accesso l'agent sulla macchina stessa. Chrome 142 e versioni successive, ed Edge, chiedono conferma all'utente prima che un sito web possa raggiungere un indirizzo locale. Gli utenti possono consentirlo una volta per sito. Nei parchi gestiti, consentirlo centralmente per il proprio indirizzo di accesso con il criterio del browser `LoopbackNetworkAllowedForUrls`, altrimenti ogni utente vede la richiesta.
- **Un dispositivo separato dall'isolamento non può più essere rilasciato dalla console.** Eseguire `dts-agent revert-isolation` sul dispositivo come amministratore o root.

## Vedere anche

- [Impostazioni dei dispositivi](https://dts-identity.com/it/docs/endpoints/device-settings.md): il programma di installazione e il certificato di registrazione.
- [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.
- [MFA all'accesso a Windows](https://dts-identity.com/it/docs/endpoints/windows-logon-mfa.md): la funzionalità di accesso che si basa sull'agent.
- [Legacy client](https://dts-identity.com/it/docs/endpoints/legacy-client.md): i dispositivi che eseguono ancora il precedente client Windows.
