# Remote-Aktionen

Ein Gerät isolieren, seine MFA-Einrichtung ändern, seinen Benutzer anpinnen und Gerätebefehle über die Management-API ausführen.

Requires: Device Identity (DIAM)

> **Add-on erforderlich:** Remote-Aktionen benötigen das Add-on **DIAM** (Device Identity) mit der Funktion **deviceTrust**.

Auf ein verbundenes Gerät kann aus der Konsole eingewirkt werden. Die folgenden Aktionen bilden die Incident-Response-Hälfte des Geräteinventars: Sie grenzen eine Maschine ein, ändern, was sie bei der Anmeldung verlangt, oder korrigieren, wem sie gehört, ohne sie physisch anzufassen.

## Aktionen in der Konsole

Öffnen Sie ein Gerät im [Geräteinventar](https://dts-identity.com/de/docs/endpoints/device-inventory.md) und verwenden Sie sein Menü **Aktionen**.

| Aktion | Wirkung |
|---|---|
| **Isolieren** | Schneidet das Gerät vom Netzwerk ab, um einen Vorfall einzugrenzen. Siehe [was die Isolation blockiert](#what-isolation-actually-blocks). |
| **Isolation aufheben** | Entfernt die Isolationsregeln und stellt den normalen Netzwerkzugriff wieder her. |
| **MFA für Gerät konfigurieren** | Setzt die MFA-Einrichtung des Geräts auf **Erforderlich**, **Optional** oder **Deaktiviert**, geprüft auf dem Gerät. Gesperrt, solange eine [Geräte-Compliance-Richtlinie](https://dts-identity.com/de/docs/security/conditional-access/device-compliance-policies.md#windows-logon) den Modus für dieses Gerät setzt. Siehe [MFA bei der Windows-Anmeldung](https://dts-identity.com/de/docs/endpoints/windows-logon-mfa.md). |
| **Benutzer anheften** / **Gruppe anheften** | Verknüpft ein Betriebssystem-Konto des Geräts mit einem Mitarbeiterkonto Ihrer Wahl oder erlaubt jedem Mitglied einer Gruppe die Nutzung des Geräts. Das Betriebssystem-Konto ist mit dem zuletzt angemeldeten vorbelegt und lässt sich stattdessen eingeben, sodass ein Gerät schon angeheftet werden kann, bevor sich sein Benutzer zum ersten Mal anmeldet: den Benutzernamen ohne Domäne und den kurzen Domänennamen (`DEV`, nicht `dev.example.com`) oder bei einem lokalen Konto den Computernamen. Unter Windows ist die Domäne Pflicht. Konten mit passendem Benutzernamen werden vorgeschlagen. Ein Gerät kann mehrere angeheftete Konten (eines je Betriebssystem-Konto) und Gruppen tragen; die Liste **Angeheftete Konten** auf dem Reiter Übersicht zeigt sie, dort wird eine Anheftung auch gelöst. Ein Gerät, dessen aktiver Benutzer keiner der angehefteten Benutzer ist, wird in der Liste markiert; so wird ein Gerät sichtbar, das den Besitzer gewechselt hat. |
| **Updates installieren** | Installiert die Betriebssystem-Updates, die das Gerät als fehlend gemeldet hat. Siehe [fehlende Updates installieren](#installing-missing-updates). |
| **Diagnose sammeln** | Fordert vom Endpoint-Agenten seine Protokolle und seinen Zustand der letzten 24, 48 oder 72 Stunden an, auf dem Gerät pseudonymisiert. Siehe [Diagnosepakete](#diagnostics-packages). |
| **Gerät löschen** | Entfernt den Datensatz aus dem Inventar. Auf der Maschine selbst wird dadurch nichts deinstalliert. |

Jede Aktion wird im [Audit-Log](https://dts-identity.com/de/docs/monitoring/audit-logs.md) festgehalten, einschließlich der Person, die sie ausgelöst hat.

### Was die Isolation tatsächlich blockiert [#what-isolation-actually-blocks]

Die Isolation richtet lokale Firewall-Regeln auf dem Endgerät ein. Sie ist eine Eingrenzungsmaßnahme, kein Ausschalter: Genügend Konnektivität bleibt bewusst erhalten, damit die Maschine verwaltbar bleibt und die Isolation wieder aufgehoben werden kann.

**Blockiert:** sämtlicher übriger ein- und ausgehender Verkehr, IPv4 und IPv6.

**Bewusst weiterhin erlaubt:**

- Die Verbindung des Geräts zurück zur Plattform, damit Sie die Isolation aus der Ferne aufheben können.
- DNS, DHCP und WPAD, damit der Maschine grundlegende Namensauflösung und Adressvergabe erhalten bleiben.
- Windows-Domänenauthentifizierung, damit die Domänenanmeldung weiter funktioniert.
- Zeitsynchronisation, damit die Uhr stimmt (Endpoint-Agent).
- Loopback-Verkehr auf der Maschine selbst.

Zwei Eigenschaften sind im Betrieb entscheidend. Die Regeln sind **dauerhaft und werden beim Systemstart angewendet**, ein Neustart hebt die Isolation also nicht auf, und die Isolation wirkt bereits, bevor der Client-Dienst startet. Und die Regeln werden **nur durch das Aufheben der Isolation entfernt** oder durch die Deinstallation des [Endpoint-Agents](https://dts-identity.com/de/docs/endpoints/device-client.md#uninstall), die die Isolation zuerst aufhebt. Wird der [Legacy-Client](https://dts-identity.com/de/docs/endpoints/legacy-client.md) von einer isolierten Maschine deinstalliert, bleibt sie isoliert; heben Sie die Isolation dort also zuerst auf. Schneidet die Isolation ein Gerät von der Plattform ab, hebt `dts-agent revert-isolation` auf dem Gerät sie lokal auf.

Die Isolation steht mit dem Endpoint-Agent unter Windows, macOS und Linux zur Verfügung, mit dem Legacy-Client unter Windows. Auf einer Linux-Maschine, die Container betreibt, trennt die Isolation auch das Netzwerk der Container, und eine eigene Firewall des Hosts kann weiterhin blockieren, was die Isolation erlaubt.

### Teilweise Isolation

Ein Gerät kann **Partially isolated** melden. Das ist ein Zustand, kein wählbarer Modus: Der Client vergleicht die tatsächlich vorhandenen Isolationsregeln mit dem vollständigen erwarteten Satz und meldet teilweise Isolation, wenn einige, aber nicht alle vorhanden sind. Typischerweise bedeutet das, dass ein Isolieren oder Aufheben nur teilweise abgeschlossen wurde. Behandeln Sie es als "nicht eingegrenzt" und lösen Sie die Aktion erneut aus.

## Fehlende Updates installieren [#installing-missing-updates]

> **Hinweis:** Das Installieren von Updates gehört zum Patch-Management, das den Plan **Pro** mit dem Add-on **DIAM** voraussetzt. In anderen Plänen listet der Reiter Patches die fehlenden Updates weiterhin auf; Installationsknöpfe zeigt er nicht.

Der Reiter **Patches** eines Geräts listet die Betriebssystem-Updates auf, die die Maschine als
fehlend gemeldet hat. Mit dem aktuellen Endpoint-Agent lassen sie sich von dort aus installieren. Auf einem Gerät mit dem bisherigen DTS Client und unter Linux sind die Installationsknöpfe ausgegraut.

Jedes gelistete Update hat einen eigenen Knopf **Installieren**, und **Alle offenen Updates
installieren** über dem Abschnitt **Systemupdates** startet sie in einem Durchgang. Die Sammelaktion fragt vorher nach;
ein einzelnes Update startet sofort, außer es trägt die Kennzeichnung *Neustart erforderlich*, dann
wird ebenfalls nachgefragt. Updates, die aus dem Schwachstellenkatalog statt vom Gerät selbst
stammen, haben keinen Knopf: Das sind Anwendungs-Updates, und diese Aktion steuert ausschließlich
den Update-Mechanismus des Betriebssystems.

Was nach dem Klick passiert:

- Das Gerät bestätigt den **Start**, nicht den Abschluss. Eine Installation läuft im Hintergrund
  Minuten bis Stunden, deshalb meldet die Konsole nie ein Update als installiert.
- Das Update trägt die Markierung **Installation angefordert**, bis das Gerät seinen Zustand erneut
  meldet, und solange sie steht, sind **alle Installationsknöpfe des Geräts gesperrt**. Eine
  Maschine installiert immer nur einen Satz Updates auf einmal; damit können zwei Administratoren
  auch keine Installationen übereinanderlegen. Die Markierung verfällt nach zwei Stunden, falls sich
  eine Installation nie zurückmeldet.
- **Eine fehlgeschlagene Installation steht am Update.** Das Gerät gibt weiter, was sein eigener
  Update-Mechanismus gemeldet hat, in dessen Worten, und die Knöpfe sind sofort wieder frei statt
  erst nach den zwei Stunden. Die Meldung bleibt am Update stehen, bis es installiert ist oder Sie
  einen neuen Versuch starten.
- **Jeder abgeschlossene Durchgang steht im Audit-Log**, als `DEVICE_UPDATES_INSTALLED` oder
  `DEVICE_UPDATES_FAILED` mit der Meldung des Geräts. So bleibt das Ergebnis lesbar, wenn die
  Markierung verschwunden ist, und ein [Alarm](https://dts-identity.com/de/docs/monitoring/alarms.md) kann fehlgeschlagene
  Installationen melden.
- Die Liste wird korrigiert, sobald das Gerät seinen nächsten Zustandsbericht schickt. Mit
  **Gerätezustand aktualisieren** im Kopf der Geräteseite fordern Sie diesen Bericht sofort an, statt
  auf den täglichen zu warten; der Hinweis zur laufenden Installation wiederholt den Knopf.
- **Das Gerät wird nie neu gestartet.** Ein Update mit der Kennzeichnung *Neustart erforderlich* wird
  erst nach dem nächsten Neustart wirksam, der beim Benutzer oder bei Ihrer regulären Wartung bleibt.

Voraussetzungen und Grenzen:

- Das Gerät muss **verbunden** sein. Für Offline-Geräte werden Installationen nicht eingereiht: Eine
  aufgeschobene Installation liefe Tage später zu einem beliebigen Zeitpunkt gegen eine Liste, die
  zum Zeitpunkt der Einreihung aktuell war.
- Die Aktion benötigt den **aktuellen Endpoint-Agent**. Für Geräte mit dem früheren Client wird sie
  nicht angeboten, unter Linux ebenfalls nicht, da der Agent dort keinen Update-Mechanismus ansteuert.
- Unter Windows läuft immer nur eine Installationssitzung. Die Konsole sperrt die Knöpfe, solange
  eine Installation offen ist, deshalb tritt das selten zutage; eine dennoch eintreffende Anforderung
  wird mit einer Meldung abgelehnt, nicht stillschweigend verworfen.

### Anwendungsupdates [#application-updates]

Auf Windows-Geräten mit dem aktuellen Endpoint-Agent listet der Reiter Patches auch **Anwendungsupdates**
aus dem Paketkatalog auf, und ein bestätigtes hat einen eigenen Knopf **Herunterladen & installieren**. Das Gerät lädt
den Installer selbst von der Adresse des Herstellers, prüft ihn gegen die Prüfsumme des Katalogs und
die Signatur des Herstellers und führt ihn unbeaufsichtigt aus; die Konsole fasst die Datei nie an.
Alles oben Gesagte gilt auch hier: Das Gerät bestätigt den Start, die Knöpfe bleiben während der
Installation gesperrt, ein Fehler wird am Update angezeigt, und das Gerät wird nie neu gestartet. Ein
Update, das erst mit einem Neustart abgeschlossen ist, wird als installiert gemeldet.

Ein Anwendungsupdate ohne Knopf nennt darunter den Grund, zum Beispiel:

- das Paket ist **nicht bestätigt** (mehrere Pakete passen, oder der Installer weicht von der
  installierten Variante ab): Wählen Sie es mit **Paket wählen** direkt am Update;
- die Anwendung ist **in einem Benutzerprofil installiert**, oder ihr Installer **installiert pro
  Benutzer**;
- mehrere Anwendungen auf dem Gerät sind dasselbe Paket, etwa zwei Laufzeitumgebungen nebeneinander;
- der Installer hat **keinen unbeaufsichtigten Modus**, entfernt zuerst die installierte Version oder
  liegt in einem Archiv;
- die Update-Informationen sind **nicht aktuell**: Installiert wird nur mit Katalogdaten von höchstens
  sieben Tagen;
- das Gerät läuft unter macOS: Dort werden Anwendungsupdates aufgelistet, aber nicht installiert.

Anwendungsupdates lassen sich auch auf einem isolierten Gerät installieren: Die Isolation lässt den
Endpoint-Agent selbst durch, und der Agent lädt den Installer. Über die API werden sie nicht angeboten.

## Diagnosepakete [#diagnostics-packages]

Wenn ein Gerät Probleme macht und niemand an die Maschine kommt, fordert **Diagnose sammeln** im Menü Aktionen vom Endpoint-Agenten seine Protokolle und seinen Zustand der letzten 24, 48 oder 72 Stunden an. Das Gerät muss verbunden sein. Auf einem Gerät, das noch den bisherigen DTS Client verwendet, ist der Menüeintrag ausgegraut. Das Paket trifft innerhalb von etwa einer halben Minute ein und erscheint im Reiter **Diagnose** des Geräts, wo es als JSON-Datei heruntergeladen werden kann.

- **Auf dem Gerät pseudonymisiert.** Bevor das Paket die Maschine verlässt, ersetzt der Agent Benutzernamen, E-Mail-Adressen, Domänen- und Rechnernamen, SIDs, IP- und MAC-Adressen, Seriennummern und Profilpfade durch Platzhalter wie `user-1` oder `host-2`. Derselbe Wert erhält im ganzen Paket denselben Platzhalter, sodass Zusammenhänge lesbar bleiben. Die Zuordnung verlässt das Gerät nie. Fehlercodes, Zeitstempel, Versionen und Zustände bleiben unverändert.
- **Nie enthalten:** Schlüssel, Tokens, Passwörter, Codes, Windows-Ereignisprotokolle und die Posture-Rohdaten.
- **Größe.** Der Agent hält ein Paket unter 1 MB und entfernt bei Bedarf die ältesten Protokollzeilen. Ein solches Paket ist als gekürzt markiert.
- **Aufbewahrung.** Ein Paket wird 14 Tage nach dem Sammeln gelöscht.
- **Audit.** Das Sammeln wird als `DEVICE_COMMAND_SENT` protokolliert, jeder Download als `DEVICE_DIAGNOSTICS_DOWNLOADED`, jeweils mit dem auslösenden Administrator.

Ein pseudonymisiertes Paket ist weiterhin personenbezogen. Geben Sie es nur im Rahmen des Auftragsverarbeitungsvertrags an den Support weiter, der Ihre Instanz abdeckt.

## Offline-Geräte und eingereihte Befehle

Ein Gerät gilt etwa zehn Sekunden nach seiner letzten Rückmeldung als offline.

Drei Aktionen lassen sich **für die Wiederverbindung einreihen**: **Isolieren**, **Isolation aufheben** und **MFA für Gerät konfigurieren**. Ist das Gerät offline, bietet die Konsole an, den Befehl einzureihen; er wird automatisch zugestellt, sobald das Gerät zurückkehrt. Jede andere Aktion schlägt auf einem Offline-Gerät sofort fehl, statt gespeichert zu werden.

Regeln der Warteschlange:

- **Ein ausstehender Befehl je Gegenstand.** Isolation und MFA-Einrichtung werden getrennt eingereiht, ein neuerer Isolationsbefehl ersetzt jedoch einen älteren ausstehenden, sodass ein Gerät keine widersprüchlichen Anweisungen ansammeln kann.
- **Eingereihte Befehle verfallen nach sieben Tagen**, wenn das Gerät nicht zurückkehrt.
- **Ausstehende Aktionen sind auf der Geräteseite sichtbar** und können vor der Zustellung abgebrochen werden.
- Auch die Zustellung wird im Audit-Log festgehalten, sodass Sie sowohl sehen, wann ein Befehl eingereiht wurde, als auch, wann er das Gerät tatsächlich erreicht hat.

## Über die API [#through-the-api]

> **Hinweis:** Erfordert die Funktion **deviceTrust**.

Dieselben Befehle stehen programmatisch zur Verfügung; damit binden Sie die Eingrenzung in ein SOAR-Playbook oder Ihre eigenen Werkzeuge ein.

```bash
curl -X POST https://<your-instance>/api/v1/devices/<deviceUid>/query/Isolate \
  -H "Authorization: Bearer <access token>" \
  -H "Content-Type: application/json" \
  -d '{"queueIfOffline": true}'
```

Der Aufruf benötigt den Scope `devices.query`. Setzen Sie `queueIfOffline` auf `true`, um das oben beschriebene Verhalten der Warteschlange zu erhalten; der Standardwert ist `false`, ein einfacher Aufruf gegen ein Offline-Gerät schlägt also sofort fehl, statt aufgeschoben zu werden.

### Verfügbare Befehle

| Befehl | Parameter | Zweck |
|---|---|---|
| `Isolate` | keine | Das Gerät vom Netzwerk abschneiden. |
| `RevertIsolation` | keine | Den Netzwerkzugriff wiederherstellen. |
| `SetMfaEnrollment` | `enrollment`: `Required`, `Optional`, `Disabled` | MFA-Einrichtung für die Windows-Anmeldung setzen. |
| `RequestFullUpdate` | keine | Das Gerät auffordern, seine vollständige Sicherheitslage erneut zu senden. Ändert auf dem Endgerät nichts. |
| `GetProcessList` | keine | Die aktuell laufenden Prozesse zurückgeben. |
| `TerminateProcesses` | `pids` (Endpoint-Agent) oder `signature` (Legacy-Client) | Die Prozesse mit diesen IDs beenden, gelesen aus `GetProcessList` desselben Geräts, oder die eines erkannten Produkts. Der Endpoint-Agent beendet nie sich selbst oder einen systemkritischen Prozess. |
| `Run` | `signature` | Ein erkanntes Produkt starten. Nur Legacy-Client. |
| `Scan` | `signature`, `scanType`: `full`, `default` oder `path`, `path`, `clean` | Einen Malware-Scan des genannten Sicherheitsprodukts auslösen. |
| `UpdateDefinitions` | `signature` | Die Malware-Definitionen des genannten Produkts aktualisieren. |
| `EnableRTP` | `signature` | Den Echtzeitschutz wieder einschalten. |
| `SetFirewallState` | `signature`, `operation`: `enable` oder `disable`, `password` | Ein Firewall-Produkt aktivieren oder deaktivieren. |
| `SetAgentState` | `signature`, `operation`: `enable` oder `disable` | Einen Patch-Management-Agenten aktivieren oder deaktivieren. Nur Legacy-Client. |
| `GetProductInfo` | `productList` | Details der genannten Produkte auslesen. Nur Legacy-Client. |
| `GetRunningState` | `signatureList` | Prüfen, ob die genannten Produkte laufen. Nur Legacy-Client. |
| `BlockEndpointDestinations` | `destinations` | Bestimmte IPv4-Adressen oder Netze auf dem Endgerät sperren. Nur Legacy-Client. |
| `UnblockEndpointDestinations` | `filterKeys` | Zuvor gesetzte Zielsperren entfernen. Nur Legacy-Client. |
| `GetEndpointBlockedDestinationsList` | keine | Die derzeit gesetzten Zielsperren auflisten. Nur Legacy-Client. |
| `DownloadMissingPatches` | `patches` | Die vom Gerät als fehlend gemeldeten Betriebssystem-Updates herunterladen. Ohne die Liste alle angebotenen. |
| `InstallMissingPatches` | `patches` | Diese Updates installieren. Das Gerät wird dafür nie neu gestartet. |
| `CollectDiagnostics` | `hours` (1 bis 72, Standard 24) | Protokolle und Zustand des Agenten für diesen Zeitraum zurückgeben, auf dem Gerät pseudonymisiert. Über die API geht das Paket an den Aufrufer und wird nicht gespeichert. |

Der Parameter `patches` enthält die Kennungen, die das Gerät selbst unter `missingPatches` gemeldet hat: unter Windows eine KB-Nummer, wo es keine gibt die Kennung des Updates selbst, unter macOS ein Update-Label. Lesen Sie sie zuerst aus den Patch-Daten des Geräts aus. Beide Befehle setzen den aktuellen Endpoint Agent voraus, wirken auf den Update-Mechanismus des Betriebssystems selbst und werden unter Linux als nicht unterstützt beantwortet.

Der Parameter `signature` bezeichnet ein Sicherheitsprodukt **so, wie das jeweilige Gerät es meldet**. Lesen Sie ihn zuerst mit `GetProductInfo` aus den Produktdaten des Geräts aus, statt eine über Maschinen hinweg stabile Kennung anzunehmen.

Auf einem Gerät mit Endpoint-Agent wirken `Scan`, `UpdateDefinitions` und `EnableRTP` auf Microsoft Defender (Windows) und `SetFirewallState` auf die Firewall des Betriebssystems (Windows und macOS); `signature` ist dort weiterhin erforderlich, wird aber nicht ausgewertet. Ein Befehl mit dem Vermerk *Nur Legacy-Client* wird für ein solches Gerät abgelehnt. Beim Legacy-Client wirken produktbezogene Befehle auf Sicherheitssoftware von Drittanbietern auf dem Endgerät und funktionieren nur dort, wo das Produkt die Operation unterstützt. Behandeln Sie einen Fehlschlag als "das Produkt hat abgelehnt", nicht als "das Gerät ist nicht erreichbar"; beides wird unterschiedlich gemeldet.

Zielsperren gelten ausschließlich für IPv4.

## Fehlerbehebung

- **Der Befehl lief in eine Zeitüberschreitung.** Das Gerät war erreichbar, hat aber nicht rechtzeitig geantwortet. Prüfen Sie, ob es noch verbunden ist, und versuchen Sie es erneut. Nur die drei einreihbaren Aktionen überdauern eine Wiederverbindung; alles andere muss erneut ausgelöst werden.
- **Die Aktion wurde eingereiht, obwohl das Gerät online wirkt.** Die Liste zeigt den zuletzt bekannten Zustand. Hat das Gerät vor Sekunden aufgehört, sich zu melden, gilt es bereits als offline.
- **Ein Gerät bleibt isoliert, nachdem der Client entfernt wurde.** Beim Legacy-Client sind die Firewall-Regeln lokal und überdauern den Client. Installieren Sie einen Client erneut, heben Sie die Isolation auf und deinstallieren Sie dann ordnungsgemäß. Der Endpoint-Agent hebt die Isolation bei seiner Deinstallation auf.
- **Das Gerät meldet teilweise Isolation.** Lösen Sie **Isolieren** oder **Isolation aufheben** erneut aus, um es in einen definierten Zustand zu bringen.

## Siehe auch

- [Geräteinventar](https://dts-identity.com/de/docs/endpoints/device-inventory.md) für die Geräteliste und die Detailseiten.
- [MFA bei der Windows-Anmeldung](https://dts-identity.com/de/docs/endpoints/windows-logon-mfa.md) dafür, was die Einstellung zur MFA-Einrichtung auf dem Endgerät bewirkt.
- [Endpoint-Agent](https://dts-identity.com/de/docs/endpoints/device-client.md) für das, was auf der Maschine läuft.
- [Audit-Logs](https://dts-identity.com/de/docs/monitoring/audit-logs.md), wo jeder Befehl und seine Zustellung festgehalten werden.
