Files
rust-discovery/docs/development.md
T
2026-11-15 23:41:14 +01:00

336 lines
28 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Linux-first-Entwicklung und reale VM-Abnahme
Stand: 2026-11-15 · Spezifikation 1.25. 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.
## Aktuelle MVP-Anmeldung über SSH-Tunnel (Version 1.25)
WebUI und MCP bleiben an Server-Loopback gebunden. Für den aktuellen MVP
ist kein OIDC-Anbieter erforderlich. Der Betreiber erlaubt den bestehenden
Entwicklungslogin und die sichtbar simulierte Browsergenehmigung des festen
PowerShell-Testplans. Die OIDC-Bedingung des begonnenen administrativen
Recoverywegs ist keine Voraussetzung dieser begrenzten Testabnahme.
Die festen Scriptbytes, Ziele, Grenzen, Auditdaten und der normale signierte
Jobpfad bleiben erforderlich. Nachweise siehe [server-deployment.md](server-deployment.md)
und [windows-profile-acceptance.md](windows-profile-acceptance.md).
## 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**.