Endpoint-Agent
Installieren, aktualisieren und entfernen Sie den Endpoint-Agent unter Windows, macOS und Linux, und was er vom Gerät meldet.
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 aus, die Sie in der Konsole auslösen. Ohne ihn kann ein Gerät nicht im Inventar 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.
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
- 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.
- Öffnen Sie Geräteeinstellungen → Registrierung.
- 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.
- 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 beschrieben.
Installieren und registrieren
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.rpmDie 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 wird das Gerät sofort verwaltet oder wartet im Geräteinventar 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.
- 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 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, 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.
- Fordern Sie die neue Version unter Geräteeinstellungen → Registrierung an und laden Sie sie herunter.
- 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
- Deinstallieren Sie den Agent auf dem üblichen Weg der Plattform (Einstellungen → Apps unter Windows, Ihre Softwareverteilung oder Ihr MDM,
apt removeoderdnf removeunter Linux). Unter macOS führen Siesudo dts-agent uninstallaus. Die Deinstallation hebt zuerst eine Netzwerkisolation auf und entfernt dann den Dienst, die Programmdateien, den Zustand des Agents und seinen Geräteschlüssel. - Löschen Sie das Gerät im Inventar. Die Deinstallation benachrichtigt die Plattform nicht, der Datensatz bleibt also bestehen, bis Sie ihn entfernen.
Hinweis: Unter Debian und Ubuntu behält
apt removeden Zustand des Agents, bis Sie das Paket vollständig entfernen (apt purge). Das Entfernen des.rpmsowie die Deinstallation unter Windows und macOS entfernen ihn.
Fehlerbehebung
- Das Gerät erscheint nie im Inventar. Führen Sie
dts-agent statusauf 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.
- 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 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-isolationauf dem Gerät als Administrator oder Root aus.
Siehe auch
- Geräteeinstellungen für den Installer und das Registrierungszertifikat.
- Geräteinventar für die registrierten Geräte und ihre Sicherheitslage.
- Remote-Aktionen für das, was Sie auf einem Endgerät auslösen können.
- MFA bei der Windows-Anmeldung für die Anmeldefunktion, die auf dem Agent aufbaut.
- Legacy-Client für Geräte, auf denen noch der bisherige Windows-Client läuft.