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

6.5 KiB
Raw Blame History

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; 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.