173 lines
11 KiB
Markdown
173 lines
11 KiB
Markdown
# Grenze vor dem ersten Windows-PowerShell-Job
|
|
|
|
Stand 2026-11-13, Spezifikation **1.15**. Dieses Dokument beschreibt notwendige
|
|
Voraussetzungen und offene Nachweise, keine neue Zeitvertrauensentscheidung und
|
|
keine Windows-Jobfreigabe. Notebook ausschließlich Entwicklungsrechner;
|
|
Windows-11-Testgast als eigenes Gerät, Server `discovery.ease-technologies.de`.
|
|
Der abgeschlossene Linux-MVP bleibt eigenständig; diese Planung startet keine
|
|
Linux-Jobs. Passive Windows-Nachweise: [Clientstand](../deploy/windows/CLIENT.md),
|
|
fortgeführte Foundation-Abnahmen: [Windows-Gates](windows-gates.md).
|
|
|
|
## Aktuelle Grenze
|
|
|
|
Der Windows-Agent bietet ausschließlich `windows.base/1` und `heartbeat/1` an.
|
|
Er besitzt bisher keinen Jobexecutor, Startgrantverbrauch oder privilegierten
|
|
Helper und verweigert JobOffers/ExecutionPermits. Implementierte passive
|
|
Transportfunktionen sind kein Nachweis ausführbarer Windows-Jobs.
|
|
|
|
Auch der erste Hello-Job benötigt einen persistenten Antrag `pending_approval`
|
|
und einen unveränderlichen, tatsächlich in der WebUI genehmigten Plan.
|
|
Browserautomatisierung darf nur die vorhandene, sichtbar simulierte
|
|
dev/test-Grenze bedienen; keine API-/DB-Genehmigung. Vor Genehmigung bleiben
|
|
Jobs/Outbox/Startgrants/Wirkung null. Neue Versuche benötigen neue Genehmigung;
|
|
Redelivery darf keine zweite Wirkung erzeugen, unklare Wirkung bleibt `unknown`.
|
|
|
|
## TrustedClock: belegte Möglichkeiten, offene Qualifikation
|
|
|
|
Die Spezifikation verlangt bei unklarer Uhrabweichung `CLOCK_UNTRUSTED`;
|
|
Telemetrie darf weiterlaufen. `Utc::now()`, laufender W32Time-Dienst, jüngster
|
|
Eventlogeintrag oder ein frischer Grant beweisen keine vertrauenswürdige Uhr.
|
|
`GetSystemTimeAdjustmentPrecise` beschreibt Regelungsmodus und Frequenz, keinen
|
|
Synchronisierungsstatus: [Microsoft-API](https://learn.microsoft.com/en-us/windows/win32/api/sysinfoapi/nf-sysinfoapi-getsystemtimeadjustmentprecise).
|
|
|
|
Microsoft dokumentiert für lokales `w32tm` Administratorrechte. Deshalb ist ein
|
|
erfolgreicher Administratoraufruf kein Nachweis für den tatsächlichen
|
|
LocalService-Agenten. Lokalisierte CLI-Texte sind außerdem kein strukturierter
|
|
Produktvertrag: [W32Time-Werkzeuge und Rechte](https://learn.microsoft.com/en-us/windows-server/networking/windows-time-service/Windows-Time-Service-Tools-and-Settings).
|
|
|
|
Der dokumentierte strukturierte Weg ist MS-W32T `W32TimeQueryStatus`, Opnum6,
|
|
Interface-UUID `8fb6d884-2388-11d0-8c35-00c04fda2795`, Version4.1. Es handelt
|
|
sich um einen RPC-/IDL-Vertrag, keinen hier nachgewiesenen einfachen SDK-Import.
|
|
`W32TIME_STATUS_INFO` liefert `ulLcState`, `qwLastSyncTicks`,
|
|
`tpTimeLastGoodSync`, `toSysPhaseOffset`, `tpRootDispersion`, `nStratum`,
|
|
`eLeapIndicator` und `eLastSyncResult`:
|
|
[Methode](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/7e80a465-f5f4-4c3c-87ef-12f76e45f8d1),
|
|
[Statusstruktur](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/f60ebce0-df96-4c96-b40b-fdbd34a2c936),
|
|
[vollständiges IDL](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/5793e908-22ef-4cea-962f-fca8a72c485a).
|
|
|
|
`SYNC=2` bezeichnet Synchronisierung; `UNSET`, `HOLD`, `SPIKE` sind kein
|
|
gleichwertiger Beleg. Synchronisierungszustand allein garantiert keine bestimmte
|
|
Genauigkeit. `TSF_Authenticated` zeigt gesondert die Verwendung der
|
|
MS-SNTP-Authentifizierungserweiterung an, nicht bloß einen erfolgreichen lokalen
|
|
RPC-Aufruf:
|
|
[Zustände](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/b4abb4b0-6d6e-41e4-bd41-d54980d0598a),
|
|
[Zeitdienstelemente und Einheiten](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/1da649d7-3edf-4a9a-98c2-907ecacd1633).
|
|
|
|
Eine eigene RPC-Anbindung müsste lokal den authentifizierten Endpunkt
|
|
`\\PIPE\W32TIME_ALT` verwenden und jede automatische Rückstufung auf das
|
|
unauthentifizierte `\\PIPE\W32TIME` verweigern. Der Zugriff unter LocalService
|
|
ist **nicht nativ geprüft**:
|
|
[Transport](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/e0803f6b-e175-4b87-ba63-bbcf51175655),
|
|
[Sicherheitsbetrachtung](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/22d6e8df-0195-476f-8e8e-d81e700f4474).
|
|
|
|
### Kleinste Readinessprobe: geplant, nicht ausgeführt
|
|
|
|
1. Im tatsächlichen LocalService-Dienst Token-SID und fehlende Elevation prüfen;
|
|
keine erfolgreiche Administrator-SSH-Probe als Ersatz verwenden.
|
|
2. Ausschließlich einen festen lokalen Statusabruf mit Zeit-/Ausgabelimit
|
|
qualifizieren. Keine Resynchronisierung, Clock-/Service-ACL-Änderung oder
|
|
zusätzliche Administratorberechtigung. Ein fester CLI-Zugriffsversuch kann
|
|
die Rechtefrage eingrenzen, ersetzt aber keinen robusten Statusvertrag.
|
|
3. Nur begrenzte numerische Statusfelder/Fehlercodes veröffentlichen;
|
|
`unsupported`, `permission_denied` und `unsynchronized` ausdrücklich melden.
|
|
Keine Peer-Adressen oder vollständigen Rohdaten veröffentlichen.
|
|
4. Vor Jobfähigkeit eine dokumentierte Genauigkeitspolitik implementieren und
|
|
nativ prüfen: gültiger Syncstatus, frischer erfolgreicher Abgleich,
|
|
begrenzte Dispersion/Phasenabweichung und monotone Wallclock-Abweichung.
|
|
Konkrete Grenzwerte sind hier noch nicht beschlossen oder qualifiziert.
|
|
Fehler, veraltete Daten oder unbekannte Felder schließen das Startgate.
|
|
|
|
Der dokumentierte RPC-Weg ist ein Implementierungskandidat. Ob er mit den
|
|
vorhandenen Buildtools und ohne zusätzliche Rechte zuverlässig unter LocalService
|
|
verwendbar ist, bleibt offen. Bis zur Qualifikation bleiben Windows-Jobs gesperrt.
|
|
|
|
### Signierter Serverzeitanker: Alternative, nicht beschlossen
|
|
|
|
Ein kryptografischer Zeitanker wäre ein eigener expliziter Vertrauensvertrag.
|
|
Aktuell benötigt bereits `ClientSync.prepare()` eine vertrauenswürdige Uhr;
|
|
`verify_response()` prüft ebenfalls die Zeit. Eine signierte Syncantwort darf
|
|
diesen Kreis nicht stillschweigend umgehen. `ServerHello` enthält im aktuellen
|
|
Protobuf nur Generation und Nachrichtenlimit, obwohl die Spezifikationstabelle
|
|
zusätzlich Serverzeit nennt. Weder eine erfundene Hellozeit noch HTTP-`Date`
|
|
beheben diese Lücke.
|
|
|
|
Ein gegebenenfalls gesondert spezifizierter Zeit-Bootstrap müsste zunächst ohne
|
|
Startwirkung bleiben: frische Zufallschallenge, eigener signierter Domain-Tag,
|
|
Identitäts-/Generations-/Boot-/Channelbindung, begrenzte monotone Roundtripzeit
|
|
und konservatives UTC-Unsicherheitsintervall. Nur wenn das gesamte Intervall im
|
|
gültigen Grantstartfenster liegt, wäre ein Start zulässig. Kein Verlängern eines
|
|
Grants, kein Wiederverwenden alter Antworten nach Prozess-/Bootwechsel; Suspend
|
|
müsste ebenfalls qualifiziert oder der Anker verworfen werden. Rust garantiert
|
|
keine plattformübergreifend konstante Suspendbehandlung von `Instant`:
|
|
[Rust-Primärdokumentation](https://doc.rust-lang.org/std/time/struct.Instant.html).
|
|
Das ist ausdrücklich **keine** implementierte oder genehmigte Clock-Ausnahme.
|
|
|
|
## Gemeinsamer Sicherheitskern statt zweiter Sync-State-Machine
|
|
|
|
Geplant ist ein kleiner plattformneutraler Kern gemäß der vorgesehenen
|
|
`agent-core`-Grenze: `AuthBinding`/`Request` mit unveränderter Serde-Struktur und
|
|
Bytekodierung, bestehender `ClientSync` samt Checkpoints, Replay, konkreten ACKs,
|
|
Unknown-Behandlung und Gate-Schließung. Unix-Dateischutz, Helper-IPC und
|
|
Linux-`NativeClock` bleiben Plattformadapter. `SyncClock` existiert bereits als
|
|
Port. Windows darf keine Unix-Helper-Abhängigkeiten oder kopierte abweichende
|
|
Sync-State-Machine benötigen.
|
|
|
|
Ed25519-Verifikation kann einen kleinen gemeinsamen Verifier-Port erhalten:
|
|
Linux zunächst unverändert OpenSSL, Windows das bereits im Lockfile vorhandene
|
|
`ed25519-dalek 2.2.0`. Dessen `verify_strict` ist nicht automatisch verhaltensgleich
|
|
mit OpenSSL; Regeln für schwache Schlüssel/nichtkanonische Signaturen müssen
|
|
bewusst geprüft werden:
|
|
[Dalek2.2.0-Verifikation](https://docs.rs/ed25519-dalek/2.2.0/ed25519_dalek/struct.VerifyingKey.html#method.verify_strict).
|
|
|
|
Notwendige gezielte Qualifikation, **noch nicht ausgeführt**: Codec-Goldenbytes
|
|
vor/nach Extraktion; gültige/manipulierte Permit-/Syncsignaturen mit beiden
|
|
Backends einschließlich Grenzfällen; bestehende Sync-Replay-/Checkpoint-Tests
|
|
auf gemeinsamem Kern; additive Windows-Journalmigration mit erhaltener Identität,
|
|
monotoner Sequenz und bytegleichen unbestätigten Ereignissen. Kein Reset oder
|
|
neues Enrollment für den Übergang zum Jobjournal.
|
|
|
|
Die derzeitige `telemetry.sqlite` ist noch kein vollständiges Jobjournal.
|
|
`crates/agent-windows/src/journal.rs` begrenzt die Queue auf acht Ereignisse mit
|
|
je höchstens512KiB, prüft aber noch kein explizites SQLite-`page_size`/
|
|
`max_page_count`. Vor dem Jobport ist zusätzlich das endliche Datenbankbudget
|
|
gemäß Spezifikation1.15 zu übernehmen und nativ mit Erhalt von Sequenz, konkreten
|
|
ACKs und Datenbank-Geräteidentität zu qualifizieren. Die Queuegrenze allein ist
|
|
kein Nachweis eines begrenzten Datenbankfiles; kein Löschen für Platzgewinn.
|
|
Diese offene Voraussetzung verändert weder den aktuellen Transportbuild noch
|
|
die weiterhin fehlenden Windows-Jobcapabilities.
|
|
|
|
## Erste Hello-Strecke: Voraussetzungen vor Capability und Wirkung
|
|
|
|
- Domain, Server und WebUI additiv um plattformgebundene Interpreterpläne
|
|
ergänzen. Derzeit ist `run_script` auf `posix_sh|bash` beziehungsweise Linux
|
|
beschränkt. Windows PowerShell5.1 (`powershell`) und PowerShell7 (`pwsh`) sind
|
|
getrennte Fähigkeiten, kein stiller Fallback. Windows-/Linux-Mischungen,
|
|
unbekannte Interpreter und fehlende Capability bleiben an allen relevanten
|
|
Plan-/Genehmigungs-/Startgrenzen verweigert; bestehende Linuxfälle erhalten.
|
|
- Eindeutige Windows-Variante, exakte UTF8-Skriptbytes/Argumente, Hash,
|
|
Zielidentität und `agent_service` vor Genehmigung binden. Erst nach echter
|
|
Bereitschaft Script-/Interpreter- und `rmm.sync.v1`-Capabilities anbieten;
|
|
Clock-, frischer Sync-, Permit- und dauerhafter Einmalverbrauch gemeinsam nötig.
|
|
- Tatsächliches LocalService-Token vor Ausführung prüfen. Kein Administrator-
|
|
oder SYSTEM-Fallback. Maschinen-/Gruppenrichtlinie, WDAC/AppLocker nicht
|
|
abschwächen; keine versteckte `ExecutionPolicy Bypass`-Ausnahme. Der frühere
|
|
prozessbezogene Bootstrap-`RemoteSigned`-Aufruf ist keine Jobfreigabe.
|
|
- Festen kanonischen PowerShellpfad verwenden, geschützte neu erzeugte `.ps1`
|
|
ohne Reparse-Points und strukturierte Argumente. Keine Shellverkettung oder
|
|
nachträgliche BOM-/Encoding-/Prologänderung an genehmigten Bytes. WinPS5.1-
|
|
Encodingverhalten nativ qualifizieren; die erste ASCII-Hello-Fixture beweist
|
|
noch keine beliebige Unicode-Skriptausführung.
|
|
- Netzwerk/Heartbeats dürfen nicht am Kindprozess blockieren. Begrenzte parallele
|
|
Rohbyteausgabe mit Truncation, Timeout/Cancel und vollständiger Prozessbaum-
|
|
Beendigung über qualifiziertes Windows-Job-Object; kein unbeschränktes
|
|
`Command.output()` für freien Jobcode. Keine vererbten Gerätekey-/DB-Handles.
|
|
- Startverbrauch vor Kindstart dauerhaft speichern, Ergebnis bis konkretem ACK
|
|
behalten. Absturz nach möglicher Wirkung bleibt `unknown`, keine automatische
|
|
Wiederholung. Der Hello-Nachweis prüft genau seinen gebundenen Exit/Output;
|
|
eine dokumentierte CRLF/LF-Textnormalisierung ersetzt keine Rohbyteerhaltung.
|
|
|
|
SYSTEM-/NamedPipe-Helper, MSI, Paketverwaltung und Windows-Reboot sind nicht Teil
|
|
dieser ersten unprivilegierten Hello-Strecke. Dieses Dokument wurde ausschließlich
|
|
aus Quellcode und den verlinkten Primärquellen erstellt; keine Produktänderungen,
|
|
Builds, Tests oder VM-/Serverkontakte für diese Planung durchgeführt.
|