Files
rust-discovery/docs/windows-helper-peer-controls.md
T
2026-11-14 05:33:30 +01:00

13 KiB

Read-only Helper-Peer-Kontrollen und SDK-Diagnose

Stand 2026-11-14: Implementiert, lokal gebaut und quellgeprüft; native Vorbereitung, Administrator- und fremde LocalService-Kontrolle bestanden. Die positive Verbindung des tatsächlichen Agenten ist weiterhin offen: der laufende Agent schrieb nur HELPER_NOT_AVAILABLE. Ein laufender SYSTEM-Helper allein belegt keine funktionierende gegenseitige Peerprüfung. Der neue Kontrollbuild ersetzt weder die alte native 21+6-Unitqualifikation noch eine positive Agent-Pipeabnahme.

Der neue helper_peer_controls.py bindet 60 vollständige Build-/Runnerquellen und erstellt einen eigenen Manifest. Windows-GNU-Alltargets-Clippy mit -D warnings, Release-Link, vier lokale Reporting-/Create-once-Guards und PowerShell-Parser einschließlich des gemeinsamen speicherinternen Guards bestanden. Der qualifizierte lokale Fall ist build-40f9d096-8532-45a3-b362-62b4983569bc; sein EXE-SHA256 lautet c25243ff6af4d06c578840c929788d74657377a520b856a7fd96791e52bf406e. Der native Kontrollfall ist 603c2f9d-a2aa-42cb-b113-ad484cac5b7a. Vier tatsächliche Windows-PowerShell5.1-Speicherproben der verwendeten ACL- Konstruktoren bestanden mit exakten Masken. Die anschließende Vorbereitung erstellte nur den geschützten eigenen Kontrollfall; keine RMM-Wirkung. Die Administratorkontrolle (PID9520, echte aktivierte Administratorgruppe, keine Agent-Service-SID) erhielt beim rohen Pipeöffnen ACCESS_DENIED5. Sie hat keinen SDK-Selbstcheck benutzt. Originale Agent-/Helperprozesse5140/6240, Konfiguration, Schlüsselmetadaten, private Helperdateimetadaten, Serverflags und Jobzähler blieben erhalten: Windows0/0/0/0, Linux30/30/26/0. Die anschließende LocalService-Kontrolle (PID9064, User-SID19, eigene aktivierte Service-SID, weder Agent-Service-SID noch Administratorrolle) erhielt ebenfalls beim rohen Pipeöffnen ACCESS_DENIED5. Ihr eigener temporärer Manual-Dienst wurde nach beobachtetem Stopped und dauerhaftem Cleanupintent entfernt. Originalprozesse/-dateimetadaten und beide Jobzähler erneut unverändert geprüft. Die Parentdiagnose wurde danach tatsächlich ausgeführt und blieb unvollständig: eigener SYSTEM-Controller PID9060, CONTROL_ORIGINAL_AGENT_BIRTH, vor Token-Duplikation und Childstart. Der gestoppte eigene Parentdienst wurde entfernt; Originalprozesse/-metadaten und Jobzähler blieben erhalten. Kein Child-/SDK-Ergebnis und kein tatsächlicher atomarer Childspawn-Nachweis aus diesem Versuch.

