325 lines
27 KiB
Markdown
325 lines
27 KiB
Markdown
# Linux-first-Entwicklung und reale VM-Abnahme
|
||
|
||
Stand: 2026-11-15 · Spezifikation 1.24. Das begrenzte Linux-MVP ist inzwischen
|
||
dokumentiert abgenommen; aktuelle Nachweise stehen in [handover.md](handover.md).
|
||
Die getrennte Windows-SYSTEM-Grenze ist in Spezifikation0.1 und
|
||
[windows-system-policy.md](windows-system-policy.md) präzisiert; Quellen-/Build-
|
||
oder Linux-Unitnachweise aktivieren keine Windowswirkung.
|
||
**Windows-Override:** Entwicklung und native
|
||
Tests auf der neuen Windows-11-VM sind ausdrücklich parallel erlaubt, unabhängig
|
||
von der noch offenen Linux-MVP-Abnahme. Die nachstehenden älteren Wartevorgaben
|
||
sind hierfür überstimmt; keine Windows-Pflicht zur Linux-Abnahme.
|
||
**Topologieoverride:** Dieses Notebook
|
||
ist ausschließlich Entwicklungsrechner, weder RMM-Server noch RMM-Client.
|
||
Aktueller Client ist die Cloud-Test-VM, endgültiger Server der festgelegte
|
||
Cloudserver. Clients verbinden sich ausgehend direkt dorthin. Aktueller Vertrag und
|
||
Deploymentnachweise: [server-deployment.md](server-deployment.md).
|
||
Die folgenden PC-Server-/Reverse-Tunnel-Abläufe und Nachweise sind historisch.
|
||
TLS/mTLS, Credentialschutz, Linux-first und WebUI-Plangenehmigung gelten weiter.
|
||
|
||
## Historienerhaltende Windows-Wiederherstellung (Version 1.24)
|
||
|
||
Für den dokumentierten Fall `HELPER_CHECKPOINT_REQUIRED` ist die
|
||
Wiederherstellung mit Erhalt der Geräteidentität und aller Journale beauftragt.
|
||
Die erhaltenen signierten Antworten und der abweichende gültige Serverhead
|
||
werden vor jeder Korrektur unabhängig geprüft. Das neue Verfahren braucht
|
||
einen eigenen nachvollziehbaren Administrationsnachweis. Anschließend gelten
|
||
die normalen unabhängigen Zeit- und Syncprüfungen für beide Dienstrollen.
|
||
Die Testjobabnahme verwendet danach weiterhin den fest gebundenen MCP-Antrag
|
||
und die WebUI-Genehmigung. Der historische V1.10-Reparaturweg betrifft einen
|
||
anderen Fehlerfall. Native Wiederherstellung und Jobabnahme sind noch offen.
|
||
|
||
## Begrenztes Windows-KVM-Zeitprofil (Version1.23)
|
||
|
||
Der User hat `trusted_os_active_guest` ausdrücklich zur Umsetzung erlaubt.
|
||
[Profilvertrag und Betriebsgrenzen](windows-kvm-clock-contract-proposal.md)
|
||
und SpezifikationKapitel0 gelten: vertrauensbasierte nominelle OS-/KVM-Zeit,
|
||
keine behauptete unabhängige physikalische Kalibrierung. Eigener versionierter
|
||
Opt-in mit geschützten Rollen-/Image-/Plattformbelegen; kein geratener Basiswert.
|
||
Vor VM-Pause, Save/Restore, Snapshot-Rückkehr, Migration und Host-Suspend beide
|
||
Agent-/Helperprozesse beenden und anschließend frisch starten. Keine solche
|
||
Betriebsaktion oder Gatefreischaltung folgt automatisch aus der Entscheidung.
|
||
Linux-first und native Windowsabnahme bleiben erforderlich; der signierte
|
||
Serververgleich und jede WebUI-Genehmigung bleiben Pflicht.
|
||
|
||
## Unabhängiger signierter Windows-Zeitvergleich (Version1.22)
|
||
|
||
Der User erlaubt ausdrücklich den signierten Onlinevergleich mit dem festen
|
||
Server. [Angenommener Vertrag](windows-clock-attestation-proposal.md) und
|
||
SpezifikationKapitel0 ersetzen den früheren Ausschluss dieser Trustsource.
|
||
Agent und SYSTEM-Helper halten eigene Challenges, Beobachtungen und geschützte
|
||
Zeitpins. W32Time-Rohstatus bleibt separat; kein Clocksetter oder impliziter
|
||
manueller Resync. Fehlende native Server-/Windowsqualität sperrt weiter Jobs.
|
||
Ein signierter Zeitbeleg ersetzt weder SignedSync noch Startgrant oder WebUI.
|
||
|
||
Zuerst reale Cloud-Linux-Prüfungen des gemeinsamen Vertrags und der Serverquelle,
|
||
danach Windows getrennt je tatsächlicher Identität. Isolierte Codecunits belegen
|
||
keine reale Zeitqualität. Caller dürfen die gesamte frische UTCspanne nicht auf
|
||
einen ungesicherten Mittelpunkt reduzieren; Start- und Syncablauffristen müssen
|
||
konservativ eingehalten werden. Notebook bleibt nur Entwicklung.
|
||
|
||
## Enger paralleler Agentupdater (Version1.21)
|
||
|
||
Der User hat signiertes Agent-Selbstupdate parallel vorgezogen. Es bleibt ein
|
||
festes Release-/Vorgänger-/Versuchs-/Planhashpaket mit tatsächlicher WebUI-
|
||
Genehmigung; passive Metadaten/Updatezustände sind keine Jobs. Neuer
|
||
`agent.update`-Scope liefert eigene tatsächliche Beobachtungszeiten und darf
|
||
kein altes Linux-/Windows-Baseinventar frischstempeln. Beide Binaries werden
|
||
vollständig vor Handoff gestaged; anschließender read-only Inflight-/Health-
|
||
Kontrollpfad eröffnet keine Admission oder neue Startlease.
|
||
|
||
Vor Zielarbeit: kompatible erhaltende Bootstrap-/Baselineprovisionierung,
|
||
unabhängiger Source-Review, Linux-first-Units/OSports und danach ein konkreter
|
||
WebUI-genehmigter Apply mit State-/PKI-/Historyerhaltung und erlaubtem Code-
|
||
Rollback. Root koordiniert alle Zielaktionen. Notebook bleibt nur Entwicklung.
|
||
Aktuelle Teilnachweise und fehlende Runtimegates:
|
||
[Handoff](agent-updater-handoff.md), [Linuxport](agent-updater-linux-port.md),
|
||
[Server/UI](agent-updater-server-console.md). Keine Applycapability aus einem
|
||
Build oder Katalogeintrag ableiten; fehlende Qualifikation bleibt deny.
|
||
|
||
## Vorrang: genehmigte Batch-Skriptkonsole (Version1.20)
|
||
|
||
Der User priorisiert vollständige Shell-/PowerShell-Skripte über MCP/UI mit
|
||
expliziten Root-/SYSTEM-Rechten. Kapitel0.1 bindet das neue optionale
|
||
`privileged_script_profile="full_maintenance_v1"` vor Genehmigung in Payload,
|
||
Policy und WebUI. Alte Pläne/Profile bleiben unverändert; SCM/APT/MSI dürfen
|
||
keine Vollwartung durch eine stille Lockerung erhalten. Bisherige M7-Aussagen
|
||
zu Terminal/Sitzungen verschieben diese Batchkonsole nicht. Agent-Selbstupdates
|
||
werden separat behandelt; Paketfixture-Abnahmen ersetzen sie nicht.
|
||
|
||
Geplanter, noch nicht ausgeführter Ablauf: additive bytekompatible Verträge und
|
||
Policygrenzen implementieren; lokale betroffene Kompatibilitäts-/Fehlerprüfungen;
|
||
reviewbare explizite Helper-/Policymigration unter Erhalt aller Identitäten,
|
||
Journaldateien und Verbräuche; qualifizierte Linux-Cloud-Artefakte; neuer fester
|
||
WebUI-genehmigter harmloser Vollwartungsplan auf der Linux-Cloud-VM; erst danach
|
||
getrennte native Windows-SYSTEM-Abnahme auf dem Windowsgast. Kein RMM-Agent oder
|
||
Server auf dem Notebook. Vor Zieländerungen konkrete Startbedingungen/Umfang
|
||
festhalten, keine Ledgerresets oder impliziten Reboots/Updates.
|
||
|
||
Abnahme muss gespeicherte vollständige Skriptbytes samt Profil/Identität/Limits
|
||
vor tatsächlicher WebUI-Genehmigung zeigen, vor Genehmigung Job-/Outbox-/Grant-
|
||
Abwesenheit belegen und danach ehrliche Zustände/finale begrenzte stdout-/stderr-
|
||
Rohbytes mit Trunkierung erfassen. Keine laufende Ausgabe vortäuschen: bestehende
|
||
Jobstrecke liefert vorerst Abschlussausgabe. LinuxUID0 und WindowsSID18 sowie
|
||
Clock/Sync/Peer-/Originalsignatur-/Einmalverbrauchsgrenzen getrennt nachweisen.
|
||
Abbruch/Fence/Timeout prüfen nur im abgestimmten harmlosen Scope; unklare Wirkung
|
||
bleibt unknown, kein blindes Wiederholen. Root/SYSTEM kann auch eigene Schutz-
|
||
mechanismen ändern; keine Sandbox-/No-Reboot- oder vollständige Kindprozess-
|
||
Eindämmungszusage. Ein Skript-Reboot ersetzt keine typisierte Rebootabnahme.
|
||
|
||
Die Norm ist beschlossen; lokale Quellen-/Buildnachweise und deren Grenzen
|
||
stehen in [deploy/linux/full-maintenance-README.md](../deploy/linux/full-maintenance-README.md).
|
||
Ein unabhängiger Review fand im ersten eingefrorenen Pack die fehlende tatsächliche
|
||
Linux-Helperbinarybindung; dieser Pack bleibt nur früherer Beleg. Der enge
|
||
Full-only-Corefix wurde unabhängig geprüft und im neuen Pack29461892 mit158
|
||
unveränderten Inputs,285 lokalen Tests und45 tatsächlichen isolierten DB-Verträgen
|
||
neu qualifiziert. Der separate Native-Runner ist vorbereitet, noch nicht
|
||
Zielaktivierung oder VM-Abnahme; diese bleiben offen. Die bestehende begrenzte
|
||
Linux-MVP-Abnahme wird nicht nachträglich zur Vollwartungsabnahme umgedeutet.
|
||
Details/technischer Entwurf: [script-console-contract-proposal.md](script-console-contract-proposal.md).
|
||
|
||
## Begrenzte Windowsfreigaben (2026-11-14)
|
||
|
||
Der User erlaubt `RemoteSigned` ausschließlich je zuvor WebUI-genehmigtem
|
||
Windows-PowerShell5.1-Jobprozess. Die feste Option muss vor der Genehmigung im
|
||
unveränderlichen Plan sichtbar und in den Originaljobbytes gebunden sein.
|
||
Keine Maschinen-/CurrentUser-/GPO-Policyänderung durch den Executor, kein
|
||
Bypass-/Unrestricted-Fallback und kein nachträgliches Ändern alter Pläne.
|
||
Quellenstand und nötige Linux-first-/Windowsnachweise:
|
||
[windows-powershell-policy.md](windows-powershell-policy.md). Die laufende
|
||
gemeinsame Quellen-/Upgradequalifikation wird für diesen Entwurf nicht verändert.
|
||
|
||
Der vorhandene `W32Time` darf gezielt gestartet werden; Startart, NTPserver/Peers
|
||
und ACLs bleiben unverändert. Anschließend sind tatsächliche lokale Uhrqualität,
|
||
Unsicherheit und Bootbindung zu prüfen. Running allein öffnet kein Clockgate.
|
||
Ein manueller VM-Konsolenneustart ist erst später nach ausdrücklicher zeitlicher
|
||
Abstimmung mit dem User vorgesehen. Kein Remote-Reboot oder RMM-Reboottest;
|
||
ein solcher manueller Neustart ist kein genehmigter RMM-Reboot-Erfolgsnachweis.
|
||
Notebookhost weiterhin ausschließlich Entwicklung. Dieser Abschnitt dokumentiert
|
||
Erlaubnis und offene Nachweise, keine hier ausgeführten Zielaktionen.
|
||
|
||
## Ergänzende Userfreigabe und lokale Browserprüfung (2026-11-12)
|
||
|
||
Der User hat temporären Testdienst, harmloses Testpaket, systemd-Agent, einen VM-Reboot
|
||
und ausgewählte kleine Updates ausdrücklich erlaubt; kein Kernel-/Distributionsupdate
|
||
und kein ungeplanter Reboot. Jeder entsprechende RMM-Job benötigt weiterhin seinen
|
||
festen Plan und explizite WebUI-Genehmigung, bei dev/test sichtbar als Simulation.
|
||
Diese Freigabe ist kein Ausführungsnachweis. Im lokalen Browser-Integrationslauf wurden
|
||
keine VM-Änderungen, Tunnel, Paket-/Update-/Rebootjobs oder Genehmigungen ausgeführt:
|
||
nur echtes TLS, Login, Zielpreview, Antrag `pending_approval`, Reload und CSRF-Prüfung
|
||
mit authentisiertem synthetischem lokalem mTLS-Testgerät. Details und reproduzierbarer
|
||
isolierter Browser-Truststore: `deploy/browser/README.md`; keine globale Truständerung.
|
||
|
||
## Phasen und Gates
|
||
|
||
1. **Linux-MVP:** M0–M5 auf Linux x86-64 mit zwei Testmandanten, WebUI, MCP und dauerhaftem, menschlich autorisiertem Jobpfad. **Jedes Feature zuerst auf der tatsächlichen Linux-Test-VM ausführen und nachweisen.** Der PC-/Containerlauf, ein Simulator oder erfolgreicher Build allein genügt nicht. Nicht auf der VM geprüfte Features bleiben unbestätigt.
|
||
2. **Windows nach Linux-MVP:** Erst nach dokumentierter Linux-MVP-Abnahme Windows-x86-64-Adapter, Dienste, Installer und dieselben Fähigkeiten nativ auf Windows abnehmen. Gemeinsame Schnittstellen berücksichtigen Windows, ohne vorgezogene Windows-Featureimplementierung.
|
||
3. **Spätere Erweiterungen:** Monitoringausbau/ARM64, danach gesondert PVE/PBS, Cluster und Backupabnahmen gemäß Spezifikation; Terminal/Betriebsreife folgen ebenfalls nach MVP. PVE ist weder Testinfrastrukturpflicht noch Voraussetzung für eigenständige Gastagenten.
|
||
|
||
Linux-MVP-Gate: Enrollment, verifiziertes TLS/mTLS, ausgehender Kanal, passives Inventar mit Quelle/Zeit, UI/MCP-Tenant-Grenzen, Antrag `pending_approval`, WebUI-Klick (tatsächlich menschlich oder ausschließlich die unten beschriebene dev/test-Browsersimulation, getrennt nachzuweisen), dauerhafte Jobs/Journal/Startgrants und nachgewiesene Ergebnisse auf der VM. Die M0–M5-Abnahmen gelten zunächst für Linux; Windows-/Mischplattformfälle folgen erst in der Windows-Phase. Long Polling, Reconnect, fehlende Genehmigung und Redelivery ohne Doppelwirkung ebenfalls nachweisen. **Useroverride 2026-11-12: RustDesk auslassen.** Keine RustDesk-Installation, Profile/Provisionierung oder externe Desktopabnahme in dieser Umsetzung. M4 bleibt allgemeine Linux-Paketverwaltung; M5 prüft nur die drei übrigen Referenzabläufe. RustDesk ist weder MVP-Pflicht noch offenes MVP-Gate; bestehende Architekturtexte gelten ausschließlich für eine spätere optionale Integration. Keine eigene Desktop-Engine als Ersatz.
|
||
|
||
## Geplante Topologie
|
||
|
||
```text
|
||
Entwickler-PC Linux-Test-VM
|
||
Docker: TLS-Endpunkt 127.0.0.1:18443 Agent
|
||
^ |
|
||
| SSH-Weiterleitung (TCP, keine TLS-Terminierung) | ausgehend TLS
|
||
+--------------------------------------- 127.0.0.1:18443
|
||
PC -- initiiert SSH zur VM --> sshd DNS: rmm-dev.internal
|
||
```
|
||
|
||
Der Server läuft **lokal in Docker auf dem PC**, nicht auf der Ziel-VM. Nur benötigte Ports veröffentlichen und alle Veröffentlichungen explizit an Loopback binden; der geplante TLS-Port lautet `127.0.0.1:18443`. Interne Datenbanken möglichst gar nicht veröffentlichen; andernfalls ebenfalls nur Loopback. Keine Bindings an alle Interfaces, kein `GatewayPorts yes`. Die VM benötigt keinen eingehenden RMM-Port. SSH zum Bootstrap ist eine davon getrennte Entwicklungsverbindung, keine Änderung des ausgehenden RMM-Vertrags.
|
||
|
||
### Geplanter SSH-Reverse-Tunnel (nicht ausgeführt)
|
||
|
||
Zuerst den SSH-Hostschlüssel über einen vertrauenswürdigen Weg prüfen und in `known_hosts` hinterlegen. `VM_USER`/`VM_HOST` im folgenden Beispiel sind bewusst **nicht geheime Platzhalter**, keine automatisch geladenen Konfigurationsvariablen. Reale Zugangswerte nicht in geteilte Logs oder Shell-Traces ausgeben.
|
||
|
||
```sh
|
||
# GEPLANT, NICHT GETESTET: auf dem Entwickler-PC, Zielwerte lokal einsetzen.
|
||
ssh -N -T \
|
||
-o ExitOnForwardFailure=yes \
|
||
-o ServerAliveInterval=30 \
|
||
-o ServerAliveCountMax=3 \
|
||
-o StrictHostKeyChecking=yes \
|
||
-R 127.0.0.1:18443:127.0.0.1:18443 \
|
||
VM_USER@VM_HOST
|
||
```
|
||
|
||
Der linke Loopback ist der Listener **auf der VM**, das rechte Ziel wird **auf dem PC** erreicht. Der Agent baut seine Verbindung zu diesem VM-Loopback auf; SSH transportiert nur die TCP-Bytes zum lokalen TLS-Endpunkt. `ExitOnForwardFailure` prüft die Einrichtung der Weiterleitung, **nicht** Erreichbarkeit/Gesundheit des lokalen Servers oder erfolgreiche Agentauthentisierung. Keepalive erkennt Verbindungsverlust; ein Tunnelneustart erteilt keine Jobgenehmigung. Bei Portkonflikt oder verweigertem Forwarding sicher abbrechen, nicht auf einen öffentlichen Listener ausweichen.
|
||
|
||
## TLS bleibt Ende-zu-Ende
|
||
|
||
- Serverzertifikat mit **DNS SAN `rmm-dev.internal`**, korrekter Gültigkeit und passender Serververwendung bereitstellen; private CA-/Serverschlüssel geschützt lokal halten, nicht committen. Dev-CA gezielt im Agenten-Truststore hinterlegen.
|
||
- **Auf der VM** in `/etc/hosts` explizit die folgende Zuordnung pflegen (geplante Bootstrapänderung, nicht hier ausgeführt):
|
||
|
||
```text
|
||
127.0.0.1 rmm-dev.internal
|
||
```
|
||
|
||
- Geplanter Agent-Endpunkt: `https://rmm-dev.internal:18443`, WSS entsprechend `wss://rmm-dev.internal:18443/agent/v1/connect`, sofern die Implementierung diesen Protokollstand tatsächlich bereitstellt. Enrollment verwendet serverauthentifiziertes HTTPS; danach mTLS mit eigener Geräteidentität.
|
||
- Alternativ ausschließlich einen ausdrücklich unterstützten und getesteten Client-Connect-Override verwenden: TCP-Ziel `127.0.0.1:18443`, **TLS-SNI und Zertifikatsnamensprüfung weiter `rmm-dev.internal`**. Kein erfundenes CLI-Flag als vorhandenes Feature dokumentieren.
|
||
- Ein Aufruf über `https://127.0.0.1:18443` passt nicht zum DNS-SAN. Nicht mit `accept_invalid_certs`, `danger_accept_invalid_certs`, deaktivierter Hostnamenprüfung oder `curl -k` umgehen. SSH ersetzt weder TLS noch Enrollment, mTLS oder Anwendungsautorisierung.
|
||
|
||
## Lokale Zugangsdaten und Bootstrapgrenzen
|
||
|
||
- VM-Daten liegen ausschließlich in **`credentials/linux-vm.conf`**. Das Verzeichnis muss in `.gitignore` ausgeschlossen sein; vor Nutzung prüfen. `credentials/` erhält Modus **700**, die Datei **600**; nur der vorgesehene lokale Benutzer hat Zugriff. Auch private Schlüssel/Secretdateien restriktiv schützen. Diese Dokumentationsänderung liest oder verändert keine Zugangsdaten.
|
||
- Die Datei ist **Daten, kein Shellskript**. Nur bekannte Felder mit striktem Parser/Validierung einlesen; unbekannte/ungültige Werte zurückweisen. Niemals `source`, `. credentials/linux-vm.conf`, `eval` oder Shell-Expansion des Inhalts verwenden. Kein bestimmtes vorhandenes Dateischema behaupten oder Secrets für Beispiele öffnen.
|
||
- Keine Secrets in Commits, Logs, Screenshots, stdout/stderr, Shell-Traces (`set -x`), MCP-/LLM-Kontexten oder Jobausgaben. Keine Passwörter in dokumentierten Kommandozeilen. Zugangsdaten weder zur Dokumentationsprüfung noch zum bloßen Auffinden der VM auslesen.
|
||
- Entwicklungs-/Testtools dürfen installiert werden. Zieländerungen auf den vereinbarten Bootstrap (z. B. Agent, Truststore, Hosts-Eintrag) begrenzen. **Keine impliziten Ziel-Reboots, Betriebssystemupdates oder destruktiven Tests**; sie benötigen einen gesonderten ausdrücklichen Auftrag und bei RMM-Ausführung zusätzlich den festen menschlich in der WebUI genehmigten Jobplan. Toolinstallation ist keine allgemeine Zieladministrationsfreigabe.
|
||
|
||
## WebUI-Genehmigung auch in Linux-Dev
|
||
|
||
Jeder Ausführungsjob wird zuerst als Antrag **`pending_approval`** gespeichert. Ein berechtigter Mensch sieht in der WebUI feste Ziele, Einzeljobs/Versuche, Inhalte/Hashes, Fristen und Wirkung und genehmigt genau diesen Plan. Vorher **keine** ausführbaren Jobs/Outbox/JobOffers/Startgrants. Keine Dev-Autofreigabe, Testpolicy, direkte API-/DB-Freigabe oder SSH-Ausführung als vermeintlicher RMM-Erfolgsnachweis. Einzige Ausnahme zur tatsächlichen menschlichen Bedienung ist die folgende ausdrücklich erlaubte dev/test-Browsersimulation, keine Code-Abkürzung.
|
||
|
||
**Userentscheidung 2026-11-12:** „Setz Linux MVP vollständig um und simuliere die menschlichen Aktionen. Du kannst Server auch neustarten“. Ausschließlich für diese Entwicklungsabnahme darf Browserautomatisierung im **expliziten dev/test-Profil** tatsächliche UI-Interaktionen einschließlich Plangenehmigung durchführen. Ein deutlich sichtbar als **simulierter Testprincipal** gekennzeichneter Principal bedient dabei dieselbe UI-Grenze; kein Vortäuschen einer tatsächlichen menschlichen Identität. Planbindung, Rechte-, Tenant- und Policyprüfungen bleiben erhalten. Audit muss `approval_origin` als browsergesteuerte dev/test-Simulation und `testsimulation` als wahr samt Testprincipal, Profil, Zeitpunkt und Planbezug nachvollziehbar kennzeichnen. Das sind Anforderungen, kein Nachweis bereits implementierter Auditfelder. Simulation getrennt von tatsächlicher menschlicher Genehmigung ausweisen, niemals als Produktions-Freigabenachweis. KI/MCP dürfen weiterhin keine direkten API-/DB-Freigaben vornehmen und kein Token erhalten, das die interaktive Grenze unterläuft. Normale UI-Browserrequests bleiben an deren interaktiven Kontext gebunden. Produktionsverhalten bleibt unverändert; dort keine Simulation. Details und Useroverride zum ausgelassenen RustDesk: `docs/project-decisions.md`, normativer Vorrang: Spezifikation 1.5 Kapitel 0.1.
|
||
|
||
Lokale Serverneustarts sind ausdrücklich erlaubt. Dies erlaubt keine impliziten VM-Reboots, Updates oder destruktiven Zieltests und ersetzt keine WebUI-Plangenehmigung; der Zieltestumfang bleibt gesondert ausdrücklich abzustimmen. Diese Dokumentationsänderung führt weder Neustarts noch Simulationen oder Tests aus.
|
||
|
||
Dies gilt für Hello World, Diagnose, `refresh_inventory` als angeforderten Job, Updates, Reboots, Folgejobs und neue Versuche. Passive Standardinventarisierung/Heartbeats und Lesen bereits gespeicherter Daten sind keine Jobs und benötigen keine Einzelgenehmigung. Diese Ausnahme nicht zur Tarnung angeforderter Live-Diagnose nutzen. Solange die UI-Freigabe durch einen berechtigten Menschen oder die eng begrenzte dev/test-Browsersimulation fehlt, bleibt die aktive Teststrecke blockiert; nur unabhängige passive Prüfungen fortführen.
|
||
|
||
## Nachweisprotokoll (Vorlage, kein Testergebnis)
|
||
|
||
Pro Feature festhalten: Spezifikations-/Codeversion, reale VM-OS-/Architektur, tatsächlich ausgeführte Befehle (redigiert), Zeit, Erwartung, beobachtetes Ergebnis, relevante Fehler und verbleibende Gates. Für Jobs zusätzlich Antrag/Planhash, WebUI-Genehmigung mit `approval_origin`/`testsimulation` und tatsächlichem oder simuliertem Principal, Versuch, Journal-/Startnachweis und fachliche Nachbedingungen referenzieren, ohne Secrets zu veröffentlichen. Simulationsnachweise sind keine Produktionsfreigaben.
|
||
|
||
Getrennte Prüfpunkte: Docker-Bindings nur Loopback; SSH-Forward auf VM nur Loopback; DNS-Auflösung auf VM; TLS-Kette und SAN gültig; ungültiges Zertifikat wird verweigert; Enrollment/mTLS; passives Inventar; `pending_approval` ohne ausführbare Artefakte; Ausführung erst nach WebUI-Klick mit eindeutigem tatsächlichem oder simuliertem Ursprung; korrekte Ergebnisse/Redelivery/Tenant-Isolation; Simulation außerhalb dev/test verweigert. **Diese Prüfungen sind hier geplant, nicht ausgeführt.** Destruktive Fehler-/Reboottests nur nach gesonderter Abstimmung durchführen. Fehlender Realnachweis bleibt offen statt grün.
|
||
|
||
Bekannt bleiben Repository `https://gitea.incoso.eu/kevin_janssen/rust-discovery` (SSH: `ssh://git@gitea.incoso.eu:2222/kevin_janssen/rust-discovery.git`) und RustDesk-Server `rust.ease-technologies.de`. Edition, Ports, öffentlicher RustDesk-Serverschlüssel und Version sind noch unbekannt; fehlende Werte führen zu `not_configured`, nicht zu geratenen Defaults.
|
||
|
||
## Tatsächlich ausgeführt: minimaler VM-Zugangscheck (2026-11-12)
|
||
|
||
```sh
|
||
python3 -m py_compile deploy/vm_access_check.py
|
||
python3 deploy/vm_access_check.py
|
||
python3 tests/vm_access_check.py
|
||
python3 -m py_compile deploy/vm_access_check.py tests/vm_access_check.py
|
||
```
|
||
|
||
- Lokale Credential-Modi 0700/0600 und `.gitignore`-Ausschluss geprüft. Inhalte wurden
|
||
ausschließlich im ausführenden Python-Prozess als Daten geparst, nicht ausgegeben.
|
||
- Tatsächlicher SSH-Zugang zur VM mit vorhandenem Benutzer-`known_hosts`-Eintrag und
|
||
`StrictHostKeyChecking=yes` erfolgreich. Keine Hostkeys hinzugefügt oder verändert.
|
||
Das Hilfsskript ignoriert SSH-Konfiguration und nutzt keinen Agent-Forward.
|
||
Passwort-Fallback verwendet bei Bedarf eine temporäre private Datei und Askpass,
|
||
nicht Passwortargumente; private SSH-Fehlerausgaben werden nicht veröffentlicht.
|
||
- Read-only auf der tatsächlichen VM beobachtet: Linux, Ubuntu 24.04, x86-64,
|
||
glibc 2.39; Hostname lesbar und Benutzerhome vorhanden, ohne diese Werte offenzulegen.
|
||
Port 18443 war laut `ss` zum Prüfzeitpunkt frei. Das ist keine spätere Portreservierung.
|
||
- Fünf lokale Parser-Tests bestanden: literale Passwortdaten, unbekannte/doppelte Felder,
|
||
unsichere Dateirechte, ungültiger Port und fehlende Ignore-Regel. Syntaxprüfung bestanden.
|
||
- **In diesem ersten Zugangscheck nicht ausgeführt:** Binärkompatibilitätsprüfung gegen das konkrete Agentartefakt,
|
||
SSH-Reverse-Tunnel, VM-Deployment, Enrollment, VM-Agent/Heartbeat/Inventar und systemd.
|
||
Keine Pakete, Hosts-/Firewall-/sshd-Konfiguration, Updates oder Reboots verändert;
|
||
keine RMM-Jobs oder Genehmigungsumgehungen.
|
||
- Vorbereitung zunächst an Kontextgrenze angehalten: gebündelte Pflichtdokumentausgabe wurde
|
||
abgeschnitten. Vor weiterem Agentbootstrap vollständige Spezifikation und die konkreten
|
||
Deployment-/Agent-Schnittstellen mit zusätzlichem Lesebudget prüfen. Der erfolgreiche
|
||
Zugangscheck ist ausdrücklich kein Linux-M1-/Feature-Abnahmenachweis.
|
||
|
||
## Tatsächlich ausgeführt: passiver VM-Agent über Reverse-Tunnel (2026-11-12)
|
||
|
||
Nach ergänzter vollständiger Pflichtlektüre wurde folgende Strecke tatsächlich ausgeführt:
|
||
|
||
```sh
|
||
python3 -m py_compile deploy/vm_passive_test.py
|
||
python3 deploy/vm_passive_test.py
|
||
python3 tests/vm_access_check.py
|
||
python3 tests/vm_passive_test.py
|
||
python3 -m py_compile deploy/vm_access_check.py deploy/vm_passive_test.py tests/vm_access_check.py tests/vm_passive_test.py
|
||
python3 deploy/vm_access_check.py
|
||
```
|
||
|
||
`deploy/vm_passive_test.py` ist ein bewusst ausführender, begrenzter VM-Test und kein
|
||
reiner Zugangscheck. Er liest Credentials nur intern, prüft vorhandene Langläufer und
|
||
Portbelegung, erzeugt genau ein Enrollment-Token für Dev-Mandant A und hinterlässt
|
||
eine neue Geräteidentität samt Historie. Kein DB-/PKI-Reset und kein Token-/Key-Echo.
|
||
|
||
**Beobachtete Ergebnisse:**
|
||
|
||
- Kein vorhandener PC-Reverse-Tunnel, kein VM-Agentprozess, kein VM-Listener auf 18443
|
||
und kein früheres benutzerlokales Testverzeichnis vorgefunden. Nichts Fremdes gestoppt.
|
||
- Tatsächlich laufender Docker-Server ausschließlich `127.0.0.1:18443`; PostgreSQL
|
||
ohne veröffentlichten Port. Lokaler Healthcheck mit vertrauenswürdiger CA bestanden.
|
||
- Agentartefakt aus dem bereits laufenden Docker-Server kopiert, kein neuer Imagebuild:
|
||
Linux-x86-64-ELF, höchste referenzierte glibc-Version 2.34; VM hat glibc 2.39.
|
||
Alle ELF-`NEEDED`-Bibliotheken im VM-Laufzeitcache gefunden. Vor nativem Agentstart
|
||
VM-Loader `/lib64/ld-linux-x86-64.so.2 --list` gegen das konkrete Artefakt erfolgreich.
|
||
SHA-256: `667065dded71cc499b171bc799ad09f3ac7f049a72a9d54f4c943331a565eefe`.
|
||
- PC initiierte SSH mit `-N -T`, `StrictHostKeyChecking=yes`,
|
||
`ExitOnForwardFailure=yes`, Keepalive 30/3 und
|
||
`-R 127.0.0.1:18443:127.0.0.1:18443`. VM-seitig per `ss` genau dieser
|
||
IPv4-Loopbacklistener bestätigt. Keine Hostkey-/sshd-/Firewalländerung.
|
||
- Nur Binary, öffentliche CA und einmaliges Token per SSH-stdin in ein neues privates
|
||
Benutzer-Testverzeichnis übertragen. Geräteschlüssel auf der VM erzeugt; kein CA-/Server-
|
||
Privatschlüssel oder Viewer-Bearer übertragen. Kein Root-/systemd-/Paketbootstrap.
|
||
- Native VM-Agentstrecke mit `RMM_CONNECT_ADDR=127.0.0.1:18443`, eigenem privaten Zustand
|
||
und CA gestartet. Der vorhandene Override verändert nur TCP; Enrollment und WSS
|
||
prüfen weiterhin TLS-SNI/DNS-Namen `rmm-dev.internal`. Kein Hosts-Eintrag nötig,
|
||
keine Zertifikatsprüfung deaktiviert; keine Rust-/Protokolländerung erforderlich.
|
||
- Über echte tenantgebundene Lese-API exakt diese neue Agent-ID zugeordnet:
|
||
Inventar-Erhebungszeit **16:40:12.632 UTC**, Empfang **16:40:12.796518 UTC**;
|
||
Hostname intern mit SSH-Baseline verglichen, ohne ihn zu veröffentlichen.
|
||
OS Ubuntu 24.04, x86-64, tatsächlich verfügbare Root-Bytes und Inodes positiv,
|
||
Scope `linux.base`, Vollständigkeit `partial`, fachliche Gesundheit `unknown`.
|
||
- Zwei verschiedene frische Heartbeats serverseitig beobachtet:
|
||
**16:40:44.849118 UTC** und **16:41:12.779675 UTC**; Präsenz `online`.
|
||
Der Gateway-Code aktualisiert `last_contact_at` ausschließlich im Heartbeat-Zweig.
|
||
Leser von Dev-Mandant B sah diese Agent-ID nicht.
|
||
- Enrollment-Tokenkopie auf der VM entfernt. Test-Agent-PID **4141792** per SIGTERM
|
||
gestoppt, vorher exakten `/proc/PID/exe`-Pfad geprüft; anschließend Prozessende geprüft.
|
||
Nur den eigenen SSH-Tunnel-PID **1869118** beendet und auf Prozessende gewartet.
|
||
Geschütztes lokales Nachweisprotokoll mit PIDs, Zeitpunkten und privatem Remotepfad:
|
||
`devstate/vm-passive/result.json`. Kein aktiver verwalteter Testrecord zurückgeblieben.
|
||
Privates VM-Testverzeichnis mit Geräteidentität und Log bleibt für kontrollierte
|
||
Fortsetzung erhalten, keine laufende Installation. Secrets/Logs daraus nicht veröffentlichen.
|
||
- Fünf Parser-Tests erneut bestanden; drei lokale Orchestrierungs-Guardtests bestanden
|
||
(Fail-closed, private Fehlerausgaben unterdrücken, Remote-Code nur über stdin).
|
||
Python-Syntaxprüfung bestanden. Abschließender tatsächlicher lesender VM-SSH-Check
|
||
nach dem Test erfolgreich; VM-Port 18443 wieder frei.
|
||
Keine Rust-Änderungen, daher Rust-Build/Clippy und übrige Integrationstests hier nicht erneut ausgeführt.
|
||
|
||
**Verbleibend:** Kein systemd-/Dienst-/Installer-Nachweis, keine Rotation, Ablauf-Recovery,
|
||
Long Polling, Reconnect-/Widerrufsabnahme auf VM, Proxy-/Klon-/Restore-/Lastabnahme.
|
||
Keine Jobs, WebUI-Freigaben, Updates oder Reboots ausgeführt. Der passive VM-Erstnachweis
|
||
ist erfolgreich, **M1 insgesamt und Linux-MVP bleiben unabgenommen**.
|