Files
rust-discovery/docs/windows-job-boundary.md
2026-11-13 23:23:42 +01:00

11 KiB

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, fortgeführte Foundation-Abnahmen: Windows-Gates.

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.

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.

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, Statusstruktur, vollständiges IDL.

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, Zeitdienstelemente und Einheiten.

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, Sicherheitsbetrachtung.

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

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.