Add crash-safe passive Windows certificate renewal
Rust development slice / linux (push) Failing after 6s

This commit is contained in:
2026-11-15 13:54:59 +01:00
parent 17a33e7823
commit 0b1f582998
9 changed files with 914 additions and 20 deletions
+17
View File
@@ -1,5 +1,22 @@
# Tatsächlicher Implementierungsstand
## Passiver Windows-Zertifikatspfad — Quellenstand 2026-11-15
Eigener RotationStore mit geschützten CreateNew-Keydateien und atomarer
öffentlicher CSR-/Zertifikats-/Versionswahl im bestehenden SQLite-Journal.
Pending wird vor dem Transport-Hello wiederaufgenommen; kein Schlüssel im
Telemetrie-WAL, kein automatisches Reenrollment oder Legacyfallback nach Wechsel.
Automatische Erneuerung ausschließlich bei `enable_jobs=false`; keine neue
Job-/Helperfähigkeit. [Vertrag und Abnahmegrenzen](windows-certificate-renewal.md).
Lokal Linux23/23Libtests ohne Filter, GNU-Windows-Alltargetscheck mit
`system-helper`, Clippy beider Targets mit `-D warnings` und Workspacefmt
bestanden. Anschließend dieselben fünf portablen Rotationsfälle tatsächlich auf
Cloud-Linux als UID65534 bestanden (5PASS/18andere gefiltert); Ergebnisquittung
`7e6cab5915ec00a9b1392c1f15ddb13fe9ac6dd3b8e007b82e1dc914cb0507e1`.
Kein installierter Dienst oder Gerätezertifikat verändert; echte
Windows-Renewal-/LocalService-Dateiabnahme bleibt offen.
## Windowsfortsetzung: Nichtstart-Kern nativ qualifiziert — 2026-11-14
Der zusätzliche enge deny-only Nichtstart-Kern ist implementiert und mit
+101
View File
@@ -0,0 +1,101 @@
# Windows: Geräte-TLS bei passiver Telemetrie erneuern
Quellenstand 2026-11-15, Spezifikation 1.23. Der Windowsdienst verwendet jetzt
einen eigenen `RotationStore` und den vorhandenen gemeinsamen mTLS-Transport.
Dies ist Quellen-/lokaler Prüfstand, keine Rotation der permanenten
Windowsidentität und keine native Windowsabnahme.
Der tatsächliche Serverendpoint `POST /agent/v1/certificates/renew` verlangt
eine noch gültige, registrierte mTLS-Identität. Er prüft die signierte P-256-CSR,
stellt ein neues Gerätezertifikat für dieselbe Agent-ID aus, erhöht die
Verbindungsgeneration und akzeptiert den vorherigen Fingerprint 300 Sekunden.
Die exakten CSR-Bytes sind der serverseitige Wiederholungsschlüssel; eine
Wiederholung innerhalb des zulässigen alten Identitätsfensters liefert dasselbe
bereits gespeicherte Zertifikat. Weder Reenrollment noch Widerruf sind enthalten.
Der Client prüft alle 30 Sekunden, ob das Zertifikat mindestens 20 Tage alt ist
oder höchstens zehn Tage Restgültigkeit hat. Automatische Erneuerung läuft in
diesem Schnitt ausschließlich bei `enable_jobs=false`. Ein dauerhaftes Pending
wird nach Prozessneustart und vor einem neuen Transport-Hello wiederaufgenommen,
ohne zuvor einen erfolgreichen WSS-/HTTPS-Kanal vorauszusetzen. Während eines
Pending ist die Umschaltung auf Jobbetrieb verweigert. Nach erfolgreichem Commit
baut der Client eine neue Verbindung auf; Heartbeats und unbestätigte
Inventarbytes behalten den bestehenden Journalvertrag.
Die bisherigen Dateien `identity.json`, `device.pem` und `device.key` werden
nicht ersetzt. Nur vor der ersten Versionswahl wird das bestehende Paar als
Initialversion aufgenommen. Jeder neue private Schlüssel entsteht mit
`CreateNew` als `device-<UUID>.key` im bestehenden geschützten State. Das
exklusive Dateihandle verweigert gleichzeitiges Ersetzen; Reparsepoints und
Hardlinks werden abgewiesen. Die bestehende SYSTEM-/Administratoren-/Service-
SID-DACL wird vor dem ersten Schlüsselbyte geprüft, anschließend werden die
Dateibytes mit Write-through und `sync_all` geflusht. Das gehaltene
Verzeichnishandle verweigert Löschen/Umbenennen seines Parents. Keine neue
ACL-Freigabe oder allgemeine LocalService-Schreibfreigabe wird hinzugefügt.
Im vorhandenen exklusiv gesperrten Telemetriejournal stehen ausschließlich
öffentliche CSR-/Zertifikatsbytes und UUID-/Identitätsselektoren; private
Schlüssel gelangen weder in SQLite noch WAL. Die neue Schlüsseldatei ist vor
Pending-Commit vollständig geschrieben. Vor der Netzwerkanfrage committen
Versions-ID und exakte CSR gemeinsam. Die Antwort wird gegen die konfigurierte
CA-Kette, ClientAuth-Verwendung, Gültigkeit, genau einen passenden Geräte-CN,
Nicht-CA-Leaf und tatsächlich passende private Schlüsselbytes geprüft.
Zertifikat und aktiver Selektor wechseln in einer einzigen SQLite-Transaktion
unter dem vorhandenen WAL-/`synchronous=FULL`-Vertrag.
Ein Schreib-, Antwort-, Validierungs- oder Commitfehler lässt den bisherigen
Selektor erhalten. Unselektierte Schlüsseldateien nach Abbruch werden nicht
adoptiert oder automatisch gelöscht. Nach Auswahl einer neuen Version gibt es
keinen automatischen Rückfall auf die Initialversion, auch nicht bei fehlender
Datei oder Ablauf. Alle vorhandenen mTLS-Verbraucher des Windowsagenten
(WSS/HTTPS, Zeitabruf und gegebenenfalls MSI-Download) verwenden dieselbe
Version. Kein Helper-Signierpin, Zeitpin, Geräte-/Enrollmentgeneration oder
Jobrecht wird rotiert oder freigeschaltet.
Antwortverlust länger als die serverseitigen 300 Sekunden, abgelaufene oder
widerrufene Zertifikate und beschädigter State benötigen eine ausdrücklich
abgestimmte Wiederherstellung. Der Client erfindet kein neues Identitätsfenster.
Die Crashsicherheit beruht auf der vorhandenen SQLite-/Dateisystem- und
Datenträger-Durabilität: keine Behauptung unabhängiger Stromausfalltests oder
Schutz gegen Administratoren, die Schlüssel und State verändern können.
Lokale Prüfungen und noch offene native Gates werden im Implementierungsstand
getrennt festgehalten. Native LocalService-DACL-/Flush-/Reparse-/Hardlinktests,
Windows-Renewal mit tatsächlichem Server, Antwortverlust, Prozessabbruch,
Transportwechsel und Negativabnahmen bleiben vor einer Runtimefreigabe offen.
Die permanente Identität darf hierfür nicht ohne weitere Abstimmung rotiert
oder widerrufen werden. Keine RMM-Jobs oder Operatorenserie sind Bestandteil.
Tatsächlich lokal ausgeführt: `cargo test --offline --locked -p
rmm-agent-windows --lib` (23/23, keine Filter); `cargo check --offline --locked
-p rmm-agent-windows --target x86_64-pc-windows-gnu --all-targets --features
system-helper`; Clippy für beide Targets mit `-D warnings`,
`cargo fmt --all --check` und tatsächlicher GNU-Link beider Windowsbinaries mit
`system-helper` bestanden. Das Windows-Lib-Testbinary wurde mit `--no-run`
gebaut (SHA256 `60e053e6e9cc7fb43de73fe05d50f7934a890e2f5de3c330175af4eba5ed50c5`),
hier nicht ausgeführt. Der erste Crosscheck in der unvollständigen
Builderimage scheiterte an fehlendem WIDL; der vorhandene vollständige
WIDL-/clang-Builder bestand danach, ohne Buildguardänderung.
Der Orchestrator führte anschließend dasselbe Linux-Testbinary tatsächlich
auf Cloud-Linux als UID65534 aus: genau fünf `certificate_rotation::tests::*`
bestanden, 18 andere Tests bewusst gefiltert, keine Skips oder Fehler.
Binary-SHA256 `33d6e1f0c145e90247e123fba00bad6a972bad6aa8d1f84ffcfa801a97787890`;
eigene geschützte Quittung
`devstate/cert-renewal-linux/d61686f2-7829-4756-869e-a407667d1f97/result.json`,
SHA256 `7e6cab5915ec00a9b1392c1f15ddb13fe9ac6dd3b8e007b82e1dc914cb0507e1`.
Das ist ein nativer Linuxnachweis der portablen Logik mit synthetischen
In-memory-KeyFiles, kein Windows-DACL-/Dateiflush- oder echtes Renewal.
Keine permanente Identität oder Dienstkonfiguration wurde hierfür geändert.
Die fünf Fälle prüfen exakte CSR-Wiederverwendung nach Antwortverlust;
falsche Agent-ID, CA, Schlüssel, Verwendung und Ablauf bei erhaltener alter
Version; fehlenden neuen Key ohne Legacyfallback; manipuliertes Pending und
Enrollmentbindung; sowie echten SQLite-/WAL-Reopen mit fortbestehender Sequenz
und einen absichtlich verweigerten Selektorcommit, bei dem auch das zuvor im
selben SQL-Commit geschriebene Zertifikat zurückgerollt wird.
Die Dateiflags folgen [CreateFileW](https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-createfilew)
und [FlushFileBuffers](https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-flushfilebuffers);
der öffentliche Selektor übernimmt den vorhandenen
[SQLite-WAL/FULL-Vertrag](https://www.sqlite.org/pragma.html#pragma_synchronous).