Eine separate Nur-Lese-Probe belegte die Präzisionsdifferenz: Der CIM-Wert für Agent5140 war 134390970107200320, der echte verwaltete Prozesswert 134390970107200328; für Helper6240 betrug die Differenz einen100ns-Tick. Beide Prozesse liefen weiterhin. Die ursprüngliche CIM-Abbildung hatte die zusätzlichen100ns-Stellen nicht erhalten. Die Korrektur verwendet deshalb den exakten Prozesswert statt einer Toleranz oder eines entfernten Sicherheitschecks. Microsofts .NET-Framework-Referenzquelle führt Process.StartTime über GetProcessTimes und DateTime.FromFileTime; das ist dieselbe Win32-Zeitquelle wie die unveränderte native Rustprüfung. Der neue korrigierte Parentfall 00703dab-51c9-4275-84cb-270ff9917aa7 wurde anschließend mit Manifest build-869a999c… und Kontrollartefakt 35dea018… tatsächlich ausgeführt. SYSTEM-Parent8256 erzeugte den festen Child7360 mit dupliziertem Agent-PRIMARYtoken; tatsächliche atomare Jobmitgliedschaft vor Resume bestätigt, Child beendet/Exit0, Originalagent5140 unverändert. Admin-/SYSTEM-Controllerbelege blieben von Agent-/Childaussagen getrennt. Die60 Buildquellen wurden zusätzlich als gehashter privater Snapshot erhalten; der darin enthaltene vorbereitete Runtime-SCM-Pfad ist ausdrücklich keine native Runtime-/Jobqualifikation und hat einen separat dokumentierten offenen Reviewblocker. Das Kontrollprogramm führt diesen Aktionspfad nicht aus.

Unter tatsächlicher SID19 und aktivierter Agent-Service-SID bestanden alle fünf SDK-Vorprüfungen: eigener Token, öffentliche Root-/Pin-ACL, Helper-SCM-Konfiguration/ Status, Helperprozess-/Tokenquery und Helperimage-/Parent-ACL/-hash. Die eigentliche Probe erhielt nach18ms keine Antwort und HELPER_PIPE_IO. Der Child hat bewusst einen anderen PID und ein anderes Image; dieses Ergebnis bleibt diagnostisch und ist weder eine nachgewiesene konkrete serverseitige Ablehnung noch eine positive Verbindung des echten Agenten. Der Parentdienst wurde nach Stopped entfernt, ursprüngliche Prozesse/-metadaten, Policies und Windows-/Linuxjobzähler erhalten. Der alte Parentfehler bleibt fehlgeschlagen. Die Ursache der tatsächlichen Agentverbindung ist weiter offen.

Der frühere Fall 4a60d264… bleibt vor jedem Kontrolldienststart fehlgeschlagen. Nach einem verlorenen SSH-Reply bei der Stagingprüfung wurden ausschließlich die bereits übertragenen Hashes und das Fehlen eines entfernten Kontrollfalls gelesen. Erst dann wurde die noch nicht erreichte erste Fallvorbereitung fortgesetzt. Diese scheiterte beim ACL-Konstruktor: Ein leerer PowerShell- if-Zweig ergab $null, Arrayaddition erzeugte einen Null-SID-Eintrag für das Controllerverzeichnis. Exakte speicherinterne Windows5-Proben reproduzierten den Fehler; allgemeine/nestende Konstruktoraufrufe ohne diesen Nulleintrag bestanden. Der Fix normalisiert ausschließlich leere Collections und verweigert weiterhin ungültige einzelne SIDs. Alter Teilfall und alte Artefakte bleiben erhalten; der korrigierte Lauf hat einen neuen Manifest und neuen Fall.

Ausschließlich feste interne Probeoperation

examples/helper_peer_controls.rs enthält drei getrennte Kontrollarten:

  1. Ein Bootstrap-Administrator sendet einen rohen, gültig gerahmten Probe {}-Call. Der SDK-Selbstcheck wird absichtlich nicht benutzt und daher niemals als serverseitige Ablehnung gewertet.
  2. Ein kurzlebiger eigener Dienst RmmDiscoveryPeerControl läuft als LocalService mit seiner eigenen enabled Service-SID. Der tatsächliche Token muss User-SID19, seine eigene Service-SID und keine Agent-Service-SID enthalten. Auch dieser Akteur sendet nur den rohen Probe-Frame. Es werden weder Pin noch bestehende DACLs gelockert, um ihm eine Verbindung zu ermöglichen.
  3. Der ausdrücklich erlaubte eigene SYSTEM-Dienst RmmDiscoveryPeerParent bindet den tatsächlichen laufenden Agenten über festen SCM-Namen, PID, Prozessgeburtszeit, gehaltenes Prozesshandle und Imagepfad/-hash. Er fordert ausschließlich ProcessQueryLimited/Synchronize und am Originaltoken Query/Duplicate an. Ein duplizierter PRIMARYtoken startet nur dieselbe feste Kontroll-EXE mit --agent-child <Fall-UUID>, ohne Shell, freie Argumente, Profilimport, SeDebug oder eigene Privileg-/DACLänderungen. Die Erzeugung mit CreateProcessAsUserW und STARTUPINFOEX/JOB_LIST bindet den Child bereits atomar an den vorher konfigurierten eigenen Kill-on-close-Job mit genau einem erlaubten Prozess; es gibt keine nachträgliche Zuweisungslücke. Der dauerhafte Child-Create-Intent steht vor dem API-Aufruf, die tatsächliche Jobmitgliedschaft wird vor Resume geprüft. Die API kann ihre notwendigen Privilegien ausschließlich während dieses Aufrufs am eigenen SYSTEM-Token aktivieren. Nach 20 Sekunden beendet der Controller nur diesen eigenen Job und prüft den unveränderten Originalagenten erneut.

