Files
rust-discovery/docs/windows-certificate-renewal.md
T
2026-11-15 14:33:52 +01:00

13 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.

Historischer Vorbereitungsstand45b5337: eine weitere enge native Datei-I/O-Unit war vorbereitet, nicht ausgeführt: certificate_rotation::tests::protected_key_files_create_new_reopen_acl_and_hardlink_guards. Sie steckt im vorhandenen Lib-Testbinary; kein zusätzliches Diagnostikbinary, keine Tokenübernahme, Impersonation, Dienste oder Accounts. Wegen ihrer expliziten Administrator-/Dateisystemwirkung ist sie im Defaultlauf als ignored markiert und muss separat mit --ignored --exact ausgewählt werden. Dies ist ein offenes natives Gate und wird nicht als bestandener Test gezählt.

Die Unit verlangt bereits vorhandene Administratorrechte und die vorhandene Agent-Service-SID, erstellt ausschließlich einen eigenen zufälligen Unterordner im temporären Verzeichnis mit expliziter SYSTEM-/Administratoren-/Agent-SID-DACL und nutzt darin den unveränderten ProtectedKeyFiles-Produktpfad. Sie prüft CreateNew/Flush, die wirkliche geerbte DACL, bytegleiche Wiederöffnung samt öffentlichem P-256-Keyhash, verweigertes Überschreiben, verweigertes Umbenennen des gehaltenen Verzeichnisses und Hardlinkablehnung. Eine zu breite DACL wird nur an einer separaten leeren eigenen Verzeichnisfixture geprüft. Private Schlüsselbytes stehen weder in stdout noch in Assert-Debugausgaben. Bei Erfolg entfernt sie ausschließlich ihre eigenen Fixturedateien und das leere eigene Verzeichnis; ein Fehler lässt den isolierten Fall erhalten.

Das belegt nach einem zukünftigen tatsächlichen Lauf nur Datei-I/O des bereits vorhandenen Administratorprincipals und die geprüfte Service-SID-DACL. Die produktive Ownerprüfung bleibt vollständig bestehen; ein unzulässiger Dateieigentümer wird weiterhin verweigert. Tatsächliche LocalService-Erzeugung, Wiederöffnung und erneutes Öffnen nach Prozessabbruch sind damit weiterhin nicht nachgewiesen. Es wurde kein konkreter Produkt-I/O-Fehler nachgewiesen, also kein Produktguard dafür verändert. Der Controller-/Dienstupgradeumfang und die permanente Identität bleiben unberührt.

Für diesen vorbereiteten Testschnitt tatsächlich lokal: Linux23/23 ohne Filter, Windows-GNU-Lib --no-run, Windows-Alltargets-Clippy mit system-helper/-D warnings und Workspacefmt bestanden. Noch kein neuer Zielaufruf. Das vorbereitete Windows-Testbinary hat SHA256 cd385c3b8696303220d8e601768d70ac96a6e4187a14cbac9d511162a57eee5a.

Nach dem ausdrücklichen SSH-Readback-Signal des Orchestrators wurde genau diese Unit tatsächlich einmal auf der Windows-VM ausgeführt. Eigener Fall e0590d96-7e62-4bdc-a0b1-f53e8a9a9972, unverändertes Binary cd385c3b…, Aufruf --ignored --exact certificate_rotation::tests::protected_key_files_create_new_reopen_acl_and_hardlink_guards --test-threads=1. Ergebnis: ein PASS, null Fehler, null ignored, 49 andere gefiltert, Exit0, gemeldete Unitlaufzeit0.09s. Der vorhandene Administratorprincipal wurde im Test geprüft; keine Tokenübernahme oder Impersonation.

Damit sind der wirkliche geschützte Windows-KeyFiles-CreateNew-/Flush-/Reopen- Pfad, bytegleiche private Wiederöffnung, öffentlicher P-256-Keyhashvergleich, Nichtüberschreiben, breite leere DACL-Negativfixture, gehaltenes Verzeichnis und Hardlinkablehnung für diesen Principal bestanden. Die Unit entfernte ihren eigenen temporären Schlüssel, Hardlink und Testordner erfolgreich. Es gab keine Änderung an Client, SCM, Accounts, SSH-Zugang oder dauerhafter Identität. Stagingbinary und eigene öffentliche Ergebnisdateien bleiben geschützt im Bootstraparchiv.

Der private Aufrufwrapper gab das bereits auf der VM beständig gespeicherte Ergebnis zunächst als PowerShell-Tabelle aus; dadurch schlug ausschließlich das lokale JSON-Einlesen fehl. Es gab keinen zweiten Teststart. Ein anschließend streng lesender Aufruf übernahm nur die ursprüngliche eigene result.json. Geschützter lokaler Rohread: devstate/windows-keyfile-fixture/e0590d96-7e62-4bdc-a0b1-f53e8a9a9972/result-read.json, SHA256 68dd458a24c2455049b7799f57e30f1e858e323fa82c578e3b962f58282b5e49. Die separate lokale Acceptancequittung acceptance.json bindet Intent, Transfer, Start und diesen Originalread; SHA256 268e3146acfcab55022f9534509e74c80caf7b8ca246bcc5eb3c30e08cfd1383. Dies bleibt eine Administrator-Fixtureabnahme; tatsächliches LocalService-Keyfile-I/O, Prozessabbruch und echte Zertifikatserneuerung sind weiter offen. Keine bestehende Plattform-/Jobqualifikation wird damit erweitert.