162 lines
11 KiB
Markdown
162 lines
11 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 Parent-/Childdiagnose ist noch nicht ausgeführt; die beiden Negativkontrollen
|
|
beweisen weiterhin keine positive Verbindung des tatsächlichen Agenten.
|
|
|
|
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.
|