7.3 KiB
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.
Erster tatsächlicher Windows-Unitlauf: vier Fälle bestanden, der fünfte endete
mit Exit101/Win32-Fehler33 beim rohen Dateiscan nach allen SQL-Prüfungen. Die
Testfixture hatte ihr Journal noch geöffnet und traf auf SQLite-WAL-/SHM-
Bytebereichssperren. Originalbeleg
f981a395f4eceb527ad8a8859cff3c69ba79e52421300968b057404742fa1d8c
bleibt fehlgeschlagen. Die Fixture schließt nun das Journal vor dem rohen
Restdateiscan; keine Fehler werden übergangen und kein Produktguard geändert.
Dieser Scan behauptet keinen Zugriff auf ein aktiv gesperrtes Windows-WAL.
Neue tatsächliche Linux-/Windowsläufe dieses Testdeltas bleiben gesondert
nachzuweisen; der erste Viererfolg ist keine vollständige Windowsabnahme.
Die Dateiflags folgen CreateFileW und FlushFileBuffers; der öffentliche Selektor übernimmt den vorhandenen SQLite-WAL/FULL-Vertrag.