diff --git a/Rust_RMM_Implementierungsspezifikation.md b/Rust_RMM_Implementierungsspezifikation.md index 06d04c6..f92c63c 100644 --- a/Rust_RMM_Implementierungsspezifikation.md +++ b/Rust_RMM_Implementierungsspezifikation.md @@ -1,6 +1,6 @@ # Rust RMM: Architektur und Implementierungsspezifikation -Version 1.21 · 2026-11-14 · Sprache: Deutsch +Version 1.22 · 2026-11-14 · Sprache: Deutsch **Zweck:** Vollständige, eigenständig nutzbare Grundlage für die Implementierung einer mandantenfähigen Plattform zur Inventarisierung, Überwachung und Fernadministration von Kundengeräten durch eine Coding-KI und ein Entwicklungsteam. @@ -47,6 +47,11 @@ Codepaar, eigener großer Artefaktpfad, WebUI-gebundener Updatejob und erhaltend Helper-/Updater-Übergabe mit geschlossenem Inflight-/Healthkontrollpfad werden präzisiert. Das ist keine native Applyabnahme oder Freigabe weitererM7-Themen. +1.21 → 1.22 (2026-11-14): Der User erlaubt für Windows einen unabhängigen, +signierten Zeitvergleich mit dem festgelegten Server als alternative Trustsource. +Agent und SYSTEM-Helper prüfen unabhängig; fehlende Qualität sperrt Jobs. +Keine Uhrstellung, keine automatische Genehmigung und kein nativer Erfolgsbeleg. + ## Inhaltsverzeichnis - [0 Auftrag und verbindliche Produktanforderungen](#0-auftrag-und-verbindliche-produktanforderungen) @@ -80,6 +85,48 @@ präzisiert. Das ist keine native Applyabnahme oder Freigabe weitererM7-Themen. ## 0 Auftrag und verbindliche Produktanforderungen +**Userentscheidung Version1.22, signierter Windows-Zeitvergleich:** Auf die +konkrete Frage nach der Alternative zur nicht qualifizierbaren W32Time- +Dienstidentitätsbindung hat der User ausdrücklich „Ja, signierten Zeitvergleich +umsetzen“ geantwortet. Ein unabhängiger signierter Onlinevergleich mit +`discovery.ease-technologies.de` darf daher die aktuelle Windows-Wallclock +qualifizieren. Der frühere Ausschluss eines Serverzeitankers im lokalen +Windows-Clockvertrag wird ausschließlich für diesen gebundenen Vergleich ersetzt. +W32Time-Rohstatus bleibt unverfälscht separat; daraus wird kein lokaler NTP-Sync +erfunden. Keine OS-Zeitstellung oder implizite Resyncfreigabe. + +Ein gesondert geschützter Ed25519-Zeitschlüssel, exakte versionierte Codecbytes +und provisionierte Pins müssen unabhängig von TLS-/Job-/Updateschlüsseln sein. +Agent und SYSTEM-Helper erzeugen und prüfen jeweils eigene Nonce, Inkarnation, +Boot-/Verbindungs-/Gerätebindung und lokale monotone/Wallclockbeobachtung; der +Agent ist beim Helper ausschließlich Transport. Serverseitige Gerätezuordnung +kommt aus gültigem mTLS und tatsächlichem Verbindungskontext, nicht aus +ungeprüften Requestfeldern. TLS/SAN/SNI wird auch bei falscher OS-Zeit nicht +umgangen. Jede fehlende Bindung oder Qualität bedeutet CLOCK_UNTRUSTED. + +Der Server muss vor jeder Signatur tatsächlichen synchronisierten Kernelstatus, +höchstens1h altes gutes Quellensync und konservativ höchstens500ms Gesamtfehler +nachweisen. Fehlende Providerbelege sperren; Pollzeit ersetzt kein Syncalter. +Je verifiergehaltener Challenge gelten höchstens1s bis Prüfung und höchstens100ms +seit Empfang; das zusätzliche Capture-/Timerbudget von höchstens50ms benötigt +reale Plattformqualifikation. Für Capture T, Serverfehler epsilon, vollen selbst +gemessenen RTT R und qualifiziertes Budget delta gilt die konservative Spanne +[T-epsilon,T+epsilon+R+delta]. Lokale Wallclock muss zur gesamten Spanne +höchstens2s abweichen. Startfristen müssen die gesamte Spanne erfüllen: +Untergrenze >= not_before, Obergrenze < start_before. Alte Grantbytes und +60s-Startfenster bleiben unverändert; kein Refresh verlängert einen Grant. + +Boot-/Prozess-/Verbindungswechsel, Replay, Rückwärtszähler, Wallstep oder +Sleepdiskontinuität verwerfen Bereitschaft und offene Challenges. Nach einer +Diskontinuität braucht es eine danach erzeugte Challenge; kein Konstruktorreset +oder gespeicherter Beleg darf den Fence umgehen. Kein längerer Holdover. +Ein Zeitbeleg ist weder SignedSync noch Startgrant oder Jobgenehmigung; +WebUI-, Verbrauchs-, Ledger- und Helpergrenzen bleiben zusätzlich erforderlich. +Der konkrete Entwurf und die offenen tatsächlichen Qualifikationsschritte stehen +in docs/windows-clock-attestation-proposal.md. Dies genehmigt Implementierung, +keinen Clockgatewechsel ohne Linux-first-/Windows-Nachweise. + + **Präzisierung Version1.14, zeitgebundener Rebootnachweis:** Die ursprüngliche Wiederverbindungsfrist ab serverseitiger Startreservierung bleibt unverändert. Ein tatsächlich vor Fristende unabhängig empfangener neuer Boot-Inventarbeleg diff --git a/docs/handover.md b/docs/handover.md index 416e7c3..c412d33 100644 --- a/docs/handover.md +++ b/docs/handover.md @@ -1,5 +1,12 @@ # Übergabe — Linux-MVP abgeschlossen, Windows wird fortgesetzt +**Userentscheidung1.22:** Signierter unabhängiger Windows-Zeitvergleich mit +festgelegtem Server ausdrücklich zur Umsetzung erlaubt; Agent und SYSTEM +prüfen separat, fehlende Qualität sperrt. Normativ Kapitel0/Projektentscheidungen, +[angenommener ADR](windows-clock-attestation-proposal.md). Keine Uhrstellung, +kein impliziter manueller Resync und noch kein Clockgatewechsel. + + **Neuer nativer Linux-Sechsernachweis:** Quellenstand328e440/Main7d328ee, Originalfall349ffb0b, Cloud-VM UID0:6/6 ohne Skip/Filter; separater Readback abgeschlossen. Ein vorheriger lokaler Rechtefehler stoppte vor SSH und wurde @@ -61,8 +68,8 @@ bis zur konkret angefragten Userantwort unausgeführt. Die nachfolgende Descriptorprobe ist einschließlich separater Cleanupauflösung dokumentiert: [Originalfehler und Erhaltung](windows-clock-descriptor-result.md), [statische Runtimeursache](windows-clock-rpc-qos5-analysis.md). Ein signierter -Serverzeitvergleich ist ausdrücklich nur [Entscheidungsvorschlag](windows-clock-attestation-proposal.md); -Userentscheidung dazu angefragt, keine neue Trustsource implementiert. +Serverzeitvergleich ist inzwischen [ausdrücklich angenommen](windows-clock-attestation-proposal.md); +Implementierung und Qualifikation stehen noch aus. **Fortschreibung2026-11-14 nach tatsächlicher Skriptabnahme:** Die vollständige diff --git a/docs/project-decisions.md b/docs/project-decisions.md index 96aea52..ba4b95a 100644 --- a/docs/project-decisions.md +++ b/docs/project-decisions.md @@ -1,6 +1,22 @@ # Verbindliche Projektentscheidungen -Stand: **2026-11-14**, Spezifikation **1.21** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung. +Stand: **2026-11-14**, Spezifikation **1.22** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung. + +## Signierter Windows-Zeitvergleich ausdrücklich erlaubt (Version1.22) + +2026-11-14 hat der User den konkret beschriebenen alternativen Zeitvergleich +mit „Ja, signierten Zeitvergleich umsetzen“ angenommen. Die unabhängige +Agent-/SYSTEM-Prüfung und bestehende WebUI-/Zeitgrenzen bleiben verbindlich. +Kapitel0 der Spezifikation1.22 ersetzt den früheren Ausschluss eines +Serverzeitankers ausschließlich durch den gebundenen Onlinevergleich mit dem +festgelegten Server. Separater Ed25519-Pin, eigene Challenges/Timer je Verifier, +mTLS-Geräte-/Verbindungsbindung, vollständiger RTT im Unsicherheitsintervall, +kein Holdover und kein neuer Grant durch Belegrefresh. W32Time-Rohstatus bleibt +separat; keine Zeitstellung, kein manueller Resync hiermit genehmigt. + +[Vertrag und offene Nachweise](windows-clock-attestation-proposal.md). +Angenommene Produktentscheidung, noch keine qualifizierte Zeitquelle oder +Windowsjobfreigabe. Fehlende tatsächliche Server-/Timerqualität bleibt deny. ## Präzisierung des engen Updatervertrags (Version1.21) diff --git a/docs/windows-clock-attestation-proposal.md b/docs/windows-clock-attestation-proposal.md index 2a168c0..bd12a07 100644 --- a/docs/windows-clock-attestation-proposal.md +++ b/docs/windows-clock-attestation-proposal.md @@ -1,11 +1,13 @@ -# ADR-Entwurf: unabhängiger signierter Zeitnachweis für Windows +# ADR: unabhängiger signierter Zeitnachweis für Windows -Status2026-11-14: **Vorschlag zur Entscheidung, nicht angenommen oder -implementiert.** Kein Targetzugriff, Schlüsselsetup oder Clockgatewechsel. +Status2026-11-14: **Vom User ausdrücklich angenommen: „Ja, signierten +Zeitvergleich umsetzen“.** Normativ in Spezifikation1.22/Kapitel0 und +Projektentscheidungen übernommen. Implementierung und tatsächliche +Qualifikation stehen noch aus; kein Schlüsselsetup oder Clockgatewechsel. Vorausgehender konkreter OSF-Befund: [QOS5-Analyse](windows-clock-rpc-qos5-analysis.md). -## Entscheidung ist nötig +## Angenommene Änderung der Trustsource Die vollständig gelesene Spezifikation1.18 samt aktuellen Main1.20-Deltas, Projektentscheidungen und Entwicklungsregeln verlangen weiterhin tatsächliche @@ -15,15 +17,16 @@ Diskontinuität einen neuen Sync; er schließt einen Serverzeitanker ausdrückli aus. Die VM meldet derzeit W32Time Leap3/Stratum0. Ein signierter Beleg darf diesen Dienstzustand nicht nachträglich als synchronisiert ausgeben. -Dieser Entwurf wäre eine **andere zulässige Vertrauensquelle**: ein signierter +Die angenommene Entscheidung erlaubt eine **andere zulässige Vertrauensquelle**: ein signierter Onlinevergleich qualifiziert die aktuelle lokale Windows-Wallclock; er stellt -sie nicht und ersetzt sie nicht durch einen Hello-Zeitwert. Er würde bewusst +sie nicht und ersetzt sie nicht durch einen Hello-Zeitwert. Er ersetzt bewusst lokalen W32Time-Sync als alleinige Voraussetzung durch streng begrenzte, kryptografisch belegte Vergleichsqualität ersetzen. Auch „neuer Beleg nach Diskontinuität“ wäre dann ein neuer expliziter Vertrag, kein behaupteter neuer -Windows-NTP-Sync. Dafür braucht es eine ausdrückliche normative -Produktentscheidung in Kapitel0/Projektentscheidungen, anschließend Review -und eigene Qualifikation. Bis dahin bleibt der bisherige Adapter geschlossen. +Windows-NTP-Sync. Die ausdrückliche normative +Produktentscheidung ist in Kapitel0/Projektentscheidungen1.22 festgehalten. +Review und eigene Qualifikation bleiben nötig. Bis dahin bleibt der +produktive Windowsclock-Adapter geschlossen. ## Kleiner vorgeschlagener Vertrag @@ -117,8 +120,8 @@ NTP-/ACLänderungen, neue Jobfreigaben oder Ersatz menschlicher WebUI-Genehmigun ## Enger Review- und Nachweisplan -Zuerst ausdrückliche Entscheidung über die andere Trustsource, 2s-/1h-Grenzen -und den Post-Diskontinuitätsvertrag. Danach ausschließlich lesend tatsächliche +Die ausdrückliche Entscheidung über die andere Trustsource und die +beibehaltenen Grenzen liegt vor. Als Nächstes ausschließlich lesend tatsächliche Serverqualität/Provider-API, Windows-Timer und Sync-/Deadline-Integrationspunkte prüfen. Fehlt eine belastbare Qualitäts-/Alters-/Timergrenze, bleibt der Entwurf blockiert; keine Implementierung mit angenommener Güte. @@ -157,5 +160,5 @@ Vor einer Implementierung bleiben tatsächliche Kernelstatusprüfung, authentisierte/beschränkte Provideranbindung aus der Serverlaufzeit, frische gemeinsame Erfassung, konservative Gesamtschranken und deren Linux-first-Nachweise offen. Die vorhandene CLI-Diagnose wird nicht als -fertiger Produktadapter übernommen. Der Entwurf bleibt bis zur angefragten -Userentscheidung unangenommen; Windowsclock unverändert geschlossen. +fertiger Produktadapter übernommen. Die Userentscheidung genehmigt die Umsetzung; sie ersetzt diese technischen +Nachweise nicht. Windowsclock bleibt bis zur Qualifikation geschlossen. diff --git a/docs/windows-clock-readiness.md b/docs/windows-clock-readiness.md index e43d0ed..66a6095 100644 --- a/docs/windows-clock-readiness.md +++ b/docs/windows-clock-readiness.md @@ -1,5 +1,13 @@ # Windows-Zeitstatus: Adapter und native Readinessprobe +**Neue Userentscheidung1.22:** Ein unabhängiger signierter Onlinezeitvergleich +mit dem festgelegten Server ist ausdrücklich zur Umsetzung erlaubt. +Der frühere Ausschluss eines Serverzeitankers gilt für diese Alternative nicht +mehr. [Angenommener Vertrag und offene Nachweise](windows-clock-attestation-proposal.md). +Die folgenden RPC-Belege bleiben historische Befunde; kein Clockgate dadurch +eröffnet und kein W32Time-Sync behauptet. + + Stand 2026-11-14. Ergänzung zu [Windows-Jobgrenze](windows-job-boundary.md). Diese Strecke ändert weder die Windows-Geräteidentität noch die WebUI-Grenze. Ein Zeitstatusbericht ist keine Jobgenehmigung. `NativeClock::now()` verweigert