131 lines
8.3 KiB
Markdown
131 lines
8.3 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).
|