Document the accepted MVP and retire superseded development plans
Rust development slice / linux (push) Failing after 14s
Rust development slice / linux (push) Failing after 14s
This commit is contained in:
@@ -1,196 +0,0 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user