Der Child zeichnet die tatsächliche SID19-/Agent-Service-SID-Identität auf. Er prüft ausschließlich seine eigene SDK-Rolle, die öffentliche Root-/Pin-ACL, Helper-SCM-QueryConfig/QueryStatus, Helperprozess-/TokenQuery sowie öffentliche Image-/Parent-ACL und Imagehash. Danach ruft er das unveränderte SDK mit einer Probe auf. Aufgezeichnet werden nur begrenzte statische SDK-Fehlercodes und unmittelbar bei den separaten WinAPI-Prechecks gewonnene numerische Fehlercodes. Keine privaten Tokenhandles, Schlüssel, Agentdateien oder privaten Ledgerbytes werden gelesen, exportiert oder geloggt. Dies ermöglicht die Eingrenzung eines fehlgeschlagenen Client-Sicherheitschecks ohne Änderung des tatsächlichen Agenten. Kontrolle3 bleibt diagnostic_only: Ein SDK-Fehler wird nicht zu einer unbeobachteten serverseitigen Fehlerklasse umbenannt. Jede erhaltene Antwort des Helpers ist für diesen fremden PID-/Image-Child ein Testfehler.

Beweis- und Cleanupgrenzen

Nur ACCESS_DENIED beim Öffnen oder eine geschlossene Pipe nach Kontakt mit der exakten ursprünglichen Helper-PID gelten bei den rohen Kontrollen als negative Verbindung. BUSY, Timeout, irgendeine Antwort oder SDK-Selbstverweigerung sind keine positive Negativabnahme. Die eigene Tokenrolle und der konkrete Fall müssen zum gespeicherten nativen Ergebnis passen.

Controllerbelege und Intents liegen in einem ausschließlich für SYSTEM und Administratoren schreibbaren Unterordner. Die übrigen Fallverzeichnisse sind für Agent-/Control-SID nur lesbar. Bootstrap erstellt vor dem ersten Akteurstart genau die festen Ausgabe-Leaves mit SYSTEM-/Admin-Owner: Controlausgaben sind ausschließlich für die eigene Control-SID, Childausgaben ausschließlich für die tatsächliche Agent-SID schreibbar. Keine dieser Rollen erhält gegenseitige Writerrechte oder Directory-Create-Rechte; SID19 kann dadurch kein Owner-WRITE_DAC an selbst erzeugten Reports erlangen. Native Ausgabe öffnet nur den vorerstellten leeren Leaf, validiert seinen Pin und überschreibt keinen vorhandenen Beleg. Readback prüft Owner und exakte Writerrolle vor dem JSONlesen und benennt Childausgaben ausdrücklich als agent_token_assertion, niemals als unabhängigen SYSTEM-Beweis.

