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

197 lines
13 KiB
Markdown

# 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](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).
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.