← zur Übersicht

Ein self-hosted Endpoint-Security-Baukasten — Architektur und die Lehren des ersten Live-Tests

11.11.2026. Für Kolleginnen und Kollegen: wie man mit ein paar hundert Zeilen Standardbibliothek einen rechnerübergreifenden Baustein baut, der Downloads prüft, Virenscanner-Quarantäne sichtbar macht und unerwünschte Software aufräumt — ohne EDR-Lizenz, offline-first. Und vor allem: welche vier Bugs erst der Lauf gegen ein echtes Windows zutage förderte, die jede Testsuite überlebt hätten.

Kontext. Entstanden im privaten Homelab, defensiv, auf eigenen Rechnern. Der Wert für die Arbeit liegt nicht in den drei konkreten Diensten, sondern im Muster dahinter und in den Fehlerklassen, die man sich merken kann. Alles hier ist übertragbar auf jedes Setup, in dem Agenten auf Clients mit einem zentralen Dienst reden sollen.

Das Problem

Drei alltägliche Fragen, für die man normalerweise eine Endpoint-Protection-Suite kauft: heruntergeladene .exe-Dateien vor dem Ausführen prüfen, sehen was der Virenscanner rechnerübergreifend wegsperrt, und installierte Adware/PUP wieder loswerden. Alles self-hosted, die Erkennung offline (einzig ein Datei-Hash darf zu VirusTotal), und nichts passiert automatisch an der Substanz — jede destruktive Aktion bleibt bestätigt und umkehrbar.

Das eine Muster, das alle drei Dienste teilen

Die wichtigste Entscheidung ist kein Feature, sondern die Topologie:

Windows-Client (geplante Aufgabe)                 Zentraler Dienst (Container)
  Zustand lesen  ── POST (ausgehend, Token) ─────▶  SQLite + Dashboard + Alarm
  Aktion ausführen ◀── Auftrag (im selben Poll) ──  Mensch bestätigt (hinter SSO)
                   ── POST Ergebnis ──────────────▶

