Document the accepted MVP and retire superseded development plans
Rust development slice / linux (push) Failing after 14s
Rust development slice / linux (push) Failing after 14s
This commit is contained in:
+22
-128
@@ -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).
|
||||
|
||||
Reference in New Issue
Block a user