Files
rust-discovery/docs/windows-sync-alignment-205-implementation.md
kevin_janssen cafd13bca9
Rust development slice / linux (push) Failing after 7s
Deploy reviewed Windows sync alignment with schema 20 server
Bind the administrative connection-205 review to original signed history and preserve closed readiness. Include the qualified server dependency closure, UI review, native ARM64 build provenance, and guarded deployment evidence. Migration, API/gateway replacement and TLS checks passed with unchanged job authority, protected mounts and time/database services; native Windows receipt application remains separate.
2026-11-16 13:30:31 +01:00

208 lines
13 KiB
Markdown

# Administrativer Kontrollabschluss für Verbindung 205
Stand 16. November 2026. Grundlage ist die ausdrückliche Userentscheidung in
Spezifikation 1.28 und der [konkrete Fall](windows-sync-alignment-205-proposal.md).
Dieser Text dokumentiert Quellen und lokale Prüfungen. Eine native Anwendung
oder tatsächliche WebUI-Bestätigung wird damit nicht behauptet.
Der neue Domainvertrag `windows_sync_alignment` bindet ausschließlich den
bekannten Tenant, Asset, Agent, Boot und Verbindung 205: Agententscheidung
`2af359c5-5b5c-4992-b445-1c00e271a288`, Helperentscheidung
`1a4758ad-0b39-449e-8551-16846851b09a`, Agentcheckpoint 10137. Der tatsächliche
Helpercapturecheckpoint muss mindestens 148 sein und wird im Zeugen exakt
gebunden; er darf bei der Anwendung nicht auf den historischen Applycheckpoint
135 zurückgesetzt werden. Beide ursprünglichen Requests und signierten
Antworten bleiben als vollständige Originalbytes erhalten.
Der streng typisierte native Zeuge enthält außerdem beide Journalidentitäten,
sechs konkrete Datei-/Lockrollen mit unabhängig gemessenen Windowsdatei-IDs und
Hashes, beide geschützten Bindings und den öffentlichen Verifikationskey,
drei kanonische vollständige Inventarhashes sowie feste Zähler. Er enthält die
ursprünglichen Echo-Offer-/Start-/Outcome-/Resultbytes, die signierte vorhandene
Echo-Abschlussquittung und das abgelaufene Offer ohne Grant. Der Zeuge ist keine
OS-Fernattestierung: der Server prüft seine gespeicherten Originale; der native
Operator muss Dateien, Datenbankinhalte, Locks, geschützte Bindings und alle
Inventare selbst erneut prüfen. Keine Schlüsselbytes gehören in den Zeugen.
## WebUI und Server
Der nur im expliziten Entwicklungsprofil registrierte Pfad ist
`/api/v1/tenants/{tenant}/windows-sync-alignment`:
- `POST` reicht einen unabhängigen Zeugen ein und prüft ihn gegen die
Serverhistorie. Dies erzeugt ausschließlich einen unveränderlichen
administrativen Prüfantrag.
- `GET` liest den gespeicherten Antrag samt letzter Quittung.
- `/{request}/confirm` erfordert eine tatsächliche CSRF-geschützte
Browsersitzung des sichtbar simulierten Testprincipals. Die aktuelle aktive
Testhuman-Mitgliedschaft mit `plans:approve` bleibt bis zum Commit gesperrt.
MCP-/Automation-Scopes oder eine fehlende Sitzung verweigern die Bestätigung.
- `/{request}/receipt` liefert ausschließlich eine gültige signierte
administrative Quittung für exakt diesen Zeugen.
Die separate Geräteansicht zeigt den vollständigen Zeugen und seinen
kanonischen Hash vor der ausdrücklichen Checkbox-/Buttonbestätigung. Jede
Quittung gilt höchstens fünf Minuten. Ein weiterer tatsächlicher Bestätigungsklick
kann eine neue befristete Quittung für denselben unveränderten Zeugen anfügen;
kein automatischer Refresh und keine Ersetzung alter Quittungen. Jede Quittung
und ihr Audit tragen `dev_test_browser_simulation`, den Testprincipal und
`testsimulation=true`. `ready`, `helper_ready` und `unlock` sind immer falsch.
Der Server hält dieselbe Kontrollsperre wie der reguläre Abgleich und prüft
aktuelle Identität/Boot/Verbindung sowie den gespeicherten zweiten Head. Beide
ursprünglichen Entscheidungen werden kryptografisch gegen denselben aktuellen
gepinnten Job-Verifikationskey, ihre exakten gespeicherten Bytes und die
kanonisch dekodierten ursprünglichen Proto-Requests geprüft. Ausstellungszeit
wird nur für die **historische** Profilprüfung verwendet; es erfolgt kein
normaler Apply einer abgelaufenen Lease.
Genau zwei vorhandene Jobs müssen zu den bekannten abgeschlossenen Versuchen
gehören: der erfolgreiche Echoauftrag mit genau einer ursprünglichen
signierten Startfreigabe und die abgelaufene Anfrage ohne Grant. Serverjobbytes
und Angebote müssen mit den unveränderlichen damals genehmigten Planbytes
übereinstimmen. Echo-Consumption/Start/Outcome werden mit der vorhandenen
signierten Abschlussquittung und dem gespeicherten Serverergebnis verbunden.
Ein weiterer Job/Grant, ein anderes Outcome oder abweichende Originale verweigern
diesen Weg. Der noch offene neue Skriptplan wird hierdurch weder genehmigt noch
verlängert.
Migration 0020 fügt ausschließlich zwei neue Tabellen hinzu: unveränderliche
Prüfanträge und angefügte Quittungen. Beide verwenden erzwungene Tenant-RLS;
der Anwendungsrolle werden nur SELECT und INSERT erteilt. Immutable-Trigger
verweigern UPDATE/DELETE; der Quittungstrigger bindet Nutzlast, gespeicherten
Zeugen, fünfminütige Frist und alle drei falschen Bereitschaftswerte. Keine
alte Tabelle, Jobgenehmigung, Outbox oder reguläre Abgleichentscheidung wird
über diesen Pfad verändert.
## Tatsächlich lokal geprüft
- Domain und Server: `cargo clippy --locked --offline -p rmm-server -p
rmm-domain --all-targets -- -D warnings` erfolgreich im vorhandenen isolierten
Linuxbuilder, ohne Netzwerk und mit lesendem Source-Mount.
- Zwei Domainprüfungen bestanden: andere Vorfälle/Verbräuche/veraltete Captures
werden verweigert; Quittungen können keine Bereitschaft oder echte menschliche
Genehmigung behaupten und überschreiten ihre feste Fünfminutengrenze nicht.
Der Codecfixture ist ausdrücklich kein kryptografischer Nativenachweis.
- Ein Servertest bestand: Bestätigung erfordert die echte Browsersitzungsform;
fehlende CSRF/Sitzung, Automationsscopes und unpassender Principalstatus werden
verweigert.
- Web-Typecheck sowie zwei gezielte UItests (neuer Fall 205 und bestehender
Echoabschluss) bestanden. Der neue Test verweigert veränderte Geschichte,
erhöhte Wirkungszähler, andere Verbindung, Bereitschaft, unsichtbar behauptete
menschliche Genehmigung und verlängerte Quittungen.
- In einem separaten lokalen PostgreSQL-16-Container ohne Netzwerk oder
veröffentlichten Port wurden alle 20 Migrationen erfolgreich angewandt.
Beide neuen Tabellen haben erzwungene RLS, die App nur SELECT/INSERT und
die erwarteten drei Unveränderlichkeits-/Validierungstrigger. Danach standen
null Jobs und null ausgestellte Quittungen. Der Testcontainer wurde entfernt.
Beleg: `devstate/windows-sync-alignment-local/a54b4e41-4e95-48e7-84de-f6a9ecd6588c`.
Noch separat nachzuweisen sind der unabhängig erzeugte native Originalzeuge,
seine tatsächliche serverseitige Prüfung, die echte simulierte WebUI-Interaktion,
die einmalige geschlossene native Anwendung bei gestoppten Diensten und
gehaltenen ursprünglichen Locks sowie der anschließende neue reguläre Abgleich
beider Rollen. Diese lokalen Prüfungen ersetzen keinen dieser Schritte.
## Tatsächlicher nativer ARM64-Build, weiterhin ohne Bereitstellung
Ein neuer öffentlicher Quellsatz samt gebauter WebUI wurde anschließend unter
`devstate/server-build-only/a48f78614e2e` eingefroren. Er enthält 398 öffentliche
Compiler-/Test-/Frontenddateien. Die 205-Domain-/Serverquellen und Migration 0020
sind mit ihren oben geprüften Bytes enthalten. Mitkopierte Windowsquellen
stellen keinen Windows-Abnahmenachweis dar; spätere Windowsänderungen verändern
diesen bereits eingefrorenen Serverbuild nicht.
Der Build lief tatsächlich auf dem ARM64-Server ausschließlich unter
`/opt/rust-discovery/devstate/server205-a48f78614e2e`. `docker build` verwendete
`--network=none --pull=false` und den zuvor unabhängig aus Docker-Metadaten als
ARM64/Linux bestätigten vorhandenen Builder
`sha256:30ae3d90753bc39b0a98a897784c662aff9598ffab7a98a6298e8aa79145c2ec`.
Dort bestanden Server und Zeitbroker `cargo clippy --locked --offline
--all-targets -- -D warnings`; beide Releaseprogramme wurden erfolgreich gebaut.
Die Programme wurden aus dem Image extrahiert, als tatsächliche AArch64-ELFs
geprüft und mit den im Image gemessenen Hashes verglichen.
| Gegenstand | Tatsächlicher SHA-256 |
|---|---|
| Quellen-/Webmanifest | `7594ab8eda6cd3e75852ed03ed7033da32e8997898dce05b1b7584f8c14c12ff` |
| Übertragenes Paketarchiv | `10110359967db1cca67b879a6620f196f5449e187f8cf24d687867baeefaaf38` |
| Image `rust-discovery-server:server205-a48f78614e2e` | `a7fc4243fee414ab6c85c5f4d207b6428005b77ab06903916138a83b4b74e1d4` |
| `rmm-server`, 27.061.568 Byte | `ef88115eb0184af83738f90fd4c9fd1e96d50eda128bc959909a623c47396559` |
| `rmm-time-broker-linux`, 1.072.816 Byte | `da8e6644b221f012322ce26f8a58c0ad4e7e8980d0648f5037d6ea99d8be599a` |
| Nativer Buildbeleg | `a00c38fe68d01928167fbb0116c5e904aed29e89fa8d920ac89e833d2d8275f5` |
| Nativer vollständiger Buildlog | `1c5e3ab12a4c734d93d5c0dbd658bb1b0bf3fcb226a3ca0009dc7b7ea7b6c085` |
Die Rohprogramme liegen auf dem Server unmittelbar im genannten Fallverzeichnis;
Quellen und Webartefakte unter `package/`. Öffentliche Originalbelege und Logs
sind zusätzlich lokal als `native-build.receipt.json`, `native-build.log` und
`native-build-worker.py` erhalten. Der Controller ist
`deploy/server_build_only.py`. Er führt weder Compose noch SQL aus und startet
kein Anwendungsprogramm. Nur `sha256sum` lief kurz in einem abgeschotteten
Artefaktcontainer. Die tatsächlichen API-, Gateway- und PostgreSQL-Container
hatten vor und nach dem Build dieselben IDs, Images, Startzeiten und
Restartzähler; `runtime_unchanged=true` ist separat gespeichert. Kein Brokerpfad,
Pin, Dienst, Mount oder Loopbackvertrag wurde geändert. Das neue Image und die
WebUI sind damit **gebaut, noch nicht durch diesen Schritt bereitgestellt**.
Der vorangegangene erhaltene Fall `server205-68a4e912fe1c` endete mit Exit 101:
Der erste Paketfilter hatte die per Rust-`#[path]` eingebundene Datei
`tests/backend_root_logs.rs` nicht aufgenommen. Der vollständige öffentliche
`tests/`-Baum wurde ergänzt und ein neuer unveränderlicher Fall gebaut. Kein
Testtarget oder Clippyfehler wurde unterdrückt; der fehlgeschlagene Originalbeleg
bleibt erhalten. Das erfolgreiche Paket verwendet keinen fest codierten alten
Releasepfad und ersetzt keine bereits vorhandenen Rohartefakte.
## Tatsächlich bereitgestellt: Migration 20, API, Gateway und WebUI
Der anschließend ausdrücklich beauftragte Deployment-Abnahmeschritt ist
abgeschlossen. Vor jeder Mutation wurde die tatsächliche Composekette der
bestehenden API aus ihren Containerlabels gelesen und mit allen vorhandenen
Overlays erhalten. Eine zusätzliche feste Overlaydatei ändert ausschließlich
die Images von API, Gateway und Migrator auf das oben qualifizierte Image
`a7fc4243…` mit `pull_policy: never`. Das vollständige aufgelöste Composemodell
wurde auf genau diese drei Änderungen verglichen. Container-Environmentwerte
wurden ausschließlich intern verglichen; Protokolle enthalten nur ihre Hashes.
Bei der Vorprüfung wurde Compose-`entrypoint: null` korrekt als Vererbung des
unveränderten Image-Entrypoints normalisiert; es wurde kein Entrypoint geändert.
Die echte Migration über das qualifizierte Migratorprogramm erhöhte den
geprüften SQLx-Stand von 19 auf 20. Alle bestehenden Migrationschecksummen
entsprachen exakt den eingefrorenen Quellen. Die zwei neuen Tabellen waren
anschließend leer; keine Quittung oder Jobgenehmigung wurde ausgestellt.
Danach wurden ausschließlich API und Gateway mit `up --no-deps --no-build
--pull never` neu erstellt. PostgreSQL, Chrony und der Zeitbroker wurden nicht
neu gestartet; Brokerbinary, -pins und -konfiguration blieben unverändert.
Beide neuen Container laufen mit dem exakten Image
`sha256:a7fc4243fee414ab6c85c5f4d207b6428005b77ab06903916138a83b4b74e1d4`,
Startzeit 16. November 2026, 12:26:14 UTC, Restartzähler null. Ihre tatsächlichen
Serverbinaryhashes entsprechen `ef88115e…`. UID/GID 10001, vollständige Envwerte,
Mounts einschließlich des nur lesenden Brokersockets, Netzwerknamen,
Loopbackbindungen 127.0.0.1:18443/18444, Readonly-Rootfs, CapDrop ALL und
no-new-privileges wurden vor und nach dem Wechsel verglichen und erhalten.
PostgreSQL hat weiterhin keinen veröffentlichten Port und dieselbe
Containeridentität/Startzeit. Die tatsächlichen Prozess-/Startbelege von Broker
und Chrony sowie die Metadaten der ursprünglichen PKI-, Jobkey- und Policybäume
sind unverändert.
API und Gateway lieferten tatsächlich HTTPS-Health 200 mit geprüftem CA-Vertrauen
und passendem Servernamen; der TCP-Override für den Gatewaytest veränderte nur
127.0.0.1:18444, SNI/Namensprüfung blieben
`discovery.ease-technologies.de`. Die neue Verwaltungsroute antwortete ohne
Anmeldung mit 401. Die neue WebUI wurde über unveränderliche Assetnamen und
zuletzt atomar ersetzten Index bereitgestellt; die tatsächlich über HTTPS
abgeholten Indexbytes entsprechen dem eingefrorenen Hash `d38d869f…`.
Vorher und nachher bestanden unverändert 33 Jobs, 28 Grants, 33 Autorisierungen
und 33 Outboxeinträge. Windows blieb bei exakt zwei Jobs/einem ursprünglichen
Echo-Grant sowie Verbindung 205/Checkpoint 10137/Entscheidung `2af359c5…` und
Helperbezug 135. Dieser Schritt startete keinen Windowsdienst und erzeugte
keine Startfreigabe. Die tatsächliche administrative WebUI-Bestätigung und
native geschlossene Anwendung sind separate, anschließend koordinierte Schritte.
Controller: `deploy/server_deploy_205.py`. Originale und Ergebnisbelege liegen
auf dem Server unter `server205-a48f78614e2e/deployment205-*` und lokal unter
`devstate/server-build-only/a48f78614e2e/local-deployment-*.json`.
Ein kompakter öffentlicher Abschlussbeleg steht in
`docs/evidence/server205-deployment.json`.