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
+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).