Files
kevin_janssen 0b1f582998
Rust development slice / linux (push) Failing after 6s
Add crash-safe passive Windows certificate renewal
2026-11-15 13:54:59 +01:00

232 lines
15 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Windows-Client: erster nativer Entwicklungsstand
Stand 2026-11-13, Spezifikation 1.15. Windows-11-Gast und Notebook-Host sind
verschiedene Geräte. Auf dem Notebook laufen ausschließlich Entwicklungstools;
der Client verwendet den endgültigen Cloudserver `discovery.ease-technologies.de`.
Neuer Quellenstand 2026-11-15: [passive Zertifikatserneuerung](../../docs/windows-certificate-renewal.md)
mit geschützter Keydatei und atomarer Versionswahl ist implementiert; native
Windows-Renewal-/Abbruch-/DACLabnahme und Freigabe der permanenten Identität
bleiben offen. Frühere Transportabnahmen darunter bleiben historische Belege.
## Aktueller Dienst dauerhaft auf Auto — 2026-11-13
Nach dem bestandenen Fallbacktest wurde die bestehende VM im separaten Fall
`422562e8-18eb-4865-977d-ab2af65f510b` dauerhaft auf `transport=auto` gestellt.
WSS bleibt bevorzugt; zwei frische WSS-Heartbeats und ein konkretes Inventar-ACK
sind unter dem tatsächlichen LocalService (`S-1-5-19`) nativ nachgewiesen.
Binary, Geräteidentität, CA, Zertifikat, Schlüssel, ACLs und Telemetriehistorie
blieben erhalten. Beide Server-Testhooks bleiben deaktiviert; Serverkonfiguration
und Rootpolicy wurden bei dieser Umstellung nicht verändert. Windows bleibt bei
0 Jobs/Outbox/Grants/ungeklärten Wirkungen, Linux unverändert bei 30/30/26/0.
Der verifizierte geschützte Beleg liegt unter
`devstate/windows-client/auto-default/422562e8-18eb-4865-977d-ab2af65f510b/result.json`.
`devstate/windows-client/current-transport.json` bindet ihn per Hash und hält den
aktuellen Transport getrennt von historischen Abnahmen fest. Originalkonfiguration
und ACLs bleiben versioniert für eine ausdrückliche Wiederherstellung erhalten.
Die Installerquelle verwendet ebenfalls `auto`; eine frische Installation wurde
damit nicht ausgeführt. Fünf gezielte lokale Schutztests sowie Parserprüfungen
bestanden. Es wurden keine Windows-Jobs oder Reboots ausgeführt.
## Automatischer WSS→HTTPS-Fallback nativ bestanden — 2026-11-13
Eigener Fall `2ff2e1aa-0037-4831-9bc2-31218bf1461c` auf derselben bestehenden
Windows-Identität unter LocalService. Nur der eigene Agenttransport wurde
versioniert auf `auto` gestellt. Zunächst zwei frische WSS-Heartbeats;
dann exakt gerätegebundene, zehn Minuten gültige dev/test-Störung.
Zwei tatsächliche mTLS-authentisierte HTTP503 bei WSS, mit unterschiedlichen
Handshake-IDs und den festen Slots1/2, Zertifikatsfingerprint und Config-Hash.
Der Agent wechselte selbst zu HTTPS; zwei frische HTTPS-Heartbeats und konkreter
Inventar-ACK nach beiden Verweigerungen tatsächlich gespeichert.
Gleiche Agent-/Asset-/Enrollment-/Zuordnungsversion und Dateien/ACLs, monotone
Sequenz, TenantB weiter verweigert. Kein neuer RMM-Job: Windows vor/nach
0Jobs/0Outbox/0Grants/0offen; Linux unverändert30/30/26/0. Zentrale Rootpolicy
unverändert. Beide realen Serverrollen danach mit Faultflagfalse und ohne
konfigurierten Fault-Dateipfad; exakte ursprüngliche WSS-Konfigurationsbytes und
ACLs auf Windows restauriert, wieder zwei frische WSS-Heartbeats/ACK0.
Dies ist keine Behauptung eines automatischen HTTPS→WSS-Switchbacks: Rückkehr
folgte aus der ausdrücklichen operativen Wiederherstellung der Konfiguration.
Ausgeführt: `python3 deploy/windows/auto_transport_acceptance.py start
--https-case 3c60e1a8-7ab7-4720-8b1a-f89f4f0d7458`.
Sechs gezielte lokale Guards ergänzen den nativen Nachweis; kein neuer
Clientbuild und keine Windows-Syncbereitschaft erfunden. Geschützt:
`devstate/windows-client/auto-transport/2ff2e1aa-0037-4831-9bc2-31218bf1461c/result.json`,
verifiziert. Am Ende dieses Testfalls lief der Dienst wieder mit ursprünglichem
WSS. Die anschließende dauerhafte Auto-Umstellung ist oben separat dokumentiert.
## TLS-Negativfälle auf Windows nativ bestanden — 2026-11-13
Feste getrennte Fixture `7b190a5c-c928-4348-bd0d-c9698dad5417`, Schlüssel auf
Windows erzeugt und dort behalten. Nur öffentliche CSR zum bestehenden
Cloudsignierer, ausschließlich öffentliche CA-/Clientzertifikate zurück.
Unregistrierte gültige Kontrolle vor und nach den Negativfällen: tatsächliches
HTTP401 nach erfolgreichem TLS. Falsche CA: `TLS_UNKNOWN_ISSUER`; falscher
Servername: `TLS_SERVER_NAME_MISMATCH`; abgelaufenes Clientzertifikat:
`TLS_PEER_CERTIFICATE_EXPIRED`, jeweils ohne HTTP-Antwort. Alle fünf nativen
Probeprozesse mit dem gemeinsamen `https_channel::mtls_client` bestanden.
Dies sind ausdrücklich Admin-TLS-Proben, keine LocalService- oder
Rotationsabnahme. Der tatsächliche LocalService-HTTPS-Pfad ist separat unten
nachgewiesen. Permanenter Dienst samt PID/Startkonto, Identität, öffentliche
Zertifikatsdateien und private Schlüsseldateimetadaten vor/nach identisch.
Keine Dienstoperation, Registrierung, Jobs, Uhränderung oder TLS-Ausnahme.
Erster Lauf blieb bei unbekannt klassifiziertem CA-Fehler sicher verweigert.
Typinformation wurde in verschachtelten io::Error-Quellen übersprungen;
gezielter get_ref-Fix samt Test erkennt den echten Rustlsfehler, ohne Timeout,
Reset oder Fehlertexte als Zertifikatsablehnung zu werten. Ein Retest wurde
vor TLS durch einen Bootstrap-Witness-Timeout unterbrochen. Kurzer begrenzter
Witness und erneute Prüfung derselben unveränderten öffentlichen Fixtures
bestanden, ohne neue CSR/Signierung/Keyerzeugung. Alte Ergebnisse bleiben erhalten.
Verifiziertes Ergebnis unter
`devstate/windows-client/tls-negative/7b190a5c-c928-4348-bd0d-c9698dad5417/typed-retest-6dd51cc0-deb5-4020-afee-58dbb716cdbb/result.json`.
Qualifizierte Probe SHA256
`33eb56500908a88e3ff30cc1e61f9416e38d94fbf27633ac6dfaf9903cd4ef1b`:
gelockter Windows-GNU-Releasebuild, Clippy mit-Dwarnings, gezielter verschachtelter
TLS-Fehlertest und Python-/PowerShell-Parserprüfungen bestanden.
Ausgeführt: `python3 deploy/windows/tls_acceptance.py --execute-native-tls-negative
--artifact devstate/windows-client/WindowsTlsProbe.exe --resume-case
7b190a5c-c928-4348-bd0d-c9698dad5417`.
## Native HTTPS-Abnahme zusätzlich bestanden — 2026-11-13
Der bestehende LocalService-Agent wurde im festen Fall
`3c60e1a8-7ab7-4720-8b1a-f89f4f0d7458` administrativ und versioniert von WSS auf
explizites HTTPS umgestellt. Keine neue Identität, kein Enrollment, kein RMM-Job.
Tatsächlicher serverseitiger Transport `https`, zwei frische Heartbeats um
22:21:14.183598 und22:21:45.234313 UTC. Der native Readonly-Journalbeleg bestätigt
Integrität, gleiche Identität, monotone Sequenz935→941 und0 ausstehende
Inventarereignisse nach konkretem ACK. Tatsächlicher Prozessowner `S-1-5-19`
(LocalService); unverändertes qualifiziertes Programm, CA, Zertifikat, privater
Geräteschlüssel und deren ACLs. Private Schlüssel blieben auf der VM.
Anschließend exakt ursprüngliche WSS-Konfigurationsbytes und ACLs wiederhergestellt,
zweimal frischer WSS-Kontakt sowie abgeschlossener Inventar-ACK nachgewiesen.
Beide fremden Tenantzugriffe verweigert; vorher/nachher0Jobs/0Outbox/0Grants/
0offene Versuche. `result.json` ist verifiziert. Geschützte Belege:
`devstate/windows-client/transport/3c60e1a8-7ab7-4720-8b1a-f89f4f0d7458/`.
Ausgeführt: `python3 deploy/windows/transport_acceptance.py start`.
Der Runner verwendet einen per Hash und SFTP gepinnten Bootstrap-PowerShellcode;
prozessbezogenes RemoteSigned ändert keine Maschinen-/Gruppenrichtlinie und
keine RMM-Jobausführung. Sieben gezielte lokale Runner-Guards und drei
PowerShell-Parserprüfungen bestanden; kein neuer Clientbuild für diese Abnahme.
TLS-Negativfälle und automatischer Fallback sind oben separat nativ abgenommen.
PowerShell-Jobs bleiben bis zu [ihren Voraussetzungen](../../docs/windows-job-boundary.md)
gesperrt. Die folgenden Erstnachweise bleiben historisch erhalten.
## Tatsächlich nachgewiesen
`rmm-agent-windows` als eigene Plattform-Crate mit gemeinsamen Domain-/Protobuf-
Verträgen und direkt wiederverwendeten WSS-/HTTPS-/TLS-Modulen des Linux-Agenten.
Isolierter Docker-Crossbuild mit Rust 1.99.1 für `x86_64-pc-windows-gnu`:
Debug und Release erfolgreich; Windows-target Clippy über alle Targets mit
`-D warnings` erfolgreich. Zwei gezielte Domain-Tests prüfen die unveränderte
Linux-Validierung, Windows ohne erfundene Inodes und abgewiesene Plattformmischung.
Das sind ergänzende lokale Prüfungen, keine nativen Windows-Dienstnachweise.
Releaseartefakt SHA256
`31e360e50b177b4d5729d24e436d4f25aeed7b1a7bd35f2a129841ba1abffd37`
auf der tatsächlichen Windows-11-Pro-VM (Version 10.0.26300, x64) gestartet:
`--native-probe` erfolgreich. Hostname und Systemvolume tatsächlich über Win32
lesbar; Bootkennung aus `Win32_OperatingSystem.LastBootUpTime` abgeleitet statt
bei jedem Agentstart neu erzeugt. Inodes ausdrücklich `null`/nicht anwendbar.
Keine Schlüssel oder realen Hostnamen in der veröffentlichten Probeausgabe.
Binärtransfer über bestehendes, hostkeygeprüftes SFTP mit SHA256-Nachprüfung.
Große PowerShell-Console-JSON-Eingaben waren als Bootstraptransport ungeeignet
(Timeout/Console-Reader-Ausnahme); deshalb nur kleine zeilenbegrenzte Metadaten
über stdin. SSH-/Hostkeyprüfung und Reverse-Portgrenzen bleiben unverändert.
Artefaktverzeichnisse werden nach Hash neu angelegt, keine vorhandene Identität
oder Historie gelöscht. Private Evidenz: `devstate/windows-client/`.
## Nativer Dienst, Inventar und verbleibender Umfang
- Nativer SCM-Dienstlebenszyklus als `LocalService` mit eigenem
Service-SID-Zugriff auf Zustand und ausschließlich lesbarem Programm/Config.
- Windows prüft Owner/DACL und verweigert Reparse-Points/breite ACLs. Geräteschlüssel
werden nur auf Windows erzeugt; Enrollment über CA- und namensgeprüftes TLS,
danach mTLS. Ein verlorener Enrollmentnachweis löst keinen Identitätsreset aus.
- SQLite mit FULL-Synchronisierung, Prozesssperre, monotoner persistenter Sequenz,
konkretem ACK und begrenzter Telemetriequeue. Kein Löschen für Platzgewinn.
- Separate `windows.base`-Beobachtungen mit Erhebungszeit/Quelle/Qualität; Server
bindet den Scope an die authentisierte Verbindung und deren Capability.
Geräte-API zeigt die gespeicherte Quelle statt eines festen Linuxlabels.
- Ausschließlich `windows.base/1` und `heartbeat/1` werden angeboten.
**Kein Jobexecutor, keine PowerShell-Jobfähigkeit, kein privilegierter Helper.**
Angebote/Startgrants werden verweigert. Es gibt keine Genehmigungsabkürzung.
Tatsächlich installiert und gestartet: nativer SCM-Dienst mit eigenem Service-SID
unter `NT AUTHORITY\LocalService`; tatsächlicher Prozessowner `S-1-5-19`, nicht
Administrator/SYSTEM. Eigener Geräteschlüssel auf Windows erzeugt, einmaliges
Enrollment erfolgreich und Tokenkopie entfernt; mTLS-Hello und frischer Heartbeat
serverseitig bestätigt. Der erste `.ps1`-Aufruf wurde durch die lokale
Ausführungsrichtlinie vor jeder Installerwirkung verweigert. Verzeichnis, Dienst
und Identität waren nachweislich nicht angelegt; erst danach kontrollierte
Fortsetzung mit explizit **prozessbezogenem** `RemoteSigned` wie beim ursprünglichen
Bootstrap. Keine Änderung der Maschinen-/Gruppenrichtlinie, keine Jobausnahme.
Native Rust-Testprogramme direkt über den gepinnten SSH-Zugang ausgeführt:
**3 Transporttests + 3 Bibliothekstests + 1 ACL-Integrationstest bestanden**. Diese prüfen Namens-/URL-
Validierung und sichere Fallbackauswahl, echte Windows-Inventardaten, zwei
unabhängige stabile Bootabfragen sowie SQLite-Reopen, monotone Sequenz,
Prozesssperre, gezielten ACK und Identitätsbindung. Der zusätzliche native ACL-Test
weist korrekte ACLs nach und verweigert breite ACLs, NULL-DACLs, falschen Pfadtyp
und Reparse-Points an ausschließlich neu erzeugten nichtgeheimen Tempfixtures. PowerShell-Pipelinewrapper
warteten bei nativen Testprogrammen; direkte native Ausführung lieferte Exit 0.
Der tatsächliche Online-Lauf fand eine weitere echte Grenze: Migration 0001
beschränkte `observations.source_id` auf `linux.base`. Daher bisher Heartbeats,
aber kein gespeichertes Windowsinventar. Additive Migration 0013 erweitert nur
diesen CHECK auf die beiden validierten Basisscopes. Echter isolierter PostgreSQL-
Test der Migrationen 1–13 bestanden: alte Linuxzeile bytegleich, Windows erlaubt,
beliebiger Scope verweigert, RLS bei fremdem/fehlendem Kontext und zusammengesetzter
Geräte-FK erhalten, keine Jobs/Outbox/Grants. Cloudmigration 0013 anschließend tatsächlich erfolgreich. Der ursprüngliche
Windows-Journaleintrag wurde ohne Neuerhebung/Identitätsreset erneut zugestellt
und gespeichert: ursprüngliches `observed_at` bleibt erhalten, `received_at` ist
separat. Geräte-API/MCP melden `source_id=windows.base`, korrektes Windowsinventar
und Inodes `null`; zwei verschiedene frische Heartbeats und `online` belegt.
Mandant B wurde sowohl für den A-Kontext als auch für seine eigene Mandantensicht
mit der fremden Asset-ID abgewiesen. Gerätespezifisch **0 Jobs / 0 Outbox /
0 Startgrants / 0 offene Versuche**. Keine WebUI-Genehmigung ausgeführt, weil diese
Strecke ausschließlich passive Standardbeobachtungen verarbeitet.
Dieser erste Entwicklungsbuild ist **unsigniert**. Kein produktiver signierter
Installer/MSVC-Supportnachweis, keine Zertifikatsrotations-/Widerrufs-/Proxy- oder
Windows-Paket-/Dienstaktionsabnahme. Der erste native Onlinenachweis verwendete WSS. Explizites HTTPS und automatischer Fallback sind inzwischen oben separat nativ
abgenommen. Die passive SCM-/Enrollment-/mTLS-/Inventar-/Mandantentrennungsstrecke sowie
die oben benannten nativen Tests sind nun tatsächlich getrennt belegt.
Dies ist keine vollständige Windows-/Linux-MVP-Abnahme.
## Ausgeführte und geplante Befehle
Tatsächlich ausgeführt: Docker-Build und gezielte Rust-Prüfungen oben sowie
`python3 deploy/windows/client_bootstrap.py upload-agent --artifact <Release-EXE>`
und `python3 deploy/windows/client_bootstrap.py probe` gegen ausschließlich den
Windows-Gast. Keine RMM-Jobs oder Genehmigungen wurden dabei erzeugt.
Zusätzlich tatsächlich ausgeführt: native `test-lib`/`test-bin`/`test-acl`, Installer nach
nachgewiesenem Nichtstart mit `install-after-nonstart` und die oben benannte
PostgreSQL-Migrationsprüfung sowie `passive-acceptance` gegen den Cloudserver
mit gespeichertem Inventar, zwei Heartbeats, Tenant-B-Verweigerung und Null-Jobgate.
Installation ist create-only; bei Teilfehlern Zustand inspizieren und erhalten,
nicht blind neu enrollen oder den Bootstrap wiederholen.
Native ergänzende Receiptprüfung: das separate Entwicklungstool
`examples/passive_state.rs` öffnete ausschließlich die vorhandene Windows-SQLite
im Read-only-Modus. Integrität `ok`, feste Geräteidentität identisch, Sequenz 59,
**0 ausstehende Inventarereignisse**: der konkrete Server-ACK wurde lokal verbucht.
Keine neue Erhebung, kein Journalreset und kein neues Enrollment für diesen Nachweis.
Bekannte Darstellungsgrenze des ersten Collectors: `os` enthält den tatsächlich
ausgelesenen Registry-Produktnamen samt DisplayVersion/Build. Auf dieser Windows-
11-Pro-VM lautet der historische Registrywert noch `Windows 10 Pro`, mit
`DisplayVersion=26H2; Build=26300`. Die unabhängige native CIM-Probe bestätigt
Windows 11 Pro. Der Registrywert wird nicht stillschweigend als Marketingversion
uminterpretiert; eine einheitliche, quellenbewusste OS-Bezeichnung ist noch offen.
Die aktuelle Capability bleibt deshalb ausdrücklich partielles Basisinventar.