From 9fac50a8d1f90d1e76b98ed0baa38aa27d18a9d7 Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Tue, 17 Nov 2026 16:50:01 +0100 Subject: [PATCH] Record deployed release recovery and receipt-bound worker rotation --- docs/development.md | 2 + ...gent-release-worker-rotation-20261117.json | 110 ++++++++++++++++++ docs/handover.md | 4 +- 3 files changed, 114 insertions(+), 2 deletions(-) create mode 100644 docs/evidence/agent-release-worker-rotation-20261117.json diff --git a/docs/development.md b/docs/development.md index 7fb16f8..ef60ca3 100644 --- a/docs/development.md +++ b/docs/development.md @@ -82,3 +82,5 @@ Ein geänderter stabiler Bootstrap-Updater wird ausdrücklich je Mandant rotiert Für den gezielten Austausch des stabilen Workers zuerst die fertige Datei mit `tools/dev_stage.py windows DATEI` übertragen. [Replace-DevelopmentReleaseUpdater.ps1](../deploy/windows/Replace-DevelopmentReleaseUpdater.ps1) erwartet `-Candidate`, die beiden exakten Hashes über `-ExpectedPreviousSha256` und `-ExpectedCandidateSha256`, `-AgentId` und die zu prüfenden `-VerifyReleaseIds`. In einer administrativen Windows-PowerShell ausführen. Der Befehl verlangt einen laufenden Agenten und gestoppten Updater, prüft die signierten Releasepaare nativ, ersetzt den Worker atomar mit Sicherung und startet den Updatedienst mit SCM-Wiederanlauf. Bei standardmäßig Restricted geltender Skriptrichtlinie für die Entwicklungs-PowerShell `Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned` verwenden. Dieser Weg wurde am 17. November für den Worker `de75510b…` ausgeführt. Der anschließende reguläre Abruf aktivierte Windows `0.1.3` auf derselben Geräteidentität. [Nativer Beleg](evidence/windows-https-release-20261117.json) + +Für die separate Veröffentlichung eines korrigierten stabilen Workers ohne neues Agentpaket verwendet der Entwicklungsrunner `--rotate-worker-only --rotate-bootstrap-from SHA256` zusammen mit `--artifacts` und `--build-receipt`. Die Quittung muss die passende Plattform und den übertragenen Worker binden. Der Aufruf prüft den gespeicherten Worker und rotiert nur den Bootstrap-Pin des gewählten Mandanten. [Veröffentlichungs- und Rotationsnachweis](evidence/agent-release-worker-rotation-20261117.json) diff --git a/docs/evidence/agent-release-worker-rotation-20261117.json b/docs/evidence/agent-release-worker-rotation-20261117.json new file mode 100644 index 0000000..bae1485 --- /dev/null +++ b/docs/evidence/agent-release-worker-rotation-20261117.json @@ -0,0 +1,110 @@ +{ + "environment": "development", + "server": "discovery.ease-technologies.de", + "tenant_id": "11111111-1111-4111-8111-111111111111", + "platform": "x86_64-pc-windows-gnu", + "worker_rotation": { + "method": "Receipt-bound PE upload via catalog API, independent SHA-256 and size check of stored tenant object, compare-and-swap from prior tenant pin", + "previous": { + "sha256": "333cf84c1594ac0d44951aa4141635afdd9b3f1bdb5f2d8b701d384c0abc93e3", + "bytes": 26965924 + }, + "current": { + "sha256": "de75510b9b2971658dcadd197364c4135b629448bd6f47bf187033c189e349f7", + "bytes": 27024082 + }, + "previous_download_grace_until_utc": "2026-11-17T16:00:00+00:00", + "platform_default_worker": { + "sha256": "ed21b27da69147db8f25ceb6ceb915c8f807ab55bffccddcd0b472e222930f51", + "bytes": 26872723 + }, + "build_receipt_sha256": "6a13eb387f4e37e98effa5765243dd34a66d1fc4ea5df7a12e1aa23b1a8ef7fe", + "native_verification": { + "os": "Windows 11", + "candidate_sha256": "de75510b9b2971658dcadd197364c4135b629448bd6f47bf187033c189e349f7", + "signed_versions_verified": [ + "0.1.2", + "0.1.3" + ] + }, + "signed_pairs": [ + { + "sequence": 3, + "version": "0.1.2", + "release_id": "6b695fec-69c6-4f87-b5ab-e405b93a1a7f", + "manifest_sha256_at_original_publication": "243ba0a9301e0c7ec79f24ba23291fe2dc4531990c117ef6958325c74eac49f8", + "manifest_sha256_after_worker_rotation": "243ba0a9301e0c7ec79f24ba23291fe2dc4531990c117ef6958325c74eac49f8", + "manifest_sha256_after_E_publication": "243ba0a9301e0c7ec79f24ba23291fe2dc4531990c117ef6958325c74eac49f8" + }, + { + "sequence": 4, + "version": "0.1.3", + "release_id": "1023b63b-08fe-409a-bf9b-9cfe3cd769d6", + "manifest_sha256_at_original_publication": "b03e576103fcc0a2d04870fb32fdf4528b783937bfb668d93376ad49b9904670", + "manifest_sha256_after_worker_rotation": "b03e576103fcc0a2d04870fb32fdf4528b783937bfb668d93376ad49b9904670", + "manifest_sha256_after_E_publication": "b03e576103fcc0a2d04870fb32fdf4528b783937bfb668d93376ad49b9904670" + } + ], + "catalog_readback_after_worker_rotation_utc": "2026-11-17T15:48:03.393127+00:00" + }, + "release_publication": { + "channel": "Windows GNU development", + "sequence": 5, + "source_commit": "863dcb04b1df315f38087533ab3691d4a3995bb4", + "source_snapshot_sha256": "a03b3d94e29593c68cf5af4582bbd0164738dfda0fe52bf41389523a08fe087d", + "build_receipt_sha256": "2dbf18238caf55cb243d23599df1f267ce405c90c2d4a92d97090741131f7193", + "version_overrides": [ + "Cargo.toml", + "Cargo.lock" + ], + "published": { + "release_id": "3dcb2484-fb2d-418d-84f0-aa54f5c4c209", + "version": "0.1.4", + "manifest_sha256": "5e8cc9c96f280458f96d81cff3087004a0062db6951ceb4dcc47e2814df9169d", + "published_at_unix": 1794930513, + "minimum_updater_version": 2, + "artifacts": [ + { + "artifact_id": "71b9503b-d8c8-5995-a2f7-ccb02de28bad", + "bytes": 31413527, + "role": "agent", + "sha256": "f30ffac8b9f674c4933d50645bf93f6ee89442608ff73f597cedef3a42172292" + }, + { + "artifact_id": "05d3e340-ce80-580d-a1d7-b73a51c80e8d", + "bytes": 27017145, + "role": "helper", + "sha256": "eeb81736a3ddf297230d808b81f4fbf29f5ebe29723fc298455746f3e4b8f2b7" + } + ] + }, + "bootstrap_worker_after_publication": { + "sha256": "de75510b9b2971658dcadd197364c4135b629448bd6f47bf187033c189e349f7", + "bytes": 27024082 + }, + "readback": { + "checked_at_utc": "2026-11-17T15:48:51.062035+00:00", + "management_api": "GET /api/v1/tenants/{tenant}/agent-releases", + "checks": [ + "API reported a valid signature and validity period", + "Decoded envelope matches returned manifest", + "Manifest SHA-256 matches signed payload bytes", + "Agent and helper sizes and SHA-256 match immutable tenant objects", + "Bootstrap worker bytes and SHA-256 match protected tenant pin" + ] + } + }, + "isolated_regression": { + "command": "python3 tests/release_bootstrap_gateway.py --server-binary ", + "setup": "Temporary PostgreSQL 17.6, all 25 migrations applied by a NOSUPERUSER NOBYPASSRLS owner, fresh loopback TLS endpoint", + "passed": [ + "Worker upload through the management API with a worker-only build receipt", + "Missing worker object and stale predecessor rejected", + "Idempotent worker rotation preserves existing release records, envelopes and signature status", + "In-flight enrollment downloads the previous pin; default worker download and unknown-hash rejection verified", + "Second tenant downloads its original default worker and rejects another tenant’s new digest", + "Incomplete release uploads preserve previous release; completed retry publishes the new release", + "Invalid or consumed enrollment token denied; device-trust endpoint requires mTLS" + ] + } +} diff --git a/docs/handover.md b/docs/handover.md index b227401..80c4015 100644 --- a/docs/handover.md +++ b/docs/handover.md @@ -2,9 +2,9 @@ **Der nächste Auftrag steht im [Umsetzungsplan](mvp-completion-plan.md).** Er enthält den letzten Betriebsbefund je Nutzeranforderung und die Reihenfolge für die nächste Lieferung. [Entwicklungsbefehle](development.md) und [Zugänge](operations-access.md) beschreiben den Arbeitsweg. -**Pausenstand am 17. November, 16:36 Uhr MEZ.** API und Gateway laufen mit Revision `95aa707` und Datenbankschema 25. Die Arbeitsrevision für den nächsten Windows-Build liegt auf `codex/mvp-pull-library` bei `863dcb0`. Der ausgecheckte Arbeitsbaum auf `main` enthält zusätzlich die unfertige Worker-Veröffentlichung und den Windows-Wartungsoperator. Bereits angestoßene Builds von Server und Windows-Client sind von der Aktivierung getrennt. Die nächste Serverrevision und Windows E wurden bis zur Pause nicht aktiviert. +**Fortgesetzt am 17. November, 16:45 Uhr MEZ.** API und Gateway laufen mit Revision `a799272` und Datenbankschema 25. Der abgegrenzte Integrationsstand liegt auf `codex/mvp-pull-library`. Der ausgecheckte Arbeitsbaum auf `main` enthält zusätzlich ältere, noch gesondert zu prüfende Arbeiten. -**Bei Wiederaufnahme zuerst:** Auf dem Windows-Testgerät `858a27db…` ausschließlich den geprüften stabilen Updater `de75510b…` über den direkten Entwicklungsweg übernehmen. Für diesen wiederkehrenden Schritt den vorbereiteten Ablauf als Repo-Befehl sichern. Dann den Release-Dienst starten und die automatische Aktivierung des bereits veröffentlichten `0.1.3` mit gleicher Identität, Prozesshash und neuem Heartbeat prüfen. Der laufende LocalService-Agent meldet `0.1.2`, sein Skriptversuch `7b45ce5d…` ist einmal erfolgreich beendet. Der alte Updater `333cf84c…` ist gestoppt. Die signierten Dateien für `0.1.3` sind geladen, lokal besteht kein offener Umschaltvorgang. Erst danach den Bootstrap-Pin für weitere Installationen nach isoliertem Rotationstest umstellen. Der gesonderte SYSTEM-Wartungstest und der zeitlich begrenzte Policy-Controller sind offen. Linux meldete um 15:36 UTC `0.1.0-mvp.2` mit bereitem Sync. [Windows-Beleg](evidence/windows-https-release-20261117.json) · [Linux-Beleg](evidence/linux-public-installer-update-20261117.json) +Der Windows-Agent hat um 15:45:22 UTC nach der gezielten Workerreparatur selbstständig `0.1.3` aktiviert. Beide Dienste laufen, Sync ist bereit, die Geräteidentität `858a27db…` blieb gleich und der Prozesshash stimmt mit dem signierten Release überein. Der zuvor unter `0.1.2` ausgeführte Bibliotheksauftrag ist genau einmal erfolgreich abgeschlossen. Der stabile Prüfer `de75510b…` ist außerdem für neue Installer im Entwicklungsmandanten veröffentlicht. Für die Wartungseinrichtung ist `0.1.4` vorbereitet. Die nächste Abnahme steht im [Lieferplan](mvp-completion-plan.md). [Windows-Beleg](evidence/windows-https-release-20261117.json) Die ausdrücklich zur Löschung benannte Entwicklungsanfrage ist entfernt. Beide registrierten Testgeräte laufen über HTTPS-Polling. Den Bereinigungs- und Journalnachweis sowie die aktiven Buildrevisionen im [Lieferplan](mvp-completion-plan.md) verwenden. Die [frühere Bestandsaufnahme](evidence/product-audit-20261117.json) zeigt den Zustand vor der Bereinigung.