Qualify Windows IPC client runtime and prepare bounded native providers
Rust development slice / linux (push) Failing after 7s
Rust development slice / linux (push) Failing after 7s
This commit is contained in:
@@ -0,0 +1,90 @@
|
||||
# Passiver SYSTEM-Helper: Installation und echter Agent-IPC-Nachweis
|
||||
|
||||
Stand 2026-11-14: Die folgende Strecke ist **implementiert und lokal
|
||||
quellqualifiziert, noch nicht auf der Windows-VM ausgeführt**. Die bisherige
|
||||
native Abnahme von 21 Helper-/Bibliothekstests bleibt ein Unit-Nachweis aus dem
|
||||
Administrator-Bootstrap; sie belegt weder einen laufenden SYSTEM-Dienst noch eine
|
||||
erfolgreiche Pipeverbindung des echten LocalService-Agenten.
|
||||
|
||||
Der optionale Build `system-helper` erkennt ausschließlich die geschützte Datei
|
||||
`C:\ProgramData\RustDiscoverySystem\agent-pin.json`. Die bestehende sechsstellige
|
||||
Agentkonfiguration bleibt erhalten. Fehlt der Pin, bleibt der Client passiv.
|
||||
Ungültige, entfernte oder während einer Operation geänderte Pins schließen die
|
||||
Sync-/Startgrenze. Die öffentliche Signierbindung im Pin ermöglicht keine
|
||||
Enrollment-/Jobfreigabe und aktiviert nicht `enable_jobs`.
|
||||
|
||||
Die Probe wird im tatsächlichen Agentdienst ausgeführt. Eine gemeinsame, einzelne
|
||||
Blocking-Lane begrenzt die Pipeaufrufe auf fünf Sekunden; Probe, Snapshot und
|
||||
Original-Apply haben separate Taskzustände. Die Session holt nur abgeschlossene
|
||||
Tasks ab und bedient währenddessen Heartbeats und Nachrichten. Der Pin wird vor
|
||||
und nach der authentifizierten Operation erneut geprüft. Snapshot und Apply
|
||||
verwenden die bestehenden unabhängigen Helper-/Agent-Sync-Kerne mit expliziter
|
||||
Identität `system`, unveränderten signierten Entscheidungsbytes und dem
|
||||
ursprünglichen protobuf-SyncRequest. Erst `confirm_helper` bestätigt den genauen
|
||||
angewendeten Checkpoint. Diese Integration enthält keine Execute-Route und
|
||||
bewirbt keine SYSTEM-Fähigkeit. Die unqualifizierte Windows-Uhr bleibt geschlossen.
|
||||
|
||||
Ein aktueller, höchstens 8 KiB großer Beleg liegt privat als
|
||||
`state\helper-probe.json`. Er enthält die echte Agent-PID, die gebundene
|
||||
Helperidentität, Challenge und die vom Helper übermittelten Windows-Datei-IDs von
|
||||
Ledger und Lock. Ein fehlgeschlagener Aufruf ersetzt einen vorherigen Beleg durch
|
||||
`authenticated_pipe_exchange=false`. Es gibt kein wachsendes Archiv pro Heartbeat.
|
||||
Eine einzige create-only Stagingdatei begrenzt auch unterbrochene Schreibvorgänge;
|
||||
ein Überbleibsel nach Prozessabbruch wird nicht überschrieben. Der Zeitstempel
|
||||
dient nur der Abnahmefrische, niemals als vertrauenswürdige Jobuhr.
|
||||
|
||||
## Geplante native Reihenfolge, nicht ausgeführt
|
||||
|
||||
1. Einen neuen Agentbuild mit `system-helper` nativ qualifizieren und den
|
||||
bestehenden Agenten identitätserhaltend aktualisieren. Der maßgebliche
|
||||
`devstate/windows-client/current-runtime.json` und sein gehashter tatsächlicher
|
||||
Upgradebeleg müssen beide `system_helper_client_feature=true` ausweisen.
|
||||
Der bisherige passive Build `f64e8115…` reicht dafür nicht aus.
|
||||
2. Der Eltern-Orchestrator erstellt aus der öffentlichen Servermetadatenbindung
|
||||
eine private lokale JSON-Datei mit ausschließlich Tenant-/Asset-/Agent-ID,
|
||||
Generation, Assignmentversion und öffentlichem Signierschlüssel. Keine Tokens,
|
||||
Geräte- oder privaten Signierschlüssel übertragen.
|
||||
3. `deploy/windows/system_helper_bootstrap.py prepare` prüft den aktuellen
|
||||
Runtimebeleg, die 21 tatsächlich bestandenen Unitprüfungen und das damit
|
||||
zugeordnete unveränderliche Helperartefakt `921cf182…`. Anschließend werden
|
||||
ausschließlich diese EXE und der gehashte feste Bootstrapquelltext bereitgelegt.
|
||||
4. `install --case …` legt genau einmal den eigenen Manual-/OWN_PROCESS-Dienst
|
||||
`RmmDiscoverySystemHelper` als LocalSystem mit unrestricted Service-SID an.
|
||||
Public-Policy und Pin sind nur für SYSTEM/Administratoren schreibbar und für
|
||||
beide Dienst-SIDs lesbar. `state` erlaubt ausschließlich
|
||||
SYSTEM/Administratoren/Helper-SID; der Netzwerkagent erhält keinen Ledgerzugriff.
|
||||
Die Policy enthält `allowed_services=[]`, `enable_effects=false` und
|
||||
`allow_reboot=false`. Keine Fixtures, Time-Service-, Recovery- oder
|
||||
Agentkonfigurationen werden verändert.
|
||||
5. `start --case …` startet ausschließlich diesen neuen eigenen Dienst genau
|
||||
einmal. Der laufende LocalService-Agent entdeckt den Pin selbst; kein zusätzlicher
|
||||
Agentneustart erfolgt. Unklarer SSH-Ausgang oder Startfehler erlaubt ausschließlich
|
||||
`readback`, keinen erneuten Installations-/Startversuch und kein Ledgerreset.
|
||||
6. Nach einer normalen periodischen Agentprobe liest `verify-peer --case …` den
|
||||
frischen aktuellen Dienstbeleg. Es vergleicht dessen echte Agent-PID mit dem
|
||||
erhaltenen SCM-Prozess, beide Rollen/Service-SIDs, Helperimage, Policy und
|
||||
Dateiidentitäten. Die beidseitige Kernel-/SCM-/Token-/Imageprüfung stammt aus
|
||||
den beiden echten Diensten; ein Administrator-SSH-Pipeaufruf ist kein positiver
|
||||
Nachweis. Uhr, HelperReady und Systemfähigkeiten müssen weiterhin geschlossen sein.
|
||||
|
||||
Alle lokalen und entfernten mutierenden Phasen schreiben vorher create-only
|
||||
Intents. Bekannte Belege und private Helperzustände werden erhalten. Der Runner
|
||||
führt keine Servermutation, RMM-Jobs, Freigabe, Reboots oder Kunden-Dienstwirkung
|
||||
aus. Die WebUI-Genehmigungsgrenze bleibt für spätere tatsächliche Jobs bindend.
|
||||
|
||||
## Tatsächlich ausgeführte lokale Prüfungen
|
||||
|
||||
- Windows-GNU-Clippy mit `-D warnings`, sowohl Default als auch `system-helper`,
|
||||
für Bibliothek, Agentbinary und Tests: bestanden.
|
||||
- Python-Syntaxprüfung und drei fokussierte Guards: bestanden. Abgedeckt sind die
|
||||
leere passive Policy, der dokumentierte Service-SID-Vektor, das Verbot einer
|
||||
wiederholten Mutation nach verlorenem SSH-Reply und die Ablehnung fremder,
|
||||
veralteter oder fälschlich Ready meldender Probe-Belege.
|
||||
- PowerShell-Parser für Haupt-, Stage-, Launch- und Uploadquelltext: bestanden.
|
||||
- Keine dieser lokalen Prüfungen ersetzt die oben noch ausstehende native Strecke.
|
||||
|
||||
Der deterministische Service-SID folgt
|
||||
[MS-LSAT 3.1.1.1.2](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lsat/252cb6b0-2edc-4403-9d75-5b2786ba859e);
|
||||
nach CreateService prüft der Bootstrap zusätzlich die tatsächliche lokale
|
||||
Windows-Auflösung. Weiterführende offene Windows-Abnahmen stehen in
|
||||
[windows-remaining-implementation.md](windows-remaining-implementation.md).
|
||||
Reference in New Issue
Block a user