218 lines
15 KiB
Markdown
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.
|