Files
rust-discovery/deploy/windows/README.md
2026-11-13 14:42:44 +01:00

135 lines
7.7 KiB
Markdown

# Windows-11-Entwicklungszugang
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.
## Vorbereitet und tatsächlich geprüft
`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.
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:
```powershell
Unblock-File -LiteralPath .\Bootstrap-DevAccess.ps1
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\Bootstrap-DevAccess.ps1
```
`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.
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.
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:
```powershell
Stop-ScheduledTask -TaskName RmmDevReverseTunnel
Unregister-ScheduledTask -TaskName RmmDevReverseTunnel -Confirm:$false
Disable-LocalUser -Name rmm-dev
Stop-Service -Name sshd
```
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.