135 lines
7.7 KiB
Markdown
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.
|