Der Runner vergleicht vor und nach jedem Schritt ursprüngliche Agent-/Helper-PID, Prozessgeburt, Konto, Image, Konfiguration und öffentliche Helperpin-/Policyhashes. Private Helperdateien und der Geräteschlüssel werden nur anhand ihrer Metadaten verglichen; es erfolgt keine Zeilenabfrage des privaten Helperledgers. Windows- und Linux-Jobzähler sowie Serverflags müssen unverändert bleiben. Policyallowlist bleibt leer, enable_effects=false, allow_reboot=false, Uhr und Fähigkeiten bleiben geschlossen. Es gibt keinen Execute-, Snapshot- oder Applyaufruf und keinen SCM-Fixturejob.

Vor jeder nativen Phase steht lokal und remote ein create-only Intent. Ein verlorener SSH-Ausgang erlaubt ausschließlich readback --id <derselbe Fall>. Der Runner wiederholt keinen Dienst-/Childstart. readback liest ausschließlich; es erzeugt remote keine Intents, ACLänderungen oder Dienstlöschungen. Nur als Teil der Startphase oder durch die gesonderte explizite cleanup-Phase löscht der Runner seine eigenen exakt gebundenen bereits gestoppten Testdienste nach dauerhaftem Cleanupintent; bestehende Agent-/Helperdienste werden nicht gestoppt, neu gestartet oder verändert. Aktive Testdienste werden nach dem begrenzten Readbackfenster erhalten und explizit als unvollständig gemeldet.

Die fünf Sekunden begrenzen Pipe-Frame-I/O; synchrone SCM-/Datei-/Tokenabfragen haben dadurch keine harte Gesamtlaufzeitgrenze. Der Child hat den genannten separaten Prozess-Job; für einen im synchronen Vorlauf hängenden temporären SYSTEM-Elterndienst ist gegebenenfalls ein eigener, eng geprüfter Cleanupschritt nötig. Diese Grenze darf nicht als nachgewiesener harter Diensttimeout oder als vollständig abgeschlossene native Abnahme dargestellt werden.

Geplant, nicht ausgeführt: eigener neuer prepare --manifest … --helper-case … und anschließend die getrennten Phasen admin, service, parent mit derselben Kontrollfall-ID. Der bestehende tatsächliche Helperfall, aktuelle Runtimeindex und deren Hashes sind Pflicht; der Runner übernimmt keine fremden PID-/Imagewerte. Root führt diese Phasen erst nach unabhängigem Review aus. Die WebUI-Genehmigungsgrenze bleibt für sämtliche tatsächlichen RMM-Jobs unverändert.

Die atomare Jobliste und ihre Handlelebensdauer folgen UpdateProcThreadAttribute; Form und Aufrufflag folgen STARTUPINFOEXW und CreateProcessAsUserW. Die vorherige ungestartete Kontrollversion mit nachträglicher Jobzuweisung bleibt historisch erhalten und ist für die native Parentphase nicht freigegeben.

Die erste tatsächliche Prepare-Ausführung des vorherigen Quellstands stoppte im Fall 4a60d264… vor jedem SCM-/Kontrollstart. Die unabhängige WindowsPS5- Speicherprobe reproduzierte den konkreten Fehler: else {@()} lieferte bei der Controller-Verzeichnis-Leserliste $null; Array-Plus fügte daraus eine dritte, ungültige Null-SID nach SYSTEM/Administratoren an. Der allgemeine Fünfargument- Konstruktor und auch die verschachtelte SID-Konstruktion bestanden separat alle sechs Rollen-/Inheritancekombinationen und sind keine nachgewiesene Ursache.

Der neue Quellstand normalisiert nur Null-Collections vor der Identitätsliste zu leeren Arrays; einzelne ungültige SIDwerte werden weiterhin verweigert. Protect und der speicherinterne Guard benutzen dieselben ControlIdentities- und typisierten ControlRule-Funktionen. Der echte lokale pwsh7-Test mit leerer IF-Pipeline bestand; die reine WindowsPS5-Konstruktorphase memory-guard ist für Root vorbereitet, noch kein behauptetes natives Ergebnis. Der alte partielle Fall bleibt erhalten und wird nicht mit geänderter Quelle erneut vorbereitet.