98 lines
6.5 KiB
Markdown
98 lines
6.5 KiB
Markdown
# 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).
|