Document the accepted MVP and retire superseded development plans
Rust development slice / linux (push) Failing after 14s

This commit is contained in:
2026-11-18 17:21:12 +01:00
parent f37b6dc4f7
commit 6963ad332c
188 changed files with 370 additions and 34933 deletions
-231
View File
@@ -1,231 +0,0 @@
# 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.
+22 -128
View File
@@ -1,144 +1,38 @@
# Windows-11-Entwicklungszugang
# Windows-Agent betreiben
**Historischer Erstbootstrap und Einrichtungsnachweise. Nicht erneut ausführen.**
Aktueller Einstieg für vorhandene Zugänge am 17. November 2026:
[Zugangsanleitung](../../docs/operations-access.md) und
[Übergabe](../../docs/handover.md).
Die Aussagen „noch kein Client“, frühere24-Stunden-Fristen und alte
Download-/Repairabläufe unten gelten nur für ihren jeweiligen historischen Stand.
Der permanente Entwicklungstransport ist eingerichtet, heute aber ohne aktiven
Server-Reverselistener; vorhandene Schlüssel/Identität erhalten.
Der offizielle Windows-x64-Kanal verwendet das GNU-Ziel `x86_64-pc-windows-gnu`. Der Dienst `RmmDiscoveryWindows` läuft als LocalService. Er meldet sich ausgehend per mTLS, liefert Inventar und führt genehmigte PowerShell-Skripte aus. Für Aufträge als SYSTEM verwendet er den pro Installation eingerichteten `RmmDiscoverySystemHelper`.
## Installation
Userentscheidung 2026-11-13 / Spezifikation 1.8: Windows darf parallel zur noch
offenen Linux-MVP-Abnahme entwickelt werden. Notebook-Host bleibt ohne Agent.
Dieser Bootstrap schafft SSH-Zugang zum Windows-Gast, keine RMM-Installation
und keine Ausnahme von der späteren WebUI-Jobgenehmigung.
1. In der WebUI den Kunden wählen und unter **Gerät aufnehmen** einen Einmalcode erzeugen. Auf der Windows-Maschine die 64-Bit-Windows-PowerShell 5.1 als Administrator öffnen.
2. Den angezeigten Windows-Befehlsblock für das GNU-Paket ausführen. Er lädt `/install/windows.ps1` per HTTPS und übergibt den Bootstrap-Ursprung. Den Code auf die Frage „One-time enrollment token“ eingeben.
3. Für administrative Skripte die Administratoroption im Aufnahmeformular wählen. Der zusätzliche Schalter `-EnableAdministratorScripts` richtet den SYSTEM-Helper mit Gerätebindung, lokalem Journal und signiertem Agent-/Helperpaar ein. Auf einem bereits aufgenommenen Gerät lässt sich derselbe Installer mit dem bisherigen Ursprung und diesem Schalter ausführen.
4. Im Gerätedetail den frischen Kontakt und die Agentversion prüfen. Für SYSTEM-Aufträge müssen der SYSTEM-Kontext gemeldet und die zentrale Geräteregel eingerichtet sein. Für MCP kommt das plattformspezifische Tokenrecht hinzu. [Installer](../../crates/server/src/bootstrap/install.ps1) · [MCP-Zugang](../../docs/public-access.md)
## Vorbereitet und tatsächlich geprüft
## Dienste und Selbstupdate
`python3 deploy/windows/prepare_dev_access.py` hat auf dem endgültigen Server
das separate Systemkonto `rmm-win-tunnel` und dessen SSH-Matchprofil angelegt.
`sshd -t` und effektive Benutzerkonfiguration bestanden; Root-SSH-Konfiguration
vor/nach identisch. Nur Remote-TCP-Forwarding auf `127.0.0.1:22240`, keine
Shell/SFTP/Sitzungen (`MaxSessions 0`), keine Local-/Streamlocal-/Agentforwards,
keine Passwortanmeldung. Noch kein Windows-Key hinterlegt, kein Windows-
Tunnel/Administrationszugang nachgewiesen. Keine neue öffentliche Portfreigabe.
`RmmDiscoveryReleasePull` prüft nach erfolgreichem Lauf regulär nach fünf Minuten erneut auf einen veröffentlichten Release. Er verifiziert Signatur, Plattform und Paketinhalt und stimmt den Wechsel mit laufenden Aufträgen ab. Ein neuer Release muss sich unter derselben Geräteidentität zurückmelden. Scheitert die Aktivierung, wählt der Updater den Vorgänger. Programmdateien liegen unter `%ProgramFiles%\RustDiscovery`. Konfiguration, Identität und Journale liegen unter `%ProgramData%\RustDiscovery`. [Nativer Release-Abruf](../../crates/agent-windows/src/release_service.rs) · [HTTPS-Aufnahme und Selbstupdate](../../docs/evidence/windows-gnu-official-vm-20261118.json)
Public-only Paket lokal unter `devstate/windows-bootstrap/windows-dev-access.zip`:
dieses Skript und `bootstrap-public.json` mit Notebook-Public-Key, bereits
unabhängig geprüftem Server-ED25519-Hostkey und 24-Stunden-Frist. Kein privater
Schlüssel und kein Cloud-Rootzugang werden verteilt. Der neue Tunnelschlüssel
wird ausschließlich auf der Windows-VM erzeugt und verlässt sie nicht.
PowerShell-Parserprüfung mit offiziellem PowerShell 7.7.0 auf dem Notebook:
bestanden. **Kein nativer Windows-Ausführungs-/OpenSSH-/ACL-/Tasknachweis.**
Das Skript verwendet PowerShell-5.1-Syntax; die Ausführung auf Windows 11 muss
noch durch den User erfolgen. Vorhandene laufende SSH-Installation, gleichnamiger
Account/Task oder Teilbootstrap werden verweigert statt überschrieben.
## In der Windows-Test-VM ausführen (geplant, noch nicht nachgewiesen)
Paket auf die VM kopieren und entpacken. Erhöhte **64-Bit-PowerShell** im
entpackten Verzeichnis öffnen, Skript prüfen und dann:
Diese Befehle zeigen in einer administrativen PowerShell die beiden Standarddienste und den letzten Updaterstatus.
```powershell
Unblock-File -LiteralPath .\Bootstrap-DevAccess.ps1
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\Bootstrap-DevAccess.ps1
Get-Service -Name RmmDiscoveryWindows,RmmDiscoveryReleasePull
Get-Content -Raw (Join-Path $env:ProgramData 'RustDiscovery\release-state\release-status.json')
```
`RemoteSigned` gilt ausschließlich für den gestarteten Prozess; keine Änderung
der systemweiten Ausführungsrichtlinie und kein Umgehen einer Gruppenrichtlinie.
Es installiert nötigenfalls ausschließlich die optionalen OpenSSH-Funktionen.
`RestartNeeded` stoppt die Vorbereitung; kein automatischer Neustart/OS-Update.
Bei eingerichtetem SYSTEM-Kontext zusätzlich `Get-Service -Name RmmDiscoverySystemHelper` prüfen. In der WebUI lassen sich für den konkreten Auftrag der gebundene Skripttext, der Exitcode und die Ausgabe nachlesen. Bei Windows-Updates „Windows-Updates installieren“ als SYSTEM planen. Die PowerShell-Vorlage meldet die Ergebnisse der Installation und den Neustartbedarf. [Abnahme einer echten Updateinstallation](../../docs/evidence/windows-update-installation-20261117.json)
Es erstellt den bis zur Paketfrist gültigen lokalen Administrator `rmm-dev`
mit zufälligem, ausschließlich VM-internem Passwort und Public-Key-only-SSH.
Authorized-Keys und Bootstrapstate sind nur für SYSTEM/Administratoren zugänglich
(SIDs statt sprachabhängiger Namen). Windows-SSH lauscht ausschließlich auf
`127.0.0.1:22222`; Standard-OpenSSH-Firewallregel wird deaktiviert. Konfigurations-
und Keydateien einer vorhandenen gestoppten Installation werden gesichert.
## Neustart und Wiederanmeldung prüfen
Ein SYSTEM-Task verbindet ausgehend zum bekannten Server und prüft dessen
Hostkey strikt. Reverse-Listener dort nur Loopback. Wiederverbindung alle 30s
ist ausschließlich Bootstraptransport, kein RMM-Job-Retry. Task beendet seinen
eigenen SSH-Prozess nach Frist; kein Reboot. Bestehende RMM-Policies bleiben.
Das Skript druckt ausschließlich öffentliche Registrierungsdaten:
`windows_user`, `tunnel_public_key`, `windows_host_public_key`, `expires_at`,
`windows_architecture` sowie Hostkeyfingerprint. Diese Ausgabe von der tatsächlichen
VM-Konsole zurückgeben; keine privaten Schlüssel/Passwörter übertragen.
Nach Hinterlegung des Tunnel-Public-Keys und Prüfung/Pinnen des Windows-Hostkeys
kann der Entwicklungsrechner über den Cloudserver mit seinem vorhandenen Key
auf den Windows-Administrator zugreifen. Native Nachweise folgen erst dann.
Grundlagen: [Microsoft OpenSSH-Installation](https://learn.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse),
[Windows-Konfiguration und Administrator-Key-ACL](https://learn.microsoft.com/en-us/windows-server/administration/openssh/openssh-server-configuration).
## Öffentlicher Download auf dem Cloudserver — tatsächlich geprüft
Auf Userwunsch Public-only Paket separat auf HTTPS **8443**, ausschließlich ein
exakter Downloadpfad bis Paketablauf. Gültige öffentliche Let's-Encrypt-Kette
mit normalem externem Truststore geprüft; heruntergeladene Bytes SHA256-identisch.
RMM-TLS/mTLS auf 443, Verwaltungszugang und Client-Truststores unverändert.
Keine Secrets im Bundle. Link und Belege geschützt unter
`devstate/windows-bootstrap/{publication.json,published-verified.json}`.
`deploy/windows/publish_bootstrap.py`: ACME mit gepinntem, geprüftem
acme-tiny-Commit `dc2c102314a56580facafce2249b292cebcfc42b`; Account-/Domainkeys
bleiben auf dem Server in rootgeschütztem Verzeichnis. HTTP80 nur für ACME,
danach tatsächlich gestoppt und Firewallregel entfernt. Downloadserver mit
DynamicUser, readonly System, separaten systemd-Credentials für TLS-Key und
maximal 16 gleichzeitigen Verbindungen. Kein beliebiges Dateisystemhosting.
Ein späterer Verbindungsversuch traf zunächst auf eine blockierende TLS-Annahme.
Server korrigiert: Timeout/Handshake je begrenztem Worker, Listener blockiert
nicht mehr. Danach externer HTTPS-Download während gleichzeitig offener langsamer
TCP-Verbindung erfolgreich; `/`, `/etc/passwd`, `/auth/config` und codierter
Traversalpfad jeweils 404. Drei lokale Pfad-/Frist-/ACME-Guards bestanden.
Öffentliche Freigabe endet **2026-11-14 12:55:31 UTC**. Aktiver persistenter
systemd-Timer stoppt den eigenen Downloadservice und schließt dessen Firewallport
8443; auch die Anwendung verweigert nach Frist weitere Downloads. Dies ist
Bootstrapwartung auf dem Server, kein autorisierender RMM-Job oder VM-Reboot.
Windows-Ausführung weiterhin nicht nachgewiesen.
## Tatsächlich hergestellter Zugang / Reparaturen
Der User führte das erste Paket auf Windows aus. Dienst zunächst Exit 1067,
Vordergrundstart dagegen erfolgreich. `Repair-DevAccess.ps1` prüft die bestehenden
Skripte/Config gegen die ursprünglichen Hashes, sichert ACLs, setzt SYSTEM als
Eigentümer und SYSTEM/Administratoren als einzige Zugriffsberechtigte für
SSH-Verzeichnis, Config und Hostprivatekeys. Keine Schlüssel-/Kontoneuerzeugung.
Danach Dienst tatsächlich `Running`, Hostkey unverändert. Erstbootstrap-Quelle
für neue Pakete entsprechend korrigiert; historisches Public-ZIP unverändert,
separates Repair-ZIP mit eigener expliziter Downloadroute veröffentlicht.
Cloud-Public-Key registriert; anfänglich ungültige Option `permitopen="none"`
aus `authorized_keys` entfernt. Sie ist ausschließlich im sshd-Matchprofil gültig
und dort unverändert aktiv. Zusätzlich öffentliche `.ssh`-Directorymodi explizit
gesetzt, statt sie einer umask zu überlassen. Remote-only/PermitListen/MaxSessions
bleiben erhalten. Private Keys wurden nicht übertragen.
Windows-Tunnel anschließend automatisch durch den Hintergrundtask aufgebaut.
Notebook-SSH über Cloud-Loopback mit unabhängig aus der VM-Konsole bestätigtem
Hostkey und vorhandenem Notebook-Key erfolgreich. Echt beobachtet: **Windows 11
Pro, Build 26300, 64 Bit, Administrator=true**. Zugangsdaten nur unter
`credentials/windows-dev-access.json`, Belege unter `devstate/windows-bootstrap/`.
**Noch kein RMM-Windows-Client installiert/enrolled/abgenommen.** Keine Änderung
am Notebook-Host als reinem Entwicklungsrechner.
## Zugang bei Bedarf stoppen
Auf der Windows-VM als Administrator, ausschließlich eigene Bootstrapressourcen:
Die Bibliotheksrevision „Windows neu starten“ Version 2 verwendet das systemeigene `shutdown.exe` mit einer Minute Vorlauf. Die folgende Abfrage vor und nach dem Neustart ausführen und den Startzeitpunkt des jüngsten Kernel-General-Ereignisses 12 vergleichen.
```powershell
Stop-ScheduledTask -TaskName RmmDevReverseTunnel
Unregister-ScheduledTask -TaskName RmmDevReverseTunnel -Confirm:$false
Disable-LocalUser -Name rmm-dev
Stop-Service -Name sshd
$event = Get-WinEvent -FilterHashtable @{LogName='System'; ProviderName='Microsoft-Windows-Kernel-General'; Id=12} -MaxEvents 1
(([xml]$event.ToXml()).Event.EventData.Data | Where-Object Name -eq 'StartTime').InnerText
```
Backups/Hostkeys und Zustandsdateien erhalten. Cloud-Tunnelkey separat sperren;
keine pauschale Änderung anderer SSH-Zugänge. Vollständige Entfernung einer
vorherigen SSH-Konfiguration ist ein eigener kontrollierter Vorgang.
Nach dem Bootwechsel den authentisierten Kontakt derselben Installation und einen Folgeauftrag mit Ergebnis prüfen. Bei einem Gatewaywechsel kann sich der Agent vorübergehend bereits melden, während er den signierten Zeit- und Journalabgleich für ausführbare Aufträge erneuert. Bei dauerhaft ausstehendem Abgleich den letzten authentisierten Kontakt, die Windows-Zeitsynchronisation (`w32tm /query /status`) und die Bereitschaft von Agent und optionalem Helper prüfen. Nach einer bestätigten Ergebnismeldung kann der Helper seinen Abgleich wieder aufnehmen. [Zeitabgleich](../../docs/evidence/windows-gateway-clock-recovery-20261117.json) · [Helper-Abgleich](../../docs/evidence/windows-helper-result-recovery-20261118.json) · [Native MCP-Abnahme](../../docs/evidence/mcp-scoped-script-requests-20261118.json)
Für Störungen zwischen Agent und SYSTEM-Helper beschreibt die [Pipe-Dokumentation](../../docs/windows-helper-pipe-drain.md) die lokale Transportbestätigung. Für den Entwicklungsgast ohne dauerhaften Helper enthält das [Runbook für befristete Windows-Updatefenster](../../docs/windows-update-dev-window.md) die Voraussetzungen und den Rückbau.
Build, Veröffentlichung und Entwicklungsbereitstellung stehen im [Entwicklungsweg](../../docs/development.md).
-238
View File
@@ -1,238 +0,0 @@
# Native Windows MSVC build
Prepared 2026-11-14. The native `Prepare` phase was attempted in the retained
case `b208282f-d950-4f5a-bc5e-9e071ccb4d93` and stopped before any download or
installer: `SETUP_PREEXISTING_REBOOT_PENDING`. Separate read-only inspection
confirmed both the CBS `RebootPending` and Windows Update `RebootRequired` keys
already existed; PendingFileRenameOperations had24 entries (contents not read
into the report). No compiler installation, Windows update, restart, trust-store
change, daemon replacement or RMM job was performed. Agent PID5140 and helper
PID6240 remained running; W32Time remained stopped. This is an incomplete
prerequisite, not a successful MSVC qualification. No flag is cleared or ignored.
`Build-NativeMsvc.ps1` is a development build runner, not an installer. Run it in
64-bit Windows PowerShell5.1 from a source bundle containing the exact repository
sources and this script. `Preflight` inventories installed tools and records
private source/tool hashes. `Build` requires an explicitly selected successful
preflight receipt, creates a different private case, and builds an isolated
source copy. It never reuses a partial build case.
## Required native tools
- Rust `1.99.1-x86_64-pc-windows-msvc`, including `cargo`, `rustc`, `rustdoc`,
`clippy-driver`, `rustfmt`, supplied by the official rustup installation.
- Installed Visual Studio C++ tools in the selected range `[17.14,19.0)`;
VS2022 or VS2026 is selected by its signed `vswhere.exe`. The actual product,
compiler version, signer thumbprints and tool hashes are recorded. The current
official [VS release history](https://learn.microsoft.com/en-us/visualstudio/releases/2026/release-history)
includes VS2026; the runner does not download a mutable latest bootstrapper.
- The x64 `cl.exe`, `link.exe`, `lib.exe`, `dumpbin.exe`, and Windows SDK
`10.0.26100.0` x64 `midl.exe`. Microsoft signatures must be valid. The selected
SDK is explicit through `vcvarsall.bat amd64 10.0.26100.0`; see Microsoft's
[native build environment](https://learn.microsoft.com/en-us/cpp/build/building-on-the-command-line?view=msvc-170).
- At least20GiB available on the evidence/build volume by default. This is the
runner's conservative admission threshold, not a measured installation size.
- The locked Cargo dependencies must already be available in the build user's
registry cache. Builds are `--locked --offline`. A missing crate is a failed
prerequisite, never a reason for an automatic online retry. An explicit
development preparation can populate the public dependencies with
`cargo +1.99.1-x86_64-pc-windows-msvc fetch --locked --target x86_64-pc-windows-msvc`.
Do not transfer an entire Cargo home containing credentials or configuration.
The parent's actual read-only VM report
`devstate/windows-client/native-msvc-tools-readonly-20261114.json` now records
103300169728 free bytes, x64, no `vswhere`, no `rustup`, no SDK directories,
W32Time stopped and all execution-policy scopes undefined. No installation was
performed by this preparation. No extra private key, server token or production
signing certificate is needed for source build.
[Rust's MSVC target contract](https://doc.rust-lang.org/rustc/platform-support/windows-msvc.html)
defines native Windows support, Microsoft calling conventions and PE/COFF output.
## Explicit tool-setup plan, not executed
If preflight reports missing C++ tools, first select a **fixed-version** Build
Tools bootstrapper from Microsoft's release history, retain its download URL,
SHA-256, ProductVersion, valid Microsoft Authenticode signature and thumbprint.
Verify the intended absent/new install directory and sufficient disk before
starting setup. Reuse a suitable existing installation rather than updating it.
The exact required component IDs are:
```text
Microsoft.VisualStudio.Workload.VCTools
Microsoft.VisualStudio.Component.VC.Tools.x86.x64
Microsoft.VisualStudio.Component.Windows11SDK.26100
```
The planned bootstrapper arguments are:
```text
--wait --passive --norestart --installPath C:\RmmBuildTools
--add Microsoft.VisualStudio.Workload.VCTools
--add Microsoft.VisualStudio.Component.VC.Tools.x86.x64
--add Microsoft.VisualStudio.Component.Windows11SDK.26100
```
There is no `--force`, repair, OS update, automatic retry or reboot. Persist the
actual setup process/result before returning a bootstrap reply. `0` completes
the setup operation; `3010` means installation requires a restart **before use**,
so stop without building, clearing the flag or implicitly rebooting. `1641`
means a reboot was initiated and violates this no-restart plan. `1618`/`1001`
mean another installation is active; preserve the case and inspect, never kill
the other installer or blindly rerun. A lost SSH reply permits only process/log
readback of that same setup. The build runner itself never launches setup.
[Microsoft component IDs](https://learn.microsoft.com/en-us/visualstudio/install/workload-component-id-vs-build-tools?view=visualstudio),
[parameters and actual exit-code semantics](https://learn.microsoft.com/en-us/visualstudio/install/use-command-line-parameters-to-install-visual-studio?view=vs-2022).
## Build invocation and evidence
Planned, not executed:
```powershell
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Build-NativeMsvc.ps1 -Mode Preflight -SourceRoot C:\Source\rust-discovery
# Review that exact private preflight.json, then use a NEW build case:
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Build-NativeMsvc.ps1 -Mode Build -SourceRoot C:\Source\rust-discovery `
-ExpectedPreflight C:\Users\Administrator\RmmNativeBuilds\<preflight-id>\preflight.json
```
The runner imports only selected developer environment values, rejects caller
compiler flags/wrappers, pins the native compiler/linker/MIDL paths, and keeps
each process's stdout/stderr private. It copies only explicit source extensions
under `crates/` and `proto/`, root Cargo/toolchain files and the MSVC runner/probe;
no `credentials/`, `devstate/`, client key material, repository metadata or local
server state. A protected build root and new protected case prevent unrelated
service users from changing the copied inputs. Source/tool hashes must match
before and after the build.
Before Cargo, Microsoft MIDL generates the real IDL with `/env amd64 /Oicf
/robust /Zp8`; `win64` is intentionally avoided because MIDL documents it as
IA64. The native C probe asserts Microsoft LLP64, numeric Rust ABI64 bytes,
wire-status ABI120 bytes and explicit field offsets. It raises/catches only a
local RPC exception1722 using the same SDK SEH macros/filter; it does not query
W32Time, contact RPC or claim trusted time. There is no vendored WIDL stub or
SEH workaround. [MIDL AMD64/packing](https://learn.microsoft.com/en-us/windows/win32/midl/-env),
[robust NDR checking](https://learn.microsoft.com/en-us/windows/win32/midl/-robust),
[C11 assertions](https://learn.microsoft.com/en-us/cpp/c-language/static-assert-c?view=msvc-170),
[SDK RPC SEH](https://learn.microsoft.com/en-us/windows/win32/rpc/rpctryexcept).
The product build script adds only the native MSVC branch, preserving the GNU
WIDL/clang branch and the C exception boundary. Both still compile the actual
clock sources and preserve their static assertions; SDK or compiler failure is
fatal. The Clock readiness gate stays unqualified. The separate native
service-SID authentication candidate is not qualified by an ABI or build pass.
Cargo then checks Windows Clippy with warnings denied, builds agent/helper and
examples in release, and **links without running** Windows/core unit tests.
The runner records AMD64 PE headers, artifact hashes, generated RPC hashes,
dependency listings and actual Authenticode status. Development output may be
unsigned; this is no signing/installer/production-PKI acceptance. Native unit
execution, LocalService/SYSTEM behavior and a preserving daemon deployment
remain separate explicit gates. A timeout retains its exact process/evidence;
no process-tree kill or retry is implied.
Locally executed preparation checks: PowerShell AST parse; isolated compilation
and Clippy of `build.rs` using locked-version `cc1.11.1`; rustfmt/source checks.
These checks do not prove that Microsoft MIDL, MSVC, the ABI probe or the final
agent/helper builds have run successfully on Windows.
## Concrete native tool bootstrap, prepared separately
`Install-NativeBuildTools.ps1` supplies separate `Prepare`, `InstallVs`,
`InstallRust`, and read-only `Read` phases. Only `Prepare` has been attempted;
the pre-existing reboot need blocked it before downloads. Neither install phase
has run. Both install calls consume create-only start intents
before launching their fixed worker. Each worker runs in its own protected,
demand-only Task Scheduler entry as SYSTEM, without a trigger, automatic retry
or autostart; a second worker entry refuses before installation. This keeps a
long setup independent of the40s SSH/bootstrap reply limit. Results, actual
installer PID and exit code are retained, and the task is disabled after its
worker result. Lost reply/timeout permits readback only. These are explicitly
authorized development-tool bootstrap tasks, never WebUI/RMM jobs or a generic
SYSTEM execution provider. [Task registration](https://learn.microsoft.com/en-us/powershell/module/scheduledtasks/register-scheduledtask?view=windowsserver2025-ps),
[fixed service-account principal](https://learn.microsoft.com/en-us/powershell/module/scheduledtasks/new-scheduledtaskprincipal?view=windowsserver2025-ps).
Inputs are fixed official TLS URLs with ordinary certificate/name validation:
| Input | Pinned SHA-256 |
|---|---|
| Microsoft Build Tools18.11.4 LTSC bootstrapper, file version18.11.12405.450 | `386b5d9a3d6576eab3772c1ecaa7c107ded38146a9c483f41679c194ae1e63b4` |
| rustup1.29.3 Windows x64 MSVC bootstrapper | `38027d51d69a5d05493627a0634dbea52d6cd793c8f072d2373d3f4163eec7db` |
| Rust1.99.1 official distribution manifest | `fb152be80975c194aa5fc684b2aec3a6e14e2b855efe2faa4e5f8ae6e590f463` |
The Microsoft EXE additionally requires valid Microsoft Authenticode and the
exact product/file version. Rustup is checked against its exact
[official archived checksum](https://static.rust-lang.org/rustup/archive/1.29.3/x86_64-pc-windows-msvc/rustup-init.exe.sha256),
with [official archive/install options](https://rust-lang.github.io/rustup/installation/other.html).
Its homes are private case subdirectories; `--no-modify-path`,
`--no-update-default-toolchain`, minimal profile and exactly clippy/rustfmt keep
the developer's default Rust installation/profile/PATH untouched. The fixed
Rust distribution origin is set only for that worker process. Using isolated
homes is an [official rustup option](https://rust-lang.github.io/rustup/installation/index.html).
VS setup uses only `--wait --quiet --norestart --noUpdateInstaller`, the new
fixed target `C:\RmmBuildTools`, and the three components above. It relies on the
official installer's standard Microsoft metadata/package verification. No
custom channel/catalog, checksum override, certificate import or weaker
verification flag is supplied. Installed VS version must then match exactly
18.11.12405.450 and SDK26100 must be present; drift remains incomplete. Setup's
required transitive development dependencies remain Microsoft's responsibility;
this is no general production-installer trust acceptance. No Windows Update
command is invoked. Boot/OS build, machine trust-store fingerprints, machine
PATH, execution policies, W32Time and both exact RMM service states/PIDs are
observed before/after. Detected changes, unexpected setup version,3010/1641 or
restart need stop completion without resetting/undoing or retrying anything.
Scope decision2026-11-14: an initial **custom manual catalog-bundle** design was
rejected. Its channel declared catalog size31851991 and hash
`ef56e369d92855a9667cd03602019375f42b3cd2145041df31cacc071a40e1af`;
the exact official URL instead returned18733589 bytes with hash
`805d16fd14a370cbeb6568179950826ba0cdc6e2cffa44936fddc408ef05cba3`.
Those inputs and rejected source remain privately retained; no mismatching
catalog was accepted or installed. The extra manual bundle was our design,
not an AGENTS/product requirement. The selected replacement uses the supported,
independently hash/Authenticode-pinned official EXE and its own verification,
not a checksum exception or undocumented JSON-signature workaround.
Microsoft documents [standard acquisition and fixed-version bootstrappers](https://learn.microsoft.com/en-us/visualstudio/install/use-command-line-parameters-to-install-visual-studio?view=vs-2022).
Future successful-case sequence; installation and build remain **not executed**.
The failed case above is retained and must not be reused after a prerequisite
change. A manual VM restart has been requested for later coordination; it is
neither implicitly authorized nor an RMM reboot acceptance.
```powershell
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Install-NativeBuildTools.ps1 -Phase Prepare
# Review that exact printed private case and its prepared.json first:
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Install-NativeBuildTools.ps1 -Phase InstallVs -CaseDirectory <case>
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Install-NativeBuildTools.ps1 -Phase Read -CaseDirectory <case>
# Continue only after verified VS exit0 and no restart need:
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Install-NativeBuildTools.ps1 -Phase InstallRust -CaseDirectory <same-case>
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Install-NativeBuildTools.ps1 -Phase Read -CaseDirectory <same-case>
```
This uses the already authorized **development/bootstrap-only** process option
`-ExecutionPolicy RemoteSigned`, as in the previous Windows dev-access and
passive-client bootstrap. The worker uses that same process option and invokes
the hash-checked `.ps1` file normally with `& $p`; it never executes file content
through `ScriptBlock::Create`. A small encoded hash launcher is only transport
for that ordinary file invocation. There is no `Set-ExecutionPolicy`, registry
policy write, Machine/User/GPO change or Bypass option. Persistent scopes stay
unchanged; process scopes are consistently RemoteSigned and GPO precedence is
retained. This permission does **not** decide or authorize the separate RMM
PowerShell job executor's still-unqualified policy contract.
After actual successful setup, pass the recorded private homes to the builder:
```powershell
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Build-NativeMsvc.ps1 -Mode Preflight -SourceRoot C:\Source\rust-discovery `
-RustupExe <case>\cargo_home\bin\rustup.exe -RustupHome <case>\rustup_home -CargoHome <case>\cargo_home
```
Use those same arguments with `-Mode Build -ExpectedPreflight <actual-receipt>`.
Populate the isolated public Cargo cache explicitly before an offline build;
there is no automatic fetch/retry in the builder. Native setup, native MIDL/ABI,
unit execution and deployment results are still outstanding until actually run.
On November 15, 2026 a read-only check on the running Windows test VM found
both CBS and Windows Update restart markers, 96 GiB free on C:, no vswhere
at its standard installer path, and no rustc on the development user's PATH.
No installer was launched. This check does not determine why the markers are
present. Receipt `04a56e7d8a8bf00a110558344248fbb0ca0c2234c5c1ea6e347306bcc84d5c55`.