8.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.
Die portable Logik ist nativ auf Linux und Windows geprüft. Dies ist keine
Rotation der permanenten Windowsidentität und keine native
Windows-Renewal-/Datei-I/O-Abnahme.
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.
Der erste Viererfolg ist keine vollständige Windowsabnahme.
Das enge Testdelta ist anschließend tatsächlich zuerst auf Cloud-Linux als
UID65534 bestanden: fünf PASS, 18 andere gefiltert, keine Skips oder Fehler;
Fall bc2158ce-d500-4c64-8f17-e12527559f5b, Quittung-SHA256
1736a19a75d49eca91062e4e7adb28732f254279b64003474efcd6201ffa08ac.
Linux-Binary-SHA256
1f9482ce78b6690e6bfbadecc5df61d5157620fce5302c094364cc8c371d1093.
Danach auf Windows11 AMD64 im Entwicklungsbenutzerprozess: dieselben fünf
PASS, 44 andere gefiltert, keine Skips oder Fehler; Fall
01d26081-895f-4dea-8eb0-7c4defed1d27, Quittung-SHA256
64e960c2eb0b755b376028d923c6fdebbc11d5f96534103452f865ccf51a4fc0.
Windows-Binary-SHA256
951a0ddad1225752d8817c15234f74926f1e216c1ca22e1aee8ba0a5e7f97e60.
Beide Nachprüfungen führte der Orchestrator aus. Der Produktcode blieb beim
Fixturefix unverändert. Die Windowsfälle verwenden synthetische
In-memory-KeyFiles: kein LocalService-/ProtectedKeyFiles-Nachweis, kein echter
Renewal-HTTP-Aufruf und keine permanente Zertifikats-, Dienst- oder
Jobänderung. Die oben benannten Runtimegates bleiben offen.
Die Dateiflags folgen CreateFileW und FlushFileBuffers; der öffentliche Selektor übernimmt den vorhandenen SQLite-WAL/FULL-Vertrag.