Files
rust-discovery/docs/windows-system-helper-bootstrap.md
2026-11-14 04:26:43 +01:00

98 lines
6.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Passiver SYSTEM-Helper: Installation und echter Agent-IPC-Nachweis
Stand 2026-11-14: Featureagent nativ21+6 qualifiziert und erhaltend aktualisiert,
Helper im Fall `59c2fd6f-0503-46fd-88f3-985bca376c51` installiert und einmal
gestartet. Tatsächlich LocalSystem/Manual/PID6240, Helper `921cf182…`, eigene
Service-SID, geschütztes Ledger/Lock, leere Aktionsliste, Wirkungen und Reboot
gesperrt. Der echte unveränderte LocalService-Agent PID5140 meldet jedoch
`HELPER_NOT_AVAILABLE`: `verify-peer` ist fehlgeschlagen. **Kein positiver
Pipe-/Readiness-/Wirkungsnachweis.** Die21 nativen Helper-/Bibliothekstests
bleiben ein getrennter Unit-Nachweis aus dem Administrator-Bootstrap.
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.
## Native Reihenfolge und verbleibender Nachweis
Schritte1–5 wurden tatsächlich ausgeführt. Schritt6 wurde ausgeführt und
scheiterte; der Fehlerbeleg bleibt unverändert erhalten. Neue Diagnosekontrollen
sind eine eigene Quellqualifikation und noch kein erfolgreicher Nachweis.
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).