91 lines
6.0 KiB
Markdown
91 lines
6.0 KiB
Markdown
# 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).
|