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:
- 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.
- 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).
- 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)
- Der LAN-Port ist per Header spoofbar. Die UI prüft einen Proxy-Header; über den Proxy ist das sauber (er setzt/überschreibt ihn), aber wer den rohen LAN-Port direkt mit gesetztem Header anspricht, umgeht das SSO. Im vertrauten Netz vertretbar, sauber wäre ein geheimer Header-Wert statt einer Konstante. Wer so etwas baut: Proxy-Vertrauen nie an einer rate-baren Konstante festmachen.
- Das befüllte Quarantäne-Format blieb unvalidiert, weil Defender die Testdatei entfernt statt quarantänisiert — die Remediation-Aktion dafür umzustellen wäre invasiv gewesen. Der Parser ist defensiv, aber nicht an echten Daten gegengeprüft; ehrlich benannt statt stillgeschwiegen.
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.