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

218 lines
15 KiB
Markdown

# 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_DENIED`5.
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_DENIED`5. 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](https://github.com/microsoft/referencesource/blob/main/System/services/monitoring/system/diagnosticts/Process.cs)
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 zusätzliche direkte Peerproof-Fall `d792c4c6-1fd6-4a7f-be3f-1c8e515a68e6`
bestand danach mit Manifest `build-f85a85ab…`, EXE `0a7259bf…` und ursprünglichem
Runner `27feeb82…`. Der eigene SYSTEM-Parent3992 führte den unveränderten
produktiven `PeerProof::for_service` gegen Agent5140 aus: tatsächlicher
LocalService-Token mit Agent-Service-SID, Startzeit `134390970107200328`,
Imagehash `2beed7fa…`, SCM- und gehaltene Datei-/Prozessprüfungen bestanden
in20ms. Kein Pipeaufruf, Child, Token-Duplikat oder ACLwechsel. Das ist ein
positiver direkter Prozessbeleg, weiterhin **keine positive Agent-Pipeabnahme**.
Der eigene Parentdienst wurde nach Stopped entfernt; Originalprozesse,
Metadaten, Policies und beide Jobzähler blieben erhalten.
Der erste SSH-Aufruf dieses Falls verlor nach90s seine Antwort. Readback und
zusätzliche Nur-Lese-Prüfung belegten noch keinen `parent-start-intent.json`,
keinen eigenen Dienst und keine Ergebnisdateien. Erst nach dauerhaftem lokalen
Fortsetzungsintent wurde die noch nicht erreichte erste Startphase im selben
Fall fortgesetzt; ein zusätzlicher entfernter CreateNew-Intent und der bestehende
CreateNew-Startmarker verhindern zwei Starts. Der alte Timeout bleibt erhalten.
Die private Ergänzungsreceipt heißt `first-parent-continuation-result.json`.
Eine frische tatsächliche produktive Agentprobe um05:16UTC blieb zuvor
`HELPER_NOT_AVAILABLE`; weder diese noch der diagnostische Childfehler werden
durch den direkten Peerproof zu Erfolgen umgedeutet.
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](https://learn.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-updateprocthreadattribute);
Form und Aufrufflag folgen
[STARTUPINFOEXW](https://learn.microsoft.com/en-us/windows/win32/api/winbase/ns-winbase-startupinfoexw)
und [CreateProcessAsUserW](https://learn.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-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.