# Legacy-Client

Der bisherige Windows-Geräte-Client, was nur er kann und wie Sie seine Geräte auf den Endpoint-Agent umstellen.

Requires: Device Identity (DIAM)

> **Add-on erforderlich:** Der Legacy-Client ist Teil des Add-ons **DIAM** (Device Identity).

Der **Legacy-Client** ist der Windows-Client, mit dem sich Geräte vor dem [Endpoint-Agent](https://dts-identity.com/de/docs/endpoints/device-client.md) registriert haben. Geräte, auf denen er noch läuft, funktionieren weiter: Sie melden ihre Sicherheitslage, werden in [Geräte-Compliance-Richtlinien](https://dts-identity.com/de/docs/security/conditional-access/device-compliance-policies.md) bewertet und erhalten [Remote-Aktionen](https://dts-identity.com/de/docs/endpoints/remote-actions.md). Neue Funktionen entstehen nur für den Endpoint-Agent, der den Legacy-Client ablöst. Planen Sie die Umstellung, wie [unten](#moving-to-the-endpoint-agent) beschrieben.

Welcher Client auf einem Gerät läuft, sehen Sie im [Geräteinventar](https://dts-identity.com/de/docs/endpoints/device-inventory.md): Der Reiter **Überblick** zeigt unter **Endpoint-Client** entweder **DTS Client** (den Legacy-Client) oder **Endpoint-Agent**.

## Was sich vom Endpoint-Agent unterscheidet

| | Legacy-Client | Endpoint-Agent |
|---|---|---|
| Plattformen | Windows auf x64 | Windows, macOS und Linux |
| Netzwerkisolation | Windows; überdauert eine Deinstallation | Windows, macOS und Linux; wird bei der Deinstallation des Agents aufgehoben |
| Sperren einzelner Ziele | Ja | Nein |
| Zweiter Faktor bei der Windows-Anmeldung | Auf dem Gerät geprüft | Auf dem Gerät oder [durch die Plattform](https://dts-identity.com/de/docs/endpoints/windows-logon-mfa.md#verified-by-the-platform) geprüft |
| Installer | Nicht signiert | Signiert |

Einige [Remote-Aktionen](https://dts-identity.com/de/docs/endpoints/remote-actions.md) und API-Methoden gibt es nur für den Legacy-Client; für ein Gerät mit Endpoint-Agent werden sie abgelehnt: das Starten einer Produkt-Programmdatei, das Ändern des Agent-Zustands eines Produkts, die Live-Abfragen zu Produkten sowie das Sperren und Entsperren von Zielen.

## Was installiert wird

| Komponente | Rolle |
|---|---|
| **Client-Dienst** | Ein Windows-Dienst namens `ClientGuard`, der beim Systemstart automatisch startet. Er hält die Verbindung zur Plattform, sammelt Daten zur Sicherheitslage und führt Befehle aus. |
| **Desktop-Anwendung** | Eine kleine Anwendung im Infobereich, die dem Benutzer den Status und das Compliance-Ergebnis des Geräts anzeigt und die [Einrichtung des zweiten Faktors](https://dts-identity.com/de/docs/endpoints/windows-logon-mfa.md) übernimmt. Sie startet für jeden Benutzer automatisch. |

Beide werden in einen Ordner `ClientGuard` unter **Programme** installiert. Der Client hält seinen eigenen Zustand einschließlich seiner Geräteidentität außerhalb dieses Ordners, sodass ein Upgrade an Ort und Stelle die Maschine nicht erneut registriert.

## Voraussetzungen

- **Windows auf x64.**
- **Lokale Administratorrechte** für die Installation, da der Installer einen Windows-Dienst registriert.
- **Ausgehende Verbindung zu Ihrer Plattform-Instanz.** Der Client baut die Verbindung auf und hält sie offen. Eine eingehende Firewall-Regel ist nicht erforderlich.
- Der Installer ist **nicht signiert**, daher warnt Windows SmartScreen beim ersten Start. Prüfen Sie vor dem Ausrollen die Prüfsummen, die in der Konsole neben dem Download angezeigt werden.

## Was der Client meldet

Die Sicherheitslage wird alle fünf Minuten erfasst und als Differenz zum letzten Bericht gesendet, mit einer vollständigen Momentaufnahme mindestens einmal täglich oder immer dann, wenn die Plattform sie anfordert. Zwischen den Berichten sendet der Client alle paar Sekunden eine kurze Rückmeldung, wodurch ein Gerät als verbunden angezeigt wird.

Er meldet Betriebssystem und Hardware, Hostname, Domäne und angemeldetes Konto, die Netzwerkkonfiguration, Volumes und Grafikkarten, installierte Software, den Zustand der Sicherheitsprodukte (Firewall, Echtzeitschutz, Definitionen, Bedrohungen, Festplattenverschlüsselung), fehlende Betriebssystem-Patches sowie seine eigene Version, seinen Isolationsstatus und den Stand der MFA-Einrichtung. Er erfasst keine Geolokalisierung, keinen Browserverlauf, keine Dateiinhalte, keine Tastatureingaben und keine Bildschirmfotos. Die **Prozessliste** wird nur erfasst, wenn ein Administrator diese [Remote-Aktion](https://dts-identity.com/de/docs/endpoints/remote-actions.md) ausführt.

## Aktualisieren

Der Client aktualisiert sich **nicht** selbst. Ein Update ist ein neuer Installer, der genauso verteilt wird wie der erste. Die Installation aktualisiert an Ort und Stelle und erhält die Geräteidentität.

## Deinstallieren [#uninstall]

Das saubere Entfernen des Clients erfolgt in drei Schritten, und die Reihenfolge ist entscheidend.

1. **Heben Sie zuerst die Isolation auf, wenn das Gerät isoliert ist.** Die Isolationsregeln sind lokale Firewall-Regeln, die eine Deinstallation überdauern. Eine im isolierten Zustand deinstallierte Maschine bleibt vom Netzwerk abgeschnitten, und Sie können sie nicht mehr aus der Ferne erreichen, um das zu korrigieren.
2. **Deinstallieren Sie den Client** über **Einstellungen → Apps** in Windows oder über Ihr Softwareverteilungswerkzeug. Damit werden der Dienst, die Desktop-Anwendung und die Programmdateien entfernt.
3. **Löschen Sie das Gerät** im [Inventar](https://dts-identity.com/de/docs/endpoints/device-inventory.md). Die Deinstallation benachrichtigt die Plattform nicht, der Datensatz bleibt also bestehen, bis Sie ihn entfernen.

> **Hinweis:** Eine übliche Deinstallation belässt den lokalen Zustand des Clients einschließlich seiner Registrierungsdaten auf der Maschine. Wenn Sie ein Gerät ausmustern statt neu aufzusetzen, behandeln Sie diesen Zustand als Daten, die zusammen mit dem Rest der Festplatte zu löschen sind.

Ist der Client so stark beschädigt, dass Windows ihn nicht deinstallieren kann, wenden Sie sich an den Support, statt Dienste und Registrierungsschlüssel von Hand zu entfernen. Eine falsche manuelle Entfernung kann eine Maschine isoliert zurücklassen, ohne Weg zurück.

## Umstellung auf den Endpoint-Agent [#moving-to-the-endpoint-agent]

Installieren Sie das Windows-Paket des Endpoint-Agents über den Legacy-Client, so wie Sie jedes Paket verteilen (siehe [Endpoint-Agent](https://dts-identity.com/de/docs/endpoints/device-client.md#install-and-enroll)). Der Installer entfernt dabei den Dienst und die Registrierung des Legacy-Clients. Danach gilt:

- Das Gerät registriert sich mit dem Endpoint-Agent neu und erscheint als **neues Gerät** im Inventar. Löschen Sie den alten Datensatz, sobald der neue meldet.
- Ein Gerät, das der Legacy-Client **isoliert** hatte, **bleibt isoliert**: Der Endpoint-Agent übernimmt die Isolation bei seinem ersten Start, und Sie heben sie wie gewohnt auf der Geräteseite auf. Vor dem Upgrade muss sie nicht aufgehoben werden.
- Der Ordner `C:\Program Files\DTS Client` und einige kleine Zustandsdateien des Legacy-Clients bleiben auf der Festplatte. Sie sind unschädlich; löschen Sie sie bei Bedarf von Hand.
- Auf dem Gerät eingerichtete zweite Faktoren für die Windows-Anmeldung funktionieren weiter: Der Endpoint-Agent übernimmt sie einmalig bei seinem ersten Start und entfernt die Kopien des Legacy-Clients.

Erproben Sie die Umstellung an einigen Geräten, die Sie physisch erreichen, insbesondere an Geräten mit MFA bei der Windows-Anmeldung.

## Fehlerbehebung

- **Das Gerät erscheint nie im Inventar.** Prüfen Sie, ob der Dienst `ClientGuard` läuft und ob das Endgerät Ihre Instanz ausgehend erreichen kann. Ein für eine andere Instanz erstellter Installer registriert sich niemals.
- **Ein Gerät bleibt nach der Deinstallation des Clients isoliert.** Installieren Sie den Client erneut, heben Sie die Isolation auf und deinstallieren Sie dann in der richtigen Reihenfolge. Oder installieren Sie den Endpoint-Agent, der die Isolation übernimmt und Sie sie aufheben lässt.

## Siehe auch

- [Endpoint-Agent](https://dts-identity.com/de/docs/endpoints/device-client.md) für den Client, der diesen ablöst.
- [Geräteinventar](https://dts-identity.com/de/docs/endpoints/device-inventory.md) für die registrierten Geräte und ihre Sicherheitslage.
- [Remote-Aktionen](https://dts-identity.com/de/docs/endpoints/remote-actions.md) für das, was Sie auf einem Endgerät auslösen können.
