# Endpoint-Agent

Installieren, aktualisieren und entfernen Sie den Endpoint-Agent unter Windows, macOS und Linux, und was er vom Gerät meldet.

Requires: Device Identity (DIAM)

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

Der **Endpoint-Agent** ist die Software, die Sie auf jedem Endgerät installieren. Er registriert die Maschine, meldet ihre Sicherheitslage nach Zeitplan und führt die [Remote-Aktionen](https://dts-identity.com/de/docs/endpoints/remote-actions.md) aus, die Sie in der Konsole auslösen. Ohne ihn kann ein Gerät nicht im [Inventar](https://dts-identity.com/de/docs/endpoints/device-inventory.md) erscheinen. Geräte, die mit dem bisherigen Windows-Client registriert sind, funktionieren weiter; was sich unterscheidet und wie Sie sie umstellen, steht unter [Legacy-Client](https://dts-identity.com/de/docs/endpoints/legacy-client.md).

## Unterstützte Plattformen

| Plattform | Unterstützt ab |
|---|---|
| **Windows** | Windows 11 und Windows Server 2019, x64 |
| **macOS** | macOS 12 Monterey, Intel und Apple Silicon |
| **Linux** | Debian 11, Ubuntu 22.04 und Red Hat Enterprise Linux 9 (einschließlich Rocky und Alma), x64 und ARM64, mit systemd |

Ältere Versionen werden nicht unterstützt. Hat die Maschine ein TPM 2.0 (Windows, Linux) oder eine Secure Enclave (Apple Silicon, Macs mit T2-Chip), hält der Agent seinen Geräteschlüssel darin; andernfalls verwendet er einen auf der Festplatte gespeicherten Schlüssel.

## Was installiert wird

| Plattform | Paket | Was läuft |
|---|---|---|
| Windows | `.msi` | Der Dienst **DTS Endpoint Agent** (`DTSAgent`), installiert unter `%ProgramFiles%\DTS\Agent`, startet beim Systemstart. Das Agent-Fenster startet bei jeder Benutzeranmeldung. |
| macOS | `.pkg` | Ein System-Daemon unter `/Library/DTS/Agent` und die App **DTS Endpoint Agent** in der Menüleiste jeder Benutzersitzung. |
| Linux | `.deb`, `.rpm` | Der Dienst `dts-agent.service` und ein Statussymbol in Desktop-Sitzungen. Server ohne Desktop führen nur den Dienst aus. |

Der Agent hält seinen Zustand einschließlich seiner Geräteidentität in `%ProgramData%\DTS\Agent` (Windows), `/Library/Application Support/DTS/Agent` (macOS) oder `/var/lib/dts-agent` (Linux), sodass ein Upgrade an Ort und Stelle die Maschine nicht erneut registriert. Seine Protokolldateien liegen dort im Ordner `logs` und werden sieben Tage aufbewahrt.

## Voraussetzungen [#requirements]

- **Administrator- oder Root-Rechte** für die Installation, da das Paket einen Systemdienst registriert.
- **Ausgehendes HTTPS zu Ihrer Plattform-Instanz.** Der Agent baut die Verbindung auf und hält sie offen. Eine eingehende Firewall-Regel ist nicht erforderlich.
- **Ein Proxy, der TLS aufbricht,** funktioniert, sobald sein Stammzertifikat im Speicher des Betriebssystems vertrauenswürdig ist (im Computerspeicher unter Windows, im Schlüsselbund „System“ unter macOS, im CA-Bündel der Distribution unter Linux). Am Agent ist nichts einzustellen.

## Installer beziehen

Der Installer wird für Ihre Instanz erstellt: Die Plattform-Adresse und das Zertifikat, das der Agent zur Registrierung benötigt, sind darin eingebettet, und er ist signiert. Ein Installer einer anderen Instanz funktioniert nicht, und zur Installationszeit ist nichts zu konfigurieren.

1. Öffnen Sie **Geräteeinstellungen → Registrierung**.
2. Fordern Sie einen Build an, falls noch keiner existiert, und **laden** Sie ihn herunter, sobald er bereit ist. Die Karte zeigt die Version sowie die SHA-1- und SHA-256-Prüfsummen.
3. Prüfen Sie die Prüfsummen und verteilen Sie das Paket an Ihre Endgeräte.

Die Konsole bietet derzeit das Windows-Paket an. Die Pakete für macOS und Linux stehen in der Konsole noch nicht zum Download bereit.

Das Registrierungszertifikat, das dies verankert, und seine Rotation sind unter [Geräteeinstellungen](https://dts-identity.com/de/docs/endpoints/device-settings.md) beschrieben.

## Installieren und registrieren [#install-and-enroll]

Installieren Sie das Paket mit Administratorrechten, von Hand oder über Ihre Softwareverteilung oder Ihr MDM. Es installiert für alle Benutzer und startet den Dienst. Die Pakete kennen keine eigenen Optionen; für eine unbeaufsichtigte Installation genügen die üblichen Schalter der Plattform:

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

Die Registrierung läuft anschließend von selbst. Der Agent erzeugt seinen Geräteschlüssel, meldet sich bei der Plattform an und erhält seine Geräteidentität. Auf dem Endgerät ist nichts einzugeben. Je nach Modus **Device enrollment** in den [Geräteeinstellungen](https://dts-identity.com/de/docs/endpoints/device-settings.md) wird das Gerät sofort verwaltet oder wartet im [Geräteinventar](https://dts-identity.com/de/docs/endpoints/device-inventory.md) auf Ihre Genehmigung.

Unter **macOS** benötigt ein Teil der Sicherheitslage (etwa Teile der Sicherheitseinstellungen) den Festplattenvollzugriff, den ein Paket nicht erteilen kann. Erteilen Sie ihn dem Agent mit einem Profil für Datenschutzeinstellungen (PPPC) aus Ihrem MDM; ohne es fehlen diese Werte, der Rest wird wie gewohnt gemeldet.

> **Hinweis:** Die Geräteidentität entsteht bei der ersten Registrierung und wird auf der Maschine gespeichert. Wird ein Gerät neu aufgesetzt oder dieser Zustand gelöscht, entsteht ein **neuer** Gerätedatensatz. Der alte bleibt im Inventar, bis er verfällt oder Sie ihn löschen.

## Was der Agent 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 Agent alle paar Sekunden eine kurze Rückmeldung, wodurch ein Gerät als verbunden angezeigt wird.

Der Agent meldet:

- **Betriebssystem und Hardware**: Version, Build, Architektur, Computermodell, CPU und Arbeitsspeicher sowie ob die Maschine virtuell ist.
- **Identität der Maschine und ihrer Benutzer**: Hostname, Domäne, das aktuell angemeldete Konto und die Benutzerkonten des Geräts.
- **Netzwerkkonfiguration**: Adapter mit MAC- und IP-Adressen, Gateways und DNS-Server.
- **Volumes und Festplattenverschlüsselung** (BitLocker, FileVault, verschlüsselte Linux-Volumes).
- **Installierte Software** mit Hersteller, Version und Installationsdatum.
- **Sicherheitszustand**: Firewall, Microsoft Defender unter Windows sowie Einstellungen wie Secure Boot, TPM, Gatekeeper, System Integrity Protection, ob der Mac von einem MDM verwaltet wird und ob nach der Bildschirmsperre ein Kennwort verlangt wird.
- **Fehlende Betriebssystem-Updates** mit Schweregrad und Angabe, ob ein Neustart erforderlich ist.
- **Ob die Konsolensitzung gesperrt ist**, mit der Rückmeldung. Die Geräteseite zeigt das nur, wenn Sie es [einschalten](https://dts-identity.com/de/docs/endpoints/device-settings.md).
- **Seinen eigenen Zustand**: Version, Isolationsstatus und Stand der MFA-Einrichtung.

Er erfasst auf dem Endgerät **keine Geolokalisierung** (die Plattform leitet den ungefähren Standort aus der IP-Adresse der Verbindung ab) und **keinen Browserverlauf, keine Dateiinhalte, keine Tastatureingaben und keine Bildschirmfotos**. Die **Prozessliste** mit Kommandozeilen und dem Konto, unter dem jeder Prozess läuft, wird nur erfasst, wenn ein Administrator diese [Remote-Aktion](https://dts-identity.com/de/docs/endpoints/remote-actions.md) ausführt.

Der Erfassungsumfang ist fest. Er ist auf jedem Gerät einer Plattform gleich, und Benutzer können ihn im Agent-Fenster nachlesen (siehe unten). Planen Sie den Rollout mit den Verantwortlichen für Betriebsvereinbarungen oder die Datenschutzfreigabe in Ihrer Organisation: Das Inventar, das angemeldete Konto und die auf Anforderung erfasste Prozessliste sind in den meisten Rechtsordnungen personenbezogene Daten.

## Das Agent-Fenster

Jeder Benutzer sieht den Agent im Infobereich (Windows), in der Menüleiste (macOS) oder als Statussymbol (Linux). Sein Menü zeigt die Zeit des letzten Berichts, und **Jetzt prüfen** fragt bei der Plattform ein aktuelles Compliance-Ergebnis an. Das Fenster hat diese Seiten:

| Seite | Zeigt |
|---|---|
| **Status** | Ob das Gerät verbunden und registriert ist und meldet, und was gerade fehlschlägt. |
| **Compliance** | Das letzte Compliance-Ergebnis des Geräts mit den fehlgeschlagenen Prüfungen. |
| **Zwei-Faktor-Anmeldung** | Unter Windows die zweiten Faktoren des Benutzers für die [Windows-Anmeldung](https://dts-identity.com/de/docs/endpoints/windows-logon-mfa.md), wenn das Gerät sie selbst prüft. |
| **Datenschutz** | Jede Abfrage, die der Agent ausführt, und die Daten, die er zuletzt gesendet hat. |
| **Über** | Die Version sowie **Diagnose senden** und **Diagnose speichern** für Supportfälle. |

## Die Kommandozeile

Der Agent installiert einen Befehl `dts-agent` für Administratoren und den Support am Gerät:

| Befehl | Zweck |
|---|---|
| `dts-agent status` | Der Zustand des Agents als JSON: Verbindung, Registrierung, der letzte Bericht, Isolation und jeder Schritt, der gerade fehlschlägt, mit seiner Meldung. Das Erste, was Sie ansehen sollten, wenn sich ein Gerät auffällig verhält. |
| `dts-agent compliance --refresh` | Das letzte Compliance-Ergebnis, erneut bei der Plattform angefragt. |
| `dts-agent revert-isolation` | Hebt die Netzwerkisolation lokal auf, ausgeführt als Administrator oder Root. Für ein Gerät, das die Isolation von der Plattform abgeschnitten hat. Die Aufhebung wird protokolliert. |

## Verhalten bei nicht erreichbarer Plattform

Der Agent versucht es in wachsenden Abständen von bis zu fünf Minuten weiter und verbindet sich selbstständig neu. Berichte zur Sicherheitslage werden während der Trennung nicht zwischengespeichert; nach einer Störung sieht die Plattform daher den aktuellen Zustand, nicht die verpasste Historie. Etwa zehn Sekunden nach der letzten Rückmeldung erscheint das Gerät in der Konsole als offline. Ein VPN mit vollem Tunnel, das allen Verkehr durch das Firmennetz leitet, muss die Verbindung zu Ihrer Instanz ebenfalls zulassen, sonst bleibt das Gerät offline, solange das VPN steht.

## Aktualisieren

Der Agent aktualisiert sich **nicht** selbst. Ein Update ist ein neues Paket, das genauso verteilt wird wie das erste.

1. Fordern Sie die neue Version unter **Geräteeinstellungen → Registrierung** an und laden Sie sie herunter.
2. Verteilen Sie sie mit Ihrer Softwareverteilung oder Ihrem MDM an die Endgeräte.

Die Installation aktualisiert an Ort und Stelle und erhält die Geräteidentität, sodass Geräte sich nicht erneut registrieren und ihre Historie erhalten bleibt. Testen Sie das Upgrade an einer Pilotgruppe, bevor Sie es flottenweit ausrollen.

## Deinstallieren [#uninstall]

1. **Deinstallieren Sie den Agent** auf dem üblichen Weg der Plattform (**Einstellungen → Apps** unter Windows, Ihre Softwareverteilung oder Ihr MDM, `apt remove` oder `dnf remove` unter Linux). Unter macOS führen Sie `sudo dts-agent uninstall` aus. Die Deinstallation hebt zuerst eine Netzwerkisolation auf und entfernt dann den Dienst, die Programmdateien, den Zustand des Agents und seinen Geräteschlüssel.
2. **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:** Unter Debian und Ubuntu behält `apt remove` den Zustand des Agents, bis Sie das Paket vollständig entfernen (`apt purge`). Das Entfernen des `.rpm` sowie die Deinstallation unter Windows und macOS entfernen ihn.

## Fehlerbehebung

- **Das Gerät erscheint nie im Inventar.** Führen Sie `dts-agent status` auf dem Gerät aus: Es nennt den Schritt, der fehlschlägt. Prüfen Sie, ob das Endgerät Ihre Instanz ausgehend erreichen kann und ob der Registrierungsmodus neue Geräte annimmt. Ein für eine andere Instanz erstellter Installer registriert sich niemals.
- **Der Status meldet einen Verbindungsfehler, obwohl das Netzwerk funktioniert.** Meist ein Proxy, der TLS aufbricht und dessen Stammzertifikat nicht im Speicher des Betriebssystems liegt. Siehe [Voraussetzungen](#requirements).
- **Ein Gerät erscheint doppelt.** Die Maschine wurde neu aufgesetzt oder hat ihren lokalen Zustand verloren und sich erneut registriert. Löschen Sie den alten Datensatz.
- **Software- oder Patch-Daten wirken veraltet.** Die Sicherheitslage wird nach Zeitplan gemeldet. Verwenden Sie die [Remote-Aktion](https://dts-identity.com/de/docs/endpoints/remote-actions.md) **Request full update**, um einen vollständigen Bericht zu erzwingen.
- **Der Browser fragt bei der Anmeldung nach Erlaubnis für den Zugriff auf das lokale Netzwerk.** Compliance-Prüfungen bei der Anmeldung funktionieren, indem die Anmeldeseite den Agent auf derselben Maschine befragt. Chrome 142 und neuer sowie Edge fragen die Benutzer, bevor eine Website eine lokale Adresse erreichen darf. Benutzer können das einmal pro Seite erlauben. In verwalteten Flotten erlauben Sie es zentral für Ihre Anmeldeadresse über die Browser-Richtlinie `LoopbackNetworkAllowedForUrls`, sonst sehen alle Benutzer die Abfrage.
- **Ein Gerät, das die Isolation abgeschnitten hat, lässt sich in der Konsole nicht mehr freigeben.** Führen Sie `dts-agent revert-isolation` auf dem Gerät als Administrator oder Root aus.

## Siehe auch

- [Geräteeinstellungen](https://dts-identity.com/de/docs/endpoints/device-settings.md) für den Installer und das Registrierungszertifikat.
- [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.
- [MFA bei der Windows-Anmeldung](https://dts-identity.com/de/docs/endpoints/windows-logon-mfa.md) für die Anmeldefunktion, die auf dem Agent aufbaut.
- [Legacy-Client](https://dts-identity.com/de/docs/endpoints/legacy-client.md) für Geräte, auf denen noch der bisherige Windows-Client läuft.