Drei Eigenschaften, die man mitnehmen sollte:

  1. Agent meldet ausgehend, holt Aufträge im selben Request ab. Kein eingehender Port auf den Clients, keine Firewall-Löcher, robust bei wechselnden IPs und VPN. Der Server ist reaktiv; die Clients brauchen nur Outbound-HTTP.
  2. Zweigeteiltes Vertrauen. Die Maschinen-API (melden, Aufträge holen) hängt an einem Token-geschützten LAN-Port. Die Mensch-Oberfläche (Dashboard, „wiederherstellen/entfernen") gibt es nur über den Reverse-Proxy hinter Single-Sign-On — erkannt an einem Header, den nur der Proxy setzt. Fehlt er, ist die UI gesperrt (fail-closed).
  3. Nichts Destruktives ohne Bestätigung, und mit Backup. Wiederherstellen aus Quarantäne, Entfernen eines Programms — immer als Auftrag, den ein Mensch im Dashboard auslöst; der Agent sichert vorher (Registry-Export, Ordner-Kopie), bevor er handelt.

Der Server ist jeweils ~200–400 Zeilen http.server + sqlite3 + urllib — keine Frameworks, keine Pip-Abhängigkeit außer dort, wo echte Analyse nötig ist (pefile, yara-python). Das hält die Angriffsfläche und die Betriebslast klein.

Die drei Bausteine in einem Absatz

Quarantäne-Cockpit liest Windows-Defenders Quarantäne (MpCmdRun -Restore -ListAll), zeigt pro Rechner was gesperrt ist und erlaubt gezieltes, bestätigtes Wiederherstellen. Download-Scanner nimmt eine Datei (Rechtsklick oder Downloads-Watcher), prüft sie statisch — PE-Triage, ClamAV, YARA, VirusTotal-per-Hash, plus eine tiefe Reverse-Engineering-Kette im Hintergrund —, entpackt Archive sicher und prüft jede enthaltene .exe einzeln, und sperrt rote Funde bis zur Freigabe. Endpoint-Hygiene inventarisiert installierte Programme, Browser-Erweiterungen und Autostarts, markiert bekannte PUP/Adware (konservative Marker, Indikator – kein Urteil) und entfernt einen Eintrag erst nach Bestätigung, mit Backup.

Der eigentliche Lehrstoff: vier Bugs, die nur das echte System zeigte

Die Dienste hatten über hundert grüne Unit-Tests und waren per curl end-to-end geprüft. Trotzdem brachte der erste Lauf gegen ein echtes Windows-10 (PowerShell 5.1) vier Fehler — jeweils eine eigene Fehlerklasse, die man wiedererkennt:

1. Katalog-Signaturen. notepad.exe landete auf gelb mit „keine Signatur". Grund: moderne Windows-Systemdateien tragen keine eingebettete Authenticode-Signatur, sondern sind über Security-Kataloge (.cat) signiert. pefile sieht nur die eingebettete Variante → alles Katalog-Signierte gilt fälschlich als unsigniert. Lehre: Signatur-Gültigkeit gehört auf den Windows-Host (Get-AuthenticodeSignature prüft Kataloge), nicht in die plattformunabhängige Server-Analyse. Der Client schickt das Ergebnis jetzt als Header mit.

2. Ubiquitäre Imports als Heuristik. Derselbe Fall flaggte GetTickCount, IsDebuggerPresent, OutputDebugString als „Anti-Analyse". Diese Imports stecken in fast jeder Binary (CRT-Startup). Eine Heuristik, die auf Einzel-Imports anschlägt, produziert Fehlalarme auf sauberer Software. Lehre: Präsenz ≠ Verdacht; ubiquitäre Namen raus, Gewicht runter, lieber Kombinationen.

3. Lokalisiertes Windows. Die Installer scheiterten an New-Object FileSystemAccessRule("SYSTEM", ...) — auf deutschem Windows heißt das Konto „SYSTEM"/„Administratoren" und die Namensauflösung schlägt fehl. Lehre: Well-known SIDs (S-1-5-18, S-1-5-32-544) statt Klartextnamen; Konto-Namen nie hartkodieren.

4. Expect: 100-continue. Der Agent mit großem Body (volles Inventar) brach mit „Verbindung unerwartet getrennt" ab, der mit kleinem Body lief. Ursache: .NET/PowerShell schickt bei größeren POSTs Expect: 100-continue; Pythons http.server (HTTP/1.0) beantwortet das nicht sauber. Dazu ein zweiter Treffer: die echte Registry lieferte einzelne Felder als verschachteltes Objekt statt String, woran SQLite scheiterte. Lehre: Expect100Continue = $false im Client, und server-seitig jede Eingabe defensiv auf den erwarteten Typ zwingen — fremde Systeme liefern nie genau das, was das Schema erwartet.

Keiner dieser vier Fehler wäre in einer Testsuite aufgefallen, weil alle vier an der Grenze zum echten System sitzen: die Signatur-Infrastruktur, die Locale, der HTTP-Stack, die Registry. Das ist die eigentliche Botschaft für Kollegen: „Tests grün" heißt die Mechanik stimmt — nicht es läuft auf dem Zielsystem. Der erste echte Lauf ist Teil der Entwicklung, nicht der Abnahme.

Nebeneffekt: der erste Lauf fand sofort etwas Echtes

Beim ersten Inventar-Lauf markierte die Hygiene-Komponente einen Autostart „VLC Plus Player Updater" ohne Herausgeber — bekannte Adware, die sich als VLC tarnt. Kein konstruierter Testfall; die konservative Markerliste reichte für einen realen Treffer.

Was bewusst offen bleibt (auch das gehört in einen ehrlichen Bericht)

Zum Mitnehmen

Drei austauschbare Dienste, ein Muster: Agent meldet ausgehend, Mensch bestätigt hinter dem Login, nichts Destruktives ohne Backup, offline wo es geht. Und die vier Bugs als Merkposten für jedes Agent-auf-Client-Projekt: Katalog-Signaturen, ubiquitäre Imports, lokalisierte Konto-Namen (SIDs!), Expect: 100-continue und typ-robuste Server. Das Teuerste an solcher Software ist nicht der Code — es ist die Disziplin, sie einmal am echten System laufen zu lassen, bevor man sagt, sie funktioniere.

← zur Übersicht