feat: snapshot Linux-first RMM MVP and pause handover
Rust development slice / linux (push) Failing after 1m10s
Rust development slice / linux (push) Failing after 1m10s
This commit is contained in:
@@ -0,0 +1,188 @@
|
||||
# Linux-first-Entwicklung und reale VM-Abnahme
|
||||
|
||||
Stand: 2026-11-12 · Spezifikation 1.5. Dieses Dokument beschreibt verbindliche Entwicklungsregeln und einen grundsätzlich **geplanten** Ablauf. Tatsächlich ausgeführte Prüfungen stehen ausdrücklich im Nachweisabschnitt am Ende; die übrigen Beispiele sind keine Testergebnisse. Tatsächlicher Implementierungsstand wird separat geführt.
|
||||
|
||||
## 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**.
|
||||
@@ -0,0 +1,163 @@
|
||||
# Übergabe / Entwicklungspause — 2026-11-12
|
||||
|
||||
**Auf Userwunsch pausiert. Linux-MVP M0–M5 ausdrücklich NICHT vollständig
|
||||
abgenommen; keine Produktionsfreigabe.** Dieser Durchgang sichert Dokumentation
|
||||
und prüft veröffentlichbare Quellen. Keine Entwicklung, Builds, Tests,
|
||||
Deployments oder RMM-Jobs fortsetzen. Commit/Push ist ein separater Schritt des
|
||||
Orchestrators nach Sicherheitsprüfung; hier weder Staging noch Commit/Push.
|
||||
|
||||
## Einstieg und verbindliche Grenzen
|
||||
|
||||
- Repository: <https://gitea.incoso.eu/kevin_janssen/rust-discovery>;
|
||||
SSH: `ssh://git@gitea.incoso.eu:2222/kevin_janssen/rust-discovery.git`.
|
||||
Remote vor Veröffentlichung erneut prüfen; keine erfolgreiche CI behaupten.
|
||||
- Zuerst vollständige Spezifikation 1.5, `AGENTS.md`,
|
||||
`docs/project-decisions.md` und `docs/development.md` lesen. Windows erst nach
|
||||
Linux-MVP-Abnahme; PVE/PBS/Cluster/Backups nachgelagert. **RustDesk AUS**,
|
||||
keine Installation/Provisionierung/Desktopabnahme oder eigene Desktop-Engine.
|
||||
- Jeder Job beginnt als persistenter Antrag `pending_approval`. Vor Genehmigung
|
||||
**0 Jobs/Outbox/Startgrants**, keine JobOffers/Wirkung. Nur interaktive WebUI
|
||||
genehmigt den unveränderlichen Plan; MCP/KI dürfen nicht selbst genehmigen,
|
||||
keine direkte API-/DB-Freigabe. Policies begrenzen/verweigern nur.
|
||||
- Dev/test-Browserbedienung ausschließlich sichtbar **SIMULIERT**, Audit mit
|
||||
`approval_origin=dev_test_browser_simulation`, `testsimulation=true`,
|
||||
Testprincipal und Planbezug. Kein menschlicher Produktionsfreigabenachweis.
|
||||
Neue Versuche/neue Wirkung brauchen neuen genehmigten Plan; unklare Wirkung
|
||||
bleibt `unknown`, nicht blind wiederholen.
|
||||
|
||||
## Plattform und sicherer finaler Pausenzustand
|
||||
|
||||
Server lokal in Docker auf dem PC, TLS nur `127.0.0.1:18443`, PostgreSQL intern
|
||||
ohne publizierten Port. PC-initiiertes SSH im Devmodus: `-N -T`, strikte
|
||||
Hostkeyprüfung, `ExitOnForwardFailure=yes`, Keepalive 30/3 und
|
||||
`-R 127.0.0.1:18443:127.0.0.1:18443`. VM-Agent ausgehend über Loopback;
|
||||
TLS Ende-zu-Ende mit vertrauenswürdiger Dev-CA und SAN/SNI `rmm-dev.internal`.
|
||||
Connect-Override darf nur TCP ändern, niemals Namens-/Zertifikatsprüfung.
|
||||
Netzwerkagent unprivilegiert als `rmm-agent` (UID 993, Gruppe 984), Roothelper
|
||||
separat; kein Root-Netzwerkagent.
|
||||
|
||||
**Finales VM-Worker-Verdikt, in `docs/implementation-status.md` protokolliert:**
|
||||
|
||||
- Agent und beide Helper (`rmm-agent.service`, `rmm-helper-dev-test.service`,
|
||||
`rmm-apt-helper.service`) **inactive**; kein Reversetunnel/VM-18443-Listener.
|
||||
- Rootledger **0 consumed / 0 unknown**, kein laufender Installer-/Paket-/Rebootjob.
|
||||
Einziger VM-Joberfolg bleibt der frühere Hello-World-Lauf; keine neuen Jobs,
|
||||
Anträge oder Genehmigungen im letzten Upgrade-/Pauselauf.
|
||||
- Lokaler Docker-Server und PostgreSQL laufen bewusst weiter, Portbindung wie
|
||||
oben. Kein pauschales „alles gestoppt“. Letzter zuvor gemeldeter Serverstart
|
||||
20:49:18 UTC ist kein hier erneut erhobener Startzeitnachweis.
|
||||
- Aktuelle Bookworm-Releaseartefakte für Agent/Helper gebaut und konkrete
|
||||
VM-Loaderprüfung bestanden (glibc 2.34/OpenSSL 3). Runtimeupgrade bewahrte
|
||||
Identität und Journal-Dateibytes/SQLite-Schema/Rows. Alte Artefakte/Backups bleiben.
|
||||
- Bekannte Fixturearchive administrativ versiegelt, **keine Paketinstallation**.
|
||||
Tatsächliche dedizierte APT-Probe **FEHLGESCHLAGEN**:
|
||||
`APT_CONTROLLER_PROFILE_REQUIRED`, Start-Exit 1. Keine Native-Readiness,
|
||||
Native-Acceptance oder Paketwirkung; Helper danach kontrolliert gestoppt.
|
||||
Unit-Härtung wurde nicht zur Umgehung gelockert.
|
||||
|
||||
## Funktionen und Nachweise — Ebenen nicht vermischen
|
||||
|
||||
| Bereich | Lokal / Entwickler-PC | Tatsächliche Linux-VM |
|
||||
|---|---|---|
|
||||
| TLS/Enrollment/Inventar | Lokale Integrationsnachweise vorhanden | Passives Inventar und Heartbeats früher belegt |
|
||||
| MCP → UI → Grant → Agent | Gemeinsame Plan-/Antragsstrecke implementiert | Früherer Hello World unter unprivilegiertem systemd-Agent: genau 1 Grant, 1 Wirkung; Journal/Ergebnis belegt |
|
||||
| Roothelper | Neue Root-/APT-/Sync-Schnittstellen implementiert | Readiness des **alten** Profils belegt; neues Runtime installiert, APT-Probe fehlgeschlagen, keine vollständige Rootaktionsabnahme |
|
||||
| Paket/Update/Dienst/Reboot | Adapter und Sicherheitsprüfungen vorhanden | Aktuelle UI-genehmigte native Wirkungskette weiterhin offen |
|
||||
| OIDC/WebUI | OIDC-Adapter implementiert, externe IdP-Konfiguration `not_configured`; Dev-UI-Testactor simuliert | Kein produktiver IdP-/MVP-Abnahmenachweis |
|
||||
| Replay/ACK-Verlust | Lokale Regressionspfade vorhanden | Native Fault-Injection für duplicate_offer/lost_result_ack **unsupported**, nicht grün |
|
||||
|
||||
Letzte getrennte, von den jeweiligen Sourceownern dokumentierte Prüfstände,
|
||||
**in dieser Übergabe nicht erneut ausgeführt und nicht zu einer Summe addieren**:
|
||||
|
||||
- Client: **115 Rust-Alltargets-, 56 Python-APT-, 2 Installer-Guardtests**;
|
||||
Clippy/Format, Debug/Release grün (`deploy/linux/runtime-README.md`). Dies ist
|
||||
der letzte vollständig validierte Client-Quellstand, nicht „alles aktuell grün“.
|
||||
PC-Artefakte sind nicht mit dem separaten Bookworm-/VM-Loaderbeleg gleichzusetzen.
|
||||
- UI: zuletzt **23 Unit- und 5 TLS-Browsertests** gemeldet; OIDC **13 + 1 PG**
|
||||
sowie **35 integrierte Assertions**. Backend **150 Assertions**, Transport
|
||||
**38**, Rootlog **15** als bestehende getrennte Snapshotnachweise. Verträge und
|
||||
Prüfkontext: `web/README.md`, `crates/server/OIDC.md`, `tests/oidc/README.md`,
|
||||
`proto/BACKEND_CONTRACT.md`. Keine neue Ausführung/CI-Verifikation in der Pause.
|
||||
- Backend zuletzt mit Rootlogs-Image/Migrationen 1–12 gemeldet; Runtime-/VM-Probe
|
||||
ist ein separater Nachweis und macht offene Funktionstests nicht erfolgreich.
|
||||
|
||||
## Bekannter ungeprüfter Snapshotfehler — NICHT jetzt korrigieren
|
||||
|
||||
Die letzte Änderung der `SERVICE_SETUP`-Skriptbytes in
|
||||
`deploy/vm_mvp_adapters.py` für den vorerzeugten leeren Unit-Inode wurde **nicht
|
||||
erneut getestet**. Alte SHA-Pins stehen noch in
|
||||
`tests/browser/mvp-actions.spec.ts` (service_setup-Prüfung) und
|
||||
`tests/vm_mvp_guards.py` (Setup-Hashassertion). Bei Wiederaufnahme zuerst Bytes,
|
||||
Browser-Pin und Guard-Pin konsistent anpassen und gezielt prüfen. Frühere
|
||||
**28 Guards** sind **kein finaler Nachweis** dieser Änderung. Absichtlich keine
|
||||
Reparatur im angeforderten Pause-/Snapshotdurchgang.
|
||||
|
||||
## Wiederaufnahme — erst nach neuem Auftrag, nichts davon hier ausgeführt
|
||||
|
||||
1. Erhaltenen Zustand und feste Geräte-/Job-/Versuchsbindung kontrollieren.
|
||||
Den tatsächlichen Controllerprofilfehler gegen `verify_controller_profile()`
|
||||
**zuerst diagnostizieren**, vor weiteren Mutationen/Proben. Keine Härtung,
|
||||
Capability-, Peer-, Pin-, Sync- oder Genehmigungsgrenze blind abschwächen.
|
||||
Den oben dokumentierten Skript-/SHA-Konflikt vor Suiteausführung beheben.
|
||||
2. Bookworm-Artefakt/Deploymentmanifest, tatsächliche Unit-/Public-Pins,
|
||||
getrennte Helperledger und dedizierte RPC-/APT-Readiness prüfen. Build und
|
||||
Loadercheck liegen vor, Native-APT-Probe dagegen nicht bestanden.
|
||||
3. Frischen Peer-/Sync-/passiven Planungsnachweis und aktuelle Baseline erheben;
|
||||
anschließend einzeln UI-genehmigte Rootdienst-/Paket-/Updatefälle. Fixture
|
||||
nach Upgrade auf **1.1**, fresh baseline und gewünschte Noop-Nachbedingungen
|
||||
konsistent halten; keine heimliche Entfernung/Downgrade/Reset von Paketstate.
|
||||
4. HTTPS-Transport, Rotation, Reconnect, Ablauf/Cancel, Reboot zuletzt mit eigener
|
||||
Recovery und neuer Boot-ID sowie tatsächliche Wirkung/Nachprüfung abnehmen.
|
||||
Duplicate-/lost-ACK-Nativefaultadapter fehlen weiterhin; nicht durch zweiten
|
||||
Job als vermeintliche Redelivery ersetzen. Vor jedem Job erneut 0/0/0-Gate.
|
||||
5. Linux-MVP erst nach vollständigen realen Feature-/Fehlernachweisen abnehmen.
|
||||
Bestehende Identität/Journale/Backups niemals löschen oder neu enrollen, um
|
||||
Tests grün zu machen. Create-only Bootstrapphasen nicht blind wiederholen.
|
||||
|
||||
## Quellnavigation, Befehle und geschützte Evidenz
|
||||
|
||||
- Agentbetrieb/Config: `deploy/linux/runtime-README.md`, `deploy/linux/README.md`;
|
||||
APT: `deploy/linux/apt-helper-README.md`,
|
||||
`tools/apt-transaction/HELPER-CONTRACT.md`; Backend/Rootlogpolicy:
|
||||
`proto/BACKEND_CONTRACT.md` (`RMM_ROOT_LOG_UNITS` und zugehörige Grenzen,
|
||||
Rootlogs standardmäßig verweigert); Login: `crates/server/OIDC.md`.
|
||||
- Bestehende Kernbefehle in `README.md`: `python3 deploy/dev.py init|up|status`,
|
||||
CA-verifizierter `/healthz`-Check und `python3 deploy/dev.py down` ohne
|
||||
Datenlöschung. **Hier nur nachgelesen, nicht ausgeführt.** `init` überschreibt
|
||||
keinen vorhandenen Zustand; `up` baut/startet und ist keine Pauseaktion.
|
||||
Die älteren Funktionsaussagen in README/unteren Statusabschnitten sind
|
||||
historische Slices; aktueller finaler Pauseabschnitt hat für diesen Snapshot Vorrang.
|
||||
- Geschützt/gitignored: `devstate/vm-jobs/result.json` (Hello World),
|
||||
`devstate/vm-root/` (historische Rootreadiness),
|
||||
`devstate/vm-final/68741ab0b1c84e15bf3fc442bd812558/`
|
||||
(`build.json`, `install.json`, `probe-diagnostic.json`; kein erfolgreicher probe.json).
|
||||
VM-seitig: `/var/lib/rmm-bootstrap-history/68741ab0b1c84e15bf3fc442bd812558/`
|
||||
und `/etc/rmm/runtime-v2-probe-report.json`. Nur Pfade, keine privaten Inhalte.
|
||||
- Zugangsdaten/Rohlogs/Schlüssel bleiben unter `credentials/`, `.env`,
|
||||
`secrets/`, `devstate/` bzw. geschütztem VM-State. Nie in Git/Chat/Jobausgaben;
|
||||
0700-Verzeichnisse/0600-Secretdateien, Daten strikt parsen, kein source/eval.
|
||||
Keine VM-Adressen, Passwörter, privaten Agentkeys oder Tokens veröffentlichen.
|
||||
- Vor Staging ausschließlich nichtignorierte Quellpfade aus
|
||||
`git ls-files --cached --others --exclude-standard` prüfen; echte PEM-Blöcke,
|
||||
Credentialliterale, private Laufzeitdateien/Adressen und Browsertraces melden
|
||||
**nur als Anzahl, Pfad, Regel**, niemals Matchzeilen. Build-/Browsercaches nicht
|
||||
veröffentlichen. `.env.example` mit Platzhaltern und generierte Testfixtures
|
||||
sind nicht automatisch echte Zugangsdaten. Keine Userdateien verschieben/löschen.
|
||||
|
||||
### Sicherheitsprüfung dieses Übergabedurchgangs
|
||||
|
||||
Nichtignorierte Sourcepfade: **194**, alle 194 auf echte vollständige private
|
||||
PEM-Blöcke, auffällige Credentialliterale/Providertokens, nichtbeispielhafte
|
||||
IPv4-Adressen und private Laufzeit-/Binärdateinamen geprüft. **Keine bestätigten
|
||||
Leakfindings.** Ein Literal-Kandidat in `crates/oidc-auth/src/tests.rs` wurde als
|
||||
ungenutzter synthetischer Access-Token der lokalen Mock-Providerantwort geprüft
|
||||
und verworfen; Schlüssel der Tests werden zur Laufzeit generiert. Keine
|
||||
Credentialdateien für diese Prüfung gelesen, kein Secretvergleich erforderlich.
|
||||
Das ist eine heuristische Sourceprüfung, keine Garantie über unbekannte Secrets.
|
||||
|
||||
Ignore-Ausschluss ausdrücklich bestätigt für `crates/oidc-auth/target/`,
|
||||
`devstate/`, `credentials/linux-vm.conf`, `web/node_modules/`, lokale
|
||||
Testresults/Playwrightreports. Root-Ignore ergänzt um verschachtelte `target/`
|
||||
und präzise private Browsertrace-/Reportpfade. Keine Source-/Testverzeichnisse
|
||||
pauschal ausgeschlossen. Vor tatsächlichem Staging erneut prüfen, da parallele
|
||||
Änderungen diesen Snapshot verändern können.
|
||||
@@ -0,0 +1,931 @@
|
||||
# Tatsächlicher Implementierungsstand
|
||||
|
||||
## ENTWICKLUNG PAUSIERT auf Useranweisung — Übergabe 2026-11-12
|
||||
|
||||
Kompakter Einstieg, bekannte ungeprüfte Snapshotfehler und Fortsetzungsgates:
|
||||
[handover.md](handover.md). Die nachfolgenden Worker-Nachweise bleiben erhalten.
|
||||
|
||||
User hat aktuelle Entwicklung unterbrochen und Push/Übergabe angefordert.
|
||||
**Keine weiteren Implementierungen, Builds, Tests, Deployments, Anträge oder
|
||||
Folgejobs starten.** Git-Commit/Push übernimmt der zuständige Orchestratorworker;
|
||||
dieser VM-Worker hat weder Commit noch Push ausgeführt.
|
||||
|
||||
### Unmittelbar vor Pause tatsächlich abgeschlossen
|
||||
|
||||
- Neuer `deploy/vm_runtime_upgrade.py`: versionierter Bookworm-Agent-/Helperbuild,
|
||||
strikter Vergleich mit eigenen alten Deploymenthashes, Root-private atomare
|
||||
Backups, Loaderprüfung vor Binärwechsel, erhaltene Identitäten/SQLite-Journale,
|
||||
neue getrennte Helperkonfigurationen/Public-Pins und dedizierter APT-Probeaufruf.
|
||||
- Tatsächlicher neuer Docker-Releasebuild beider Binaries erfolgreich. Build-ID
|
||||
**68741ab0b1c84e15bf3fc442bd812558**, Kontext 1.433 MB; beide ELF x86-64,
|
||||
maximal glibc **2.34**, OpenSSL **3**, konkrete VM-Loaderauflösung bestanden.
|
||||
Agent SHA256 `46821cc7544019830507ffaa0c5385f88f7b645a5a1d1c8a54aa56ebbd8e8f20`;
|
||||
Helper `f867ac51e82fc7d0f0050cb7629e1ff92d8af9b493d6cb8ae4839accb5694e30`.
|
||||
Source-/Artefaktmanifest und getrennte, nur vom Sourceowner berichtete
|
||||
115/56/2-Testreferenz unter `devstate/vm-final/<Build-ID>/build.json`.
|
||||
Diese 115 Rust-/56 APT-/2 Installertests wurden hier **nicht erneut ausgeführt**.
|
||||
- Tatsächlicher kontrollierter VM-Upgrade erfolgreich, Stage
|
||||
`installed_not_started`. Vor/nach Installation Agent- und Helperstate inklusive
|
||||
Dateibytes/SQLite-Schema/Rows identisch, keine Reenrollment-/Journal-/PKI-Resets.
|
||||
Vorhandene alte Binärdateien/Units und nachweislich unbenutzte alte Provider-
|
||||
Code-/Storedirectories bleiben Root-privat erhalten unter
|
||||
`/var/lib/rmm-bootstrap-history/<Build-ID>/report.json` samt zugehörigen Backups.
|
||||
- Neue Rootkonfigurationen `/etc/rmm/helper-general-v2.json`, `apt-helper.json`,
|
||||
Public-Pins `general-helper-proof-v2.json`, `apt-helper-proof-v2.json` (Root,
|
||||
Gruppe984 lesbar 0640), Agent-Drop-ins `20-runtime-v2.conf` und
|
||||
`21-log-units-v2.conf`, private Logunit-Allowlist. Schlüssel/Journale nicht ersetzt.
|
||||
Generalhelper bleibt ohne SYS_ADMIN/MKNOD, Rootscripts/Reboot bleiben false.
|
||||
Nur genau ein vorerzeugter leerer Root-0600-Inode
|
||||
`/etc/systemd/system/rmm-mvp-test.service` ist als späteres UI-Schreibziel
|
||||
freigegeben, **keine gültige Business-Testunit eingerichtet/gestartet**.
|
||||
Kein pauschales ReadWritePaths=/etc. Ausschließlich adjtimex-Read-Ausnahme
|
||||
zusätzlich zum weiter beschränkten Generalprofil, keine SYS_TIME-Capability.
|
||||
- Tatsächliche administrative Fixturevorbereitung über festes
|
||||
`provision-fixture-store` erfolgreich: bekannte versiegelte Fixturearchive und
|
||||
Root-private Baseline-/Prefetchmetadaten, **keine Paketinstallation**.
|
||||
|
||||
### Konkreter offener Native-Probe-Fehler / sicherer Endzustand
|
||||
|
||||
Dedizierte tatsächliche `rmm-apt-helper.service`-Probe wurde gestartet und scheiterte
|
||||
**vor** Native-Readiness-Publikation mit statischem Sourcefehler
|
||||
**APT_CONTROLLER_PROFILE_REQUIRED**. Systemctl-Start Exit **1**,
|
||||
Result=exit-code; im Fehlerzeitpunkt SubState=auto-restart. Root-private Diagnose
|
||||
enthält Exceptionklasse RuntimeError und generierte Zeilen 183/6; keine privaten
|
||||
Exceptioninhalte/Logs veröffentlicht. Keine Probedateien, keine
|
||||
native-readiness.json und keine Native-Acceptance-/Job-/Grantbelege erzeugt.
|
||||
RootGate/SDK-/Providercode wurde **nicht** zur Umgehung gepatcht. Fehlerursache
|
||||
innerhalb des tatsächlichen Controllerprofils ist noch nicht weiter eingegrenzt;
|
||||
kein erneuter Probeversuch nach Userpause.
|
||||
|
||||
Unmittelbare, ausschließlich lesende Pauseprüfung bestätigt:
|
||||
|
||||
- `rmm-agent.service`: **inactive**
|
||||
- `rmm-helper-dev-test.service`: **inactive**
|
||||
- `rmm-apt-helper.service`: **inactive**, kontrolliert nach nachgewiesen leerem
|
||||
Rootverbrauch gestoppt; kein aktiver automatischer Neustart mehr
|
||||
- **kein VM-18443-Reverselistener**, kein von diesem Lauf gestarteter PC-Tunnel
|
||||
- Rootledger **0 Verbräuche / 0 ungeklärte Verbräuche**
|
||||
- Serverseitig für die erhaltene VM ausschließlich **1 succeeded** (historischer
|
||||
früherer Hello-World-Job), **keine neuen RMM-Jobs/Genehmigungen/Anträge**
|
||||
- Lokaler Projekt-Docker **server running**, ausschließlich
|
||||
**127.0.0.1:18443**, **postgres running** ohne publizierten Datenbankport;
|
||||
für User bewusst unverändert laufengelassen
|
||||
- Kein laufender Installer-/Paket-/Rebootauftrag dieses Workers. Letzter Build-
|
||||
Hintergrundprozess war bereits erfolgreich beendet, kein Build zu stoppen.
|
||||
|
||||
Geschützte Übergabeevidenz: `devstate/vm-final/<Build-ID>/{build,install,probe-diagnostic}.json`,
|
||||
auf VM `/etc/rmm/runtime-v2-probe-report.json` und oben genannter Root-Backupreport.
|
||||
Da die Probe fehlschlug, wurde lokal **kein erfolgreicher probe.json** erzeugt.
|
||||
Keine Backup-/Journal-/Identitydateien entfernen oder die create-only Phasen
|
||||
blind erneut aufrufen. Installierte neue Laufzeit bleibt absichtlich gestoppt.
|
||||
|
||||
### Quelländerungen und noch ungeprüfte Arbeit
|
||||
|
||||
- Neues Upgradehelper-Skript wie oben; Änderungen an
|
||||
`deploy/vm_mvp_adapters.py`, `deploy/vm_mvp_acceptance.py`,
|
||||
`deploy/vm_mvp_runtime.py`, `tests/browser/mvp-actions.spec.ts` und
|
||||
`tests/vm_mvp_guards.py` für gewünschte **1.1** im normalen Ensure-Job,
|
||||
UPDATE-Rezept/fresh-baseline/Noopflags und begrenztes vorerzeugtes Unit-Inodeziel.
|
||||
Keine Änderungen an gemeinsamen Client-/Helper-/Backend-/Domain-/APTtool-Sources.
|
||||
- **28 MVP-Guardtests und Syntaxprüfung waren vor der letzten Änderung der
|
||||
SERVICE_SETUP-Bytes erfolgreich.** Danach wurde das Setupskript an den leeren
|
||||
vorerzeugten Inode angepasst; dabei sind die hart gepinnten bisherigen
|
||||
Script-SHA-Konstanten in Browser/Guardtests **noch nicht nachgezogen/geprüft**.
|
||||
Dieser bewusst offene Arbeitsstand muss bei Wiederaufnahme zuerst konsistent
|
||||
gemacht werden. Nicht als aktuell vollständig grüne Testsuite ausgeben.
|
||||
- Keine weiteren Tests oder Format-/Buildprüfungen nach Pause ausgeführt.
|
||||
Kein neues UI-/MCP-Ausführungsergebnis, kein Paket-/Diensttest-/Update-/Reboot-
|
||||
Nachweis. Rootscope auf Server wurde von diesem Worker nicht aktiviert,
|
||||
kein lokaler Serverrestart und keine Rollen-/Freigabe-DB-Manipulation.
|
||||
- Zuerst tatsächliches dediziertes Controllerprofil gegen
|
||||
`verify_controller_profile()` diagnostizieren; Härtung nicht blind lockern.
|
||||
Danach neue Peer-/Sync-/Passive-planning-Nachweise und erst dann einzeln
|
||||
WebUI-genehmigte Jobs. Aktueller Stand ist **keine Linux-MVP-Abnahme**.
|
||||
|
||||
## Neuester Adapterstand: 15 Fälle nach aktuellem Backend-/APT-/Sync-Vertrag
|
||||
|
||||
Die vorher unten als `pending_protocol` bezeichneten neun Fälle sind **nicht mehr
|
||||
pauschal wegen unbekannter Routen gesperrt**. Aktuelle Verträge aus
|
||||
`proto/BACKEND_CONTRACT.md`, `deploy/linux/apt-helper-README.md`,
|
||||
`tools/apt-transaction/HELPER-CONTRACT.md`, `tests/agent_sync/README.md` und
|
||||
`tests/agent_transport/README.md` wurden herangezogen. **Kein VM-Nativlauf wurde
|
||||
in diesem Adapterincrement gestartet; das aktuelle Client-Wire-up-Verdikt fehlt.**
|
||||
|
||||
### Executorabdeckung (Code vorhanden, nicht nativ abgenommen)
|
||||
|
||||
| Case | Executorstatus / konkretes Laufzeitgate |
|
||||
| --- | --- |
|
||||
| `hello` | ready_adapter; echter frischer nichtprivilegierter Agent, aktueller Sync |
|
||||
| `refresh_inventory` | ready_adapter; linux.base und neue gebundene Erhebungszeit |
|
||||
| `query_logs` | ready_adapter; exakte Testunit-Allowlist, fünf Minuten/50 Zeilen/64 KiB |
|
||||
| `service_setup` | ready_adapter; festes UI-Rootskript, echte Rootpolicy und geprüfte Schreibpfade erforderlich |
|
||||
| `service_start` | ready_adapter; ausschließlich rmm-mvp-test.service, tatsächlicher Helperpolicy-/Syncnachweis |
|
||||
| `service_stop` | ready_adapter; dieselbe Unit, feste Reihenfolge setup/start/stop |
|
||||
| `apt_native_install` | ready_adapter; schema-2-Manifest, passiver/genehmigter Planungsdatensatz, Rootprobe, versiegeltes Archiv 1.0 |
|
||||
| `apt_native_update` | ready_adapter; entsprechendes 1.0→1.1-Manifest und echte aktuelle 1.0-Baseline |
|
||||
| `ensure_package` | ready_adapter; vollständiges apt-execute-Manifest und echter install-Rezept-Acceptancebeleg |
|
||||
| `apply_updates` | ready_adapter; festes Testpaket, reboot_policy=never, echtes Upgrade-Rezept und Acceptance |
|
||||
| `duplicate_offer` | unsupported_native_fault_injection; separater ausführbarer Originalresult-Replay-Regressionsdriver vorhanden |
|
||||
| `lost_result_ack` | unsupported_native_fault_injection; derselbe Driver, kein behaupteter ACK-Verlusttest |
|
||||
| `cancel_queued` | ready_adapter; eigener Agent vorher inaktiv, feste future-start Hello-Bytes, UI-Antrag, MCP-Cancel, null Grants |
|
||||
| `expired_offline` | ready_adapter; eigener Agent offline, feste 60-s-Frist, Wiederanmeldung erst danach, expired und null Grants |
|
||||
| `reboot_last` | ready_adapter; eigener Lifecycle, tatsächliche Root-Rebootpolicy, Checkpoint vor UI-Klick, neue Boot-ID/Inventar/Sync/Result |
|
||||
|
||||
Neue Module `deploy/vm_mvp_adapters.py` und `deploy/vm_mvp_runtime.py` enthalten
|
||||
die tatsächlichen Executorpfade, nicht nur einen Statuskatalog. Core, separater
|
||||
Browserrunner/-test und Guards sind angepasst. Keine Änderungen an gemeinsamen
|
||||
Agent-/Helper-/Backend-/Domain-/APTtool-/WebUI-Quelldateien.
|
||||
|
||||
### Plan-/Freigabe- und Lifecyclegrenzen
|
||||
|
||||
- Nonroot-Fälle planen/beantragen über echten MCP 2025-11-25. Rootfälle verwenden
|
||||
**echte UI-Planerstellung und UI-Submit durch den simulierten Testhuman**, weil
|
||||
der Default-Automatisierungstoken bewusst kein root:execute besitzt. Keine
|
||||
Membership-/Scope-DB-Änderung, kein geborgter Cookie und kein direkter
|
||||
Freigabe-API-Aufruf. Erste Browserphase verlässt den Antrag pending_approval
|
||||
ohne Genehmigungsrequest; MCP liest denselben gespeicherten Antrag nach.
|
||||
- Danach werden null Jobs/Outbox/Grants verifiziert und IDs/Versuch/Planhash privat
|
||||
gespeichert. Beim Reboot zusätzlich native alte Boot-ID; ein Bootwechsel noch
|
||||
vor Genehmigung sperrt den Klick. Erst die zweite Browserphase prüft sämtliche
|
||||
exakten angezeigten Plan-/Skript-/Manifestbytes und klickt Checkbox/Button.
|
||||
Audit bleibt explizit dev_test_browser_simulation/Testprincipal, kein Mensch-
|
||||
oder Produktionsnachweis. Browser-Zeitzone ist für die UI-Minutenfelder UTC;
|
||||
die tatsächlich erzeugten gespeicherten Bytes werden erneut vollständig geprüft.
|
||||
- Rootpolicy kommt aus frischem UID993-IPC mit Root-SO_PEERCRED, Root-eigenem
|
||||
unabhängig provisioniertem Public-Pin, Nonce, Identität/Generationen, aktuellem
|
||||
authentisiertem Signingkey und exaktem Policydigest. APT verwendet ausschließlich
|
||||
den dedizierten Socket/Stackpin. Beide Profile müssen dieselben Ledger-/Lock-
|
||||
Geräte und Inodes melden. Ein Capabilitystring oder Benutzerartefakt genügt nie.
|
||||
- Technischer Runtimeadapter übernimmt nur inaktiven Agent/Tunnel oder bricht ab;
|
||||
verifiziert installierte aktuelle Buildhashes, erhaltene Identität, UID, tatsächliche
|
||||
Prozess-UID, NoNewPrivileges und keine effektiven/ambienten Agentcapabilities.
|
||||
Er erzeugt nur eigenen versionierten Transport-Drop-in und eigenen Loopback-
|
||||
Tunnel mit StrictHostKeyChecking/Keepalive. Roothelperstarts nur für zwei feste
|
||||
eigene Unitnamen mit unabhängig gelieferten tatsächlichen Unithashes. Bereits
|
||||
aktive fremde Helper werden nicht als eigene Cleanupziele übernommen.
|
||||
- Neuer Hello/Transport muss eine höhere Verbindungsgeneration und realen
|
||||
serverseitigen Sync-/Restorezustand plus frischen Kontakt ergeben. Eigene
|
||||
Prozesse werden nur bei terminalen Serverjobs und ohne unklare Helperverbräuche
|
||||
gestoppt; private Journale/Identitäten werden nie gelöscht oder umgeschrieben.
|
||||
Reboot aktiviert bei Bedarf nur die eigene bestehende Agentunit als technischen
|
||||
Startbootstrap und stellt den früheren Enablezustand nach terminalem Ergebnis
|
||||
wieder her. Kein SSH-Reboot, Paketresolver oder Service-Geschäftseffekt.
|
||||
- Rebootdriver wartet begrenzt auf strikt authentisierten SSH-Wiederkontakt und
|
||||
echte neue /proc-Boot-ID, setzt nur seinen eigenen PC-Tunnel neu auf und verlangt
|
||||
autogestarteten nichtprivilegierten Agenten, neues Inventar, Server-/Helper-Sync
|
||||
und den gebundenen endgültigen Job. Exitcode 0 ist kein Rebootnachweis.
|
||||
- Zusätzliche ausgearbeitete Lifecycleoptionen: `--transport wss|https`, optional
|
||||
`--exercise-server-restart` (bestehendes Compose-Profil unverändert, kein OIDC-
|
||||
oder Datenreset) und `--exercise-native-renewal`. Letzterer beobachtet nur echte
|
||||
native Rotation, exportiert keine privaten Schlüssel und erzwingt keine neue
|
||||
CSR über einen Ersatz-PC-Client. Fehlt ein nativer Fälligkeits-/Triggerpfad,
|
||||
endet er not_configured statt Rotation zu behaupten. Für den verlangten API-
|
||||
Fingerprintnachweis fehlt aktuell außerdem `certificate_sha256` im Geräte-DTO;
|
||||
das ist ein präzises Metadatengate, keine unbekannte Renewroute.
|
||||
|
||||
### Replay ist nicht erfundene Fault-Injection
|
||||
|
||||
Der Driver liest auf der VM ausschließlich das tatsächlich archivierte originale
|
||||
`reconcile_results.envelope` des **gleichen** abgeschlossenen Hello-Jobs/Versuchs.
|
||||
Agent/Job/Versuch/terminales Result werden aus Protobuf geprüft. Er verwendet den
|
||||
nativen aktuellen Zertifikatselector und Geräteschlüssel ausschließlich auf VM,
|
||||
normale CA-/DNS-Verifikation und zweimal denselben originalen MessageBatch an
|
||||
`POST /agent/v1/messages`. Message-ID/Boot/Sequenz/Zeit/Output bleiben unverändert.
|
||||
Danach müssen lokaler Verbrauch, serverseitiger Job/Grant, Ergebnis und genau
|
||||
ein konkreter Receipt unverändert sein. Kein neues Offer, neuer Job/Versuch,
|
||||
neuer Grant, umverpacktes Ergebnis oder Journal-/Safetyreset.
|
||||
|
||||
Gezieltes Offerduplizieren und echtes ACK-Unterdrücken haben keinen öffentlichen
|
||||
Native-Testhook. Deshalb bleiben die zwei Fault-Resultfelder ausdrücklich
|
||||
`unsupported_native_fault_injection` und `native_fault_test_passed=false`, auch
|
||||
wenn der separate Replay-Regressionsdriver später erfolgreich läuft. Dieser
|
||||
Driver wurde hier **nicht gegen die VM ausgeführt** und nicht als Nativepass markiert.
|
||||
|
||||
### Konkrete APT-Collectorübergabe – derzeit wirklich fehlend
|
||||
|
||||
Die echte read-only MCP-Antwort enthält weiterhin **keine** gespeicherte
|
||||
`linux.apt.planning`-Observation. Der Planbuilder fällt nicht auf SSH-Live-
|
||||
Paketinventur/Resolver, manuelles Baseline-/Acceptance-Schreiben oder Capability-
|
||||
Overrides zurück. Die bestehende additive Inventory-JSON-Route genügt; benötigt
|
||||
wird eine reale erlaubte passive Standarderhebung oder ein eigener UI-genehmigter
|
||||
Read-Diagnoseauftrag mit folgendem Mapping:
|
||||
|
||||
```text
|
||||
scope/source_id: linux.apt.planning
|
||||
quality: valid; completeness: complete; truncated: false
|
||||
observed_at: tatsächlicher RFC3339-Zeitpunkt (für Ausführung <90 s)
|
||||
data:
|
||||
fixture_package: tatsächliche Projektion baseline["rmm-mvp-test:all"] oder null
|
||||
baseline_sha256, sealed_baseline_sha256
|
||||
status_fingerprint, dpkg_updates_empty, pending_triggers_empty
|
||||
runtime, runtime_sha256
|
||||
provider_sha256, hook_sha256, apt_config_sha256
|
||||
prefetch: {<echter Archivhash>: {schema_version:1,sha256,size,sealed_at_ms}}
|
||||
```
|
||||
|
||||
Ableitung exakt nach Toolvertrag, keine erfundenen Zeitpunkte/Hashes:
|
||||
|
||||
1. `installed_snapshot()` liest dpkg-query Package/Architecture/Version/Status,
|
||||
prüft Eindeutigkeit und konsistente Statuswerte. Baselinehash = SHA256 der
|
||||
kanonischen ASCII-JSONbytes (`sort_keys`, kompakt, **ohne LF**). Die gesamte
|
||||
Baseline muss nicht in die 32-KiB-Observation: Fixtureprojektion plus Hash reichen;
|
||||
ein optional mitgeliefertes Vollobjekt wird zusätzlich gehasht/geprüft.
|
||||
2. `sealed_baseline_sha256` bestätigt eine tatsächlich bereits erzeugte,
|
||||
Root-private unveränderliche Baseline mit genau diesem Inhalt. Nicht durch
|
||||
Kopieren des behaupteten Hashs als Proof erzeugen; Helper prüft Datei/Hash vor Effekt.
|
||||
3. `status_fingerprint()` hasht kanonische Pfad→SHA256/null-Records für
|
||||
/var/lib/dpkg/status, arch, /var/lib/apt/extended_states und sortierte Trigger
|
||||
außer Lock. Dpkg-updates muss leer und triggers/Unincorp leer sein. Optional
|
||||
Records können mitgeliefert und erneut gehasht werden.
|
||||
4. Runtimehash = SHA256 des echten kanonischen `inspect-runtime`-Objekts ohne LF;
|
||||
Code-/Hookhash über tatsächliche installierte Bytes, Confighash über exaktes
|
||||
print-config. Root-readiness-IPC/Rootprovisionierung und beide Ledgerinodes
|
||||
werden unabhängig geprüft; Runtime-/Codepins stimmen mit administrativ
|
||||
gelesener bestehender Rootkonfiguration überein, nicht nur mit Agentbehauptungen.
|
||||
5. Prefetchfelder stammen aus echten Root-sealed Receipts vor der finalen Grant-
|
||||
not_before-Zeit. Archive sind ausschließlich die zwei gepinnten bekannten
|
||||
Fixturebytes. Kein Native-Acceptance-Record vor dem tatsächlichen UI-genehmigten
|
||||
Paketjob. Der Suitecode ruft `prepare-baseline`/`provision-fixture-store` niemals
|
||||
über SSH auf: letzteres kombiniert im aktuellen Tool Vorbereiten und aktive
|
||||
Baselineerhebung und wäre kein verdeckter lesender Planungsersatz.
|
||||
|
||||
**Zusätzlicher tatsächlicher Fixture-Sequenzkonflikt:** Nach Nativeacceptance 1.0
|
||||
ist 1.0 bereits installiert, das bestehende install-Rezept erlaubt jedoch nur
|
||||
old_version=null. Nach Nativeacceptance des Upgrades ist bereits 1.1 installiert,
|
||||
während apply_updates exakt old_version=1.0 verlangt. Die normalen Adapter
|
||||
verweigern solche falschen Baselines ausdrücklich. Ohne zusätzlich genehmigten
|
||||
Reset-/Removalpfad oder überprüften neuen Idempotenzvertrag kann nicht ehrlich
|
||||
alle vier Hosttransaktionen nacheinander als neu ausgeführt abgenommen werden.
|
||||
Keine heimliche Entfernung/Downgrade und keine gefälschte Abwesenheitsbaseline.
|
||||
|
||||
### Benutzerfreigabe getrennt von Readiness
|
||||
|
||||
Tatsächlich lokal erzeugt, aus der bereits gegebenen Chatfreigabe (2026-11-12):
|
||||
`devstate/mvp-acceptance-optins/chat-user-20261112.json`, Verzeichnis 0700, Datei
|
||||
0600, gitignored. Enthält feste Ziel-IDs, gewählte Cases, simulationskennzeichnung,
|
||||
Chat-Herkunft/Datum und kurze Gültigkeit. **Kein** wiring_verified/ready/capability-
|
||||
Flag und keine neue Autorisierung im Produkt. Erneute manuelle Abschrift der
|
||||
gleichen Userentscheidung ist nicht nötig; tatsächliche WebUI-Plangenehmigung
|
||||
bleibt für jeden Job erforderlich.
|
||||
|
||||
Ein getrenntes tatsächliches Wireworker-Verdikt ist vor Nativebootstrap Pflicht:
|
||||
feste agent_id, tatsächliche aktuelle `agent_sha256`, `helper_sha256`, optional
|
||||
`helper_units:{fester Unitname: tatsächlicher Unithash}`, `general_pin_file` und
|
||||
`apt_pin_file` für unabhängig Root-provisionierte Public-Pins. Die Suite hat
|
||||
**kein solches Verdikt gefälscht oder automatisch erzeugt**. Die Hashangaben
|
||||
werden vor Ort nochmals gegen echte Installation, Peer, Pin, Unit und Sync geprüft.
|
||||
|
||||
### Tatsächlich ausgeführte Verifikation dieses Adapterincrements
|
||||
|
||||
- Python-Syntaxprüfung der fünf betroffenen Pythondateien bestanden.
|
||||
- Abschließend **27 neue/erweiterte MVP-Guardtests** und **15 bestehende VM-Guardtests**
|
||||
bestanden, einschließlich echter generierter Replay-/Inspect-Syntax, Root-UI-
|
||||
Prepare-vor-Approval-Reihenfolge und getrennte-Ledger-Inode-Verweigerung.
|
||||
- TypeScript-Typecheck bestanden; neun lokale API/UI-Tests bestanden.
|
||||
- Browserdiscovery der getrennten Root-Prepare-/Approvaltests erfolgreich;
|
||||
**kein Browserlauf**. Kein neuer Rustbuild/-test oder fremder Worker-Testpass behauptet.
|
||||
- Echte read-only MCP-/Backendstrecke erfolgreich; erhaltene VM sichtbar,
|
||||
nichttrunkierte Liste, **unreachable**, weiterhin nur alte Basis-/Hello-/Inventory-
|
||||
Capabilities. Kein frischer Root-/APT-/Sync-/Transport-/Rotationsnachweis.
|
||||
Tatsächlich bestätigt: linux.apt.planning fehlt und das Geräte-API liefert
|
||||
noch kein certificate_sha256. Benutzerartefakt abschließend auf 0700/0600,
|
||||
15 Cases und Abwesenheit sämtlicher Readiness-/Acceptanceflags geprüft.
|
||||
- **0 neue RMM-Anträge/Pläne/Genehmigungen/Jobs, 0 SSH-/VM-/Rootänderungen,
|
||||
0 Dienst-/Tunnelstarts, 0 Serverrestarts, 0 Pakete/Updates/Reboots** in diesem Lauf.
|
||||
|
||||
Tatsächlich ausgeführtes Defaultkommando: `python3 deploy/vm_mvp_acceptance.py`.
|
||||
Geplante, **nicht ausgeführte** Fortsetzung erst nach aktuellem realem Wireverdict:
|
||||
|
||||
```sh
|
||||
python3 deploy/vm_mvp_acceptance.py --run-realtime-dev-ui-acceptance \
|
||||
--user-artifact devstate/mvp-acceptance-optins/chat-user-20261112.json \
|
||||
--wire-verdict devstate/vm-wire/current.json --transport https \
|
||||
--case hello --case duplicate_offer --case lost_result_ack
|
||||
```
|
||||
|
||||
Die Freigabedatei muss noch gültig sein (bei Bedarf create-only neu aus derselben
|
||||
Chatfreigabe mit `--create-chat-user-artifact` erzeugen). Reboot nur letzter Case,
|
||||
eigene Lifecyclekontrolle und tatsächlich aktivierte eng begrenzte Rootpolicy;
|
||||
die aktuell falsche allow_reboot/allow_root_scripts-Policy wird nicht von der
|
||||
Suite geändert. Root-Testunit braucht echten erlaubten ReadWritePaths-Pfad,
|
||||
sonst not_configured; niemals stille SSH-Geschäftsmutation. **Kein Linux-MVP-Abschluss.**
|
||||
|
||||
## Neueste Vorbereitung: modulare VM-MVP-Abnahmesuite, noch keine neue Ausführung
|
||||
|
||||
Diese Ergänzung ist **Testvorbereitung während des parallelen Agent-/Helper-/Sync-
|
||||
Wire-ups**, kein weiterer VM-Feature- oder MVP-Erfolgsnachweis. Bestehende positive
|
||||
Hello-World-/Root-Readiness-Nachweise unten bleiben getrennte frühere Läufe.
|
||||
|
||||
### Geliefert und Sicherheitsgrenzen
|
||||
|
||||
- Neu: `deploy/vm_mvp_acceptance.py`, `tests/vm_mvp_guards.py`,
|
||||
`deploy/browser/run_mvp_actions.py`, `tests/browser/mvp-actions.spec.ts`.
|
||||
Keine Änderungen an WebUI-/Agent-/Helper-/Domain-/Server-/APTtool-Quellen,
|
||||
keine Rootkonfigurations-/Policyerweiterung und kein Build/Serverrestart.
|
||||
- Defaultkommando ist ausschließlich lesend. Echter rmcp-Streamable-HTTP-Client,
|
||||
Protokoll 2025-11-25 mit initialize/initialized/Session-ID; liest
|
||||
`tenants.list`, `inventory.list_devices`, `inventory.get_device`,
|
||||
`monitoring.get_health`, tatsächlichen Dev-Loginmodus und gespeicherte Jobzustände.
|
||||
Die erhaltene konkrete Linux-VM ist fest gebunden, nicht durch Konfiguration
|
||||
auf beliebige andere Geräte erweiterbar. Trunkierte Gerätelisten ersetzen
|
||||
niemals den authentisierten Einzelgeräteabgleich.
|
||||
- Ausführung verlangt ausdrücklich `--run-realtime-dev-ui-acceptance`, ausgewählte
|
||||
feste Cases und ein vorhandenes Benutzerartefakt (Eigentümer aktuell, regulär,
|
||||
kein Symlink, 0600, höchstens 1 MiB, keine doppelten JSONfelder). Artefakt enthält
|
||||
exakt `profile`, `tenant_id`, `asset_id`, `agent_id`, `approved_cases`,
|
||||
`expires_at`, `wiring_verified`, `expected_principal`. Profil dev/test, gleiche
|
||||
erhaltene Gerätebindung, explizite Cases, Ablauf höchstens eine Stunde und
|
||||
`simulated-testprincipal-a` sind zwingend. Dieses lokale Opt-in ist **keine
|
||||
Jobgenehmigung und kein Sync-/Capabilitybeweis**. Es wird nicht automatisch
|
||||
erzeugt oder auf wahr gesetzt; echte Worker-Wiringnachweise müssen zuerst vorliegen.
|
||||
- Unveränderliche TLS-Origin `https://rmm-dev.internal:18443`, TCP nur
|
||||
`127.0.0.1:18443`, vorhandene öffentliche Dev-CA; kein alternativer Hostname,
|
||||
Credential-in-URL, Proxy-/Redirect-/Invalid-Cert-Bypass. UID0 als Netzwerkagent
|
||||
wird abgewiesen. Für Jobs werden frischer tatsächlicher Kontakt unter 90 s,
|
||||
ausgehandelte Aktion plus `rmm.sync.v1` und bei Root zusätzlich `helper.root.v1`,
|
||||
`root:<action>` und exakter Helperpolicydigest verlangt. Serverseitiger Sync-/
|
||||
Policy-/Grantgate bleibt unabhängig bestehen; kein Capability-DB-Override.
|
||||
- Vor jedem Case blockieren queued/accepted/running/verifying/unknown/
|
||||
awaiting_reboot im bestehenden VM-Ledger. Nichts wird zurückgesetzt, gelöscht,
|
||||
über SSH repariert oder als neuer Versuch automatisch wiederholt. Ein fehlender
|
||||
Ergebnisnachweis/Timeout bleibt Fehler mit erhaltenem privaten Checkpoint;
|
||||
Suite stoppt, statt Folgecases/Retry auszulösen. Sie übernimmt keine fremden
|
||||
Tunnel-/Dienst-PIDs und startet/stoppt keinen technischen VM-Prozess.
|
||||
|
||||
### Vorbereitete Caseabdeckung und ausdrücklich offene Adapter
|
||||
|
||||
**Sechs ausführbar implementierte, hier nicht ausgeführte Caseadapter:**
|
||||
|
||||
1. `hello`: unveränderte exakte POSIX-Shellbytes, stdout mit LF und Exitcode 0.
|
||||
2. `refresh_inventory`: linux.base, echter Ergebnis-Erhebungszeitpunkt mindestens
|
||||
so neu wie der im genehmigten Job gebundene Startzeitpunkt.
|
||||
3. `query_logs`: ausschließlich `rmm-mvp-test.service`, feste fünf Minuten,
|
||||
höchstens 50 Zeilen/65536 Outputbytes; gültige Qualität statt erfundenem Erfolg.
|
||||
4. `service_setup`: nur ein fest eingebautes, vollständig UI-genehmigtes
|
||||
Rootskript für create-only Testunit, `/usr/bin/sleep infinity` unter
|
||||
`rmm-agent`, keine Paketinstallation, kein Enable/Start. Geladene Unit wird
|
||||
im gebundenen Skript nachgeprüft, erwartete stdout exakt festgelegt.
|
||||
Browser bindet die Skriptbytes zusätzlich an SHA256
|
||||
`159ff240504b8a350b46a56fdf9cd50e5768816de7e6683829f05144978449f0`.
|
||||
Aktuelle Rootscriptpolicy/Writesandbox wird dadurch nicht eingeschaltet.
|
||||
5./6. `service_start`/`service_stop`: typisierte Rootaktion ausschließlich für
|
||||
diese Unit, 180 s; nur als ausdrücklich genehmigte Reihenfolge
|
||||
setup → start → stop auswählbar. Kein beliebiger Dienstname/Restart.
|
||||
|
||||
Für jeden Case: eigener MCP-Plan/Submit, gespeicherte Planbytes/SHA256 und genau
|
||||
ein festes Ziel, vor UI-Genehmigung je reserviertem Job **0 Jobs/Outbox/Grants**,
|
||||
Antrag pending_approval und keine Executionaggregation. Danach ausschließlich
|
||||
geschütztes Casefile an Browserrunner; echtes normales TLS-Login, sichtbare
|
||||
Simulation und tatsächliche Sessionfelder/Principal geprüft, vollständiger
|
||||
angezeigter Plan/Job/Hash/Bytes/Fristen/Identität geprüft, Checkbox und sichtbarer
|
||||
Genehmigungsbutton geklickt. Keine direkte API-/SQL-Genehmigung. Anschließend
|
||||
bestätigtes Ergebnis plus Nachbedingungen, genau 1/1/1 und tatsächliches Audit
|
||||
mit Principal, Planhash, approval_origin und testsimulation. Keine Log-/Script-
|
||||
Outputinhalte in öffentlichen Testergebnissen; keine Screenshots/HAR/Traces.
|
||||
|
||||
**Neun ausdrücklich `pending_protocol` und nicht ausführbare Cases:**
|
||||
`apt_native_install`, `apt_native_update`, `ensure_package`, `apply_updates`,
|
||||
`duplicate_offer`, `lost_result_ack`, `cancel_queued`, `expired_offline`,
|
||||
`reboot_last`. Ihre Auswahl wird vor Plan/Submit verweigert, auch bei einem
|
||||
lokalen Opt-in-Artefakt. Sie sind weder übersprungene bestandene Tests noch
|
||||
pauschal durch neue Jobs ersetzte Replaynachweise.
|
||||
|
||||
- APT: reiner strikter Formatvalidator für vollständiges Helper-schema-2-Manifest,
|
||||
Originaltransactionbytes/Hash/typed object, alle Runtime-/Provider-/Hook-/Config-
|
||||
und Baselinepins, exakt ein rmm-mvp-test-Archiv 1.0/1.1, Herkunft/Größe/Pfad und
|
||||
no_reboot. Das sind nur Fixture-/Parsertests, **keine aktuelle Baseline oder
|
||||
Native-Acceptance**. Ausführungsadapter wartet auf echten UI-genehmigten
|
||||
Planungs-/Preseal-Diagnosebeleg oder genehmigte passive Planungsdaten; kein
|
||||
SSH-Live-Resolve, kein manuelles Schreiben von Baselines/Acceptance-Markern.
|
||||
- Replay/ACK: kontrollierter same-job/same-attempt Zustell-/ACK-Fault-Adapter fehlt.
|
||||
Keinen zweiten Job als vermeintlich erfolgreiche Redelivery ausführen.
|
||||
- Cancel/offline/Fristen: kontrollierter nachgewiesener Nichtstart-/Offline-Sync-
|
||||
Fence fehlt; reine Zeit-/Parserchecks werden nicht als VM-Abnahme ausgegeben.
|
||||
- Reboot zuletzt: reiner Checkpoint-/Ergebnisvalidator vorhanden, aber echter
|
||||
eigener Tunnelrecovery-/SSH-Wiederkontakt-/authentisierter Syncadapter fehlt.
|
||||
Vor tatsächlichem Reboot müssen alte Boot-ID, Tenant/Agent/Asset, Operation,
|
||||
Job/Versuch und Planhash privat persistiert sein. Gleiche Boot-ID und Exitcode 0
|
||||
sind nie Erfolg. Kein Reboot wurde geplant, genehmigt oder ausgeführt.
|
||||
|
||||
### Tatsächlich in diesem Vorbereitungslauf geprüft
|
||||
|
||||
```sh
|
||||
python3 tests/vm_mvp_guards.py
|
||||
python3 tests/vm_job_guards.py
|
||||
python3 -m py_compile deploy/vm_mvp_acceptance.py deploy/browser/run_mvp_actions.py tests/vm_mvp_guards.py
|
||||
python3 deploy/vm_mvp_acceptance.py
|
||||
# jeweils in web/:
|
||||
npm run typecheck
|
||||
npm run test:browser -- mvp-actions.spec.ts --list
|
||||
npm test -- src/api.test.ts
|
||||
```
|
||||
|
||||
- **12 neue Guardtests**, **15 vorhandene VM-Guardtests**, Syntaxprüfung und
|
||||
TypeScript-Typecheck bestanden; **9 lokale API/UI-Tests** bestanden.
|
||||
Browserkommando war ausschließlich Discovery: **kein Browserlauf**.
|
||||
- Echte read-only MCP-/Backendstrecke erfolgreich; erhaltene VM eindeutig
|
||||
aufgelöst, Liste nicht trunkiert, Dev-Loginprofil bestätigt. Gespeicherte
|
||||
Präsenz tatsächlich **unreachable**, alte Capabilities nur linux.base/1,
|
||||
heartbeat/1, run_script, refresh_inventory. Deshalb kein aktueller Live-/Sync-/
|
||||
Root-/APT-Readinessbeweis und keine Ausführung begonnen. Kein Credentialinhalt,
|
||||
Hostname oder Inventar-/Logpayload veröffentlicht.
|
||||
- **Neue Flowzählung dieses Laufs: 0 Pläne/Submit, 0 UI-Genehmigungen, 0 Jobs,
|
||||
0 VM-Änderungen, 0 Tunnel-/Dienststarts.** Keine SSH-Geschäftsaktion,
|
||||
Rootconfig-/Policyänderung, Paketinstallation, Update oder VM-Reboot.
|
||||
|
||||
### Ausführbare Kommandos / noch nicht ausgeführte Fortsetzung
|
||||
|
||||
Lesendes Defaultkommando, tatsächlich wie oben geprüft:
|
||||
`python3 deploy/vm_mvp_acceptance.py`.
|
||||
|
||||
**Geplant, nicht ausgeführt**, erst nach tatsächlichem Worker-Wire-up, frischer
|
||||
VM-Verbindung und gesondertem geschütztem Benutzerartefakt:
|
||||
|
||||
```sh
|
||||
python3 deploy/vm_mvp_acceptance.py --run-realtime-dev-ui-acceptance \
|
||||
--user-artifact devstate/mvp-user-opt-in.json --case hello --case refresh_inventory
|
||||
# Separat und nur mit tatsächlich freigegebenem Rootscript-/Serviceprofil:
|
||||
python3 deploy/vm_mvp_acceptance.py --run-realtime-dev-ui-acceptance \
|
||||
--user-artifact devstate/mvp-root-opt-in.json \
|
||||
--case service_setup --case service_start --case service_stop
|
||||
```
|
||||
|
||||
Suite erzeugt private neue Nachweisverzeichnisse und Checkpoints, aber keine
|
||||
Autofreigaben oder VM-Prozess-/Journalreparatur. Bei Fehler zuerst festen Versuch,
|
||||
Helper-/Agentledger und eigenen technischen Lifecycle abgleichen, keine Identität
|
||||
oder Journale löschen. Technischer Rollback betrifft ausschließlich nachweislich
|
||||
eigene inaktive Prozesse/Units; Root-Geschäftseffekte/Retry benötigen weiterhin
|
||||
neuen festen UI-genehmigten Plan. **Vorbereitete Suite ist kein Linux-MVP-Abschluss.**
|
||||
|
||||
Diese Datei beschreibt Entwicklungsnachweise; kein M1-/MVP-Abschluss.
|
||||
Die älteren Abschnitte unten protokollieren den passiven Erstslice und sind keine
|
||||
aktuelle Aussage, dass Job-/UI-Code weiterhin fehlt. Für aktuelle additive
|
||||
Schnittstellen gelten außerdem `proto/BACKEND_CONTRACT.md` und
|
||||
`deploy/linux/README.md`. Deren Implementierung ist keine positive VM-Abnahme.
|
||||
|
||||
## Aktueller VM-Jobversuch: vor Deployment sicher blockiert (2026-11-12)
|
||||
|
||||
### Neuester Bootstrapnachweis: separater RootHelper vorbereitet, APT bewusst gesperrt
|
||||
|
||||
- `deploy/vm_root_bootstrap.py`, explizite
|
||||
`deploy/linux/rmm-helper-dev-test.service` und
|
||||
`deploy/linux/ROOT-READINESS.md` ergänzt. Keine Rust-/Domain-/Backend-/APTtool-
|
||||
Quelldateien verändert. Vorgaben aus `tools/apt-transaction/HELPER-CONTRACT.md`
|
||||
und konkreter Helperkonfiguration gelesen; bestehende gehärtete Standardunit
|
||||
nicht abgeschwächt. Root-/APT-Jobs wurden nicht ausgeführt oder genehmigt.
|
||||
- Tatsächlich vor Installation lesend auf VM geprüft: alle neun neuen Helper-/
|
||||
Provider-/Drop-in-Pfade fehlten, kein Agent/Helper aktiv, kein Listener auf 18443;
|
||||
erhaltenes Agentkonto UID 993/GID 984 und privater Agentstate unverändert sicher.
|
||||
Ein unresolved-Job-Guard liest den bestehenden Serverledger; keine DB-Schreiboperation.
|
||||
- `python3 deploy/vm_root_bootstrap.py build`: separater Docker-OpenSSL-3-
|
||||
Helperbuild erfolgreich. Kein Serverimage deployt oder Server neugestartet.
|
||||
Der erste Buildcontext war unnötig groß (2.575 GB); der Copyfilter schließt
|
||||
künftig ausdrücklich `target`, `node_modules`, `devstate`, Credentials und
|
||||
Secrets auch innerhalb kopierter Bäume aus. Dieser Filter wurde nicht durch
|
||||
einen zweiten vollständigen Imagebuild als Größenmessung ausgegeben.
|
||||
- `python3 deploy/vm_root_bootstrap.py install` nach einem korrigierten
|
||||
generierten-Code-Importfehler erfolgreich. Fehler transportierte ausschließlich
|
||||
`NameError` und numerische Zeilennummern, keine Meldung/Payload/Locals.
|
||||
Ein neuer Test führt echte generierte Hash-/Manifestfunktionen aus und deckt
|
||||
deren Imports ab; der gescheiterte erste Versuch hatte laut erneutem echten
|
||||
Preflight noch keine RootHelperressourcen angelegt.
|
||||
- Aktuelles Helperartefakt benötigt maximal glibc **2.34**; konkrete Auflösung
|
||||
mit VM-Loader vor Start bestanden. SHA256:
|
||||
`e8faa5a54c9d693618d497149bf448cf8b52456e9d225038950d5f04c2a6bc8a`.
|
||||
Installation create-only unter `/usr/local/libexec/rmm-privileged-helper`.
|
||||
- Authentisierter öffentlicher Signingkey-GET mit normaler CA-/DNS-Verifikation;
|
||||
exakter Abgleich von Tenant/Agent/Asset/Enrollmentgeneration/Assignmentversion
|
||||
und bereits gepinntem Agentkey vor Rootprovisionierung. Separate Rootdateien
|
||||
`/etc/rmm/helper-dev-test-v1.json` und `helper-signing-key-v1.json` sind Root:Root
|
||||
**0600**. Keine privaten Serverkeys kopiert oder Agentidentitäten verändert.
|
||||
- Kompilierter Helper installierte ausschließlich feste eingebettete APTtool-/
|
||||
Hookbytes mit `--install-apt-provider`, leere `archives`, `baselines`, `history`
|
||||
und Root-0600-Installmetadata. Exakte Hashes/Metadata geprüft; keine Archive,
|
||||
Baseline, active-Kontexte, Grants oder Acceptancebelege erzeugt.
|
||||
Durch geerbte UMask entstanden zunächst 0600/0700-Payloadmodi; v2 korrigiert
|
||||
ausschließlich nach geprüftem Rootowner, Single-Link und exaktem Buildhash auf
|
||||
die vertraglichen Code-/Hookmodi 0644/0755, Codedirectory 0755. Folgeinstallationen
|
||||
setzen nur für den separaten Codeinstaller UMask 0022, Trust/State bleiben privat.
|
||||
- Native readonly Messungen: Ubuntu-24.04-amd64, Python 3.12.3, APT 2.8.4,
|
||||
dpkg 1.22.6, mount/unshare util-linux 2.39.3. Gemessene Pins:
|
||||
Runtime `223016938765625ac7e71ebd5f021c6911c9e2013fafdba1c4497c7e4dc69acc`,
|
||||
APT-Config `045f1bb45f4532112b7a5503e368ed3e1aae03fcc5b6275cbaa3caf7e8a48941`,
|
||||
Provider `3591bf16a1c0f78d2f53fb366ac93d723f3d82e63ed2b5085eb1649e5ba5dec6`,
|
||||
Hook `5b4caa7fc1fd6acf1f2b1b9a03e56074ee5595c86592b183fa6da76fe9e8f609`.
|
||||
Vollständiges gemessenes Runtimeobjekt liegt ausschließlich im privaten Report.
|
||||
- Direkter rootseitiger `inspect-sandbox` endete tatsächlich mit **100/Veto**,
|
||||
**nicht bestanden**. Der Parent ist nicht der fertige signierte APT-Worker;
|
||||
es wurden keine Hostnamespace-/Sandbox-ready-/Acceptance-Dateien gefälscht,
|
||||
keine Paketmutation und kein Reboot-/Host-PID1-Systemcontrolprobe durchgeführt.
|
||||
- `systemd-analyze verify` der neuen Unit bestanden. Helper ist unter ausdrücklich
|
||||
benannter dev/test-Unit **enabled, jetzt gestoppt**. Bei echtem Start Socket
|
||||
Root:GID984, **0660**, Runtimeparent Root:GID984 **0750** geprüft. UID993 konnte
|
||||
ausschließlich connecten und schließen, ohne Request/Grant. Das ist ACL-Readiness,
|
||||
keine signierte IPC-/Rootaktionsabnahme. Helperledger **0 Verbrauchseinträge**.
|
||||
- Post-exec-Kernelprüfung separat bestätigt: Helper-PID **4146110**, UID0/GID984,
|
||||
**NoNewPrivs=1**, **Seccomp=2**, CapBnd `00000000800001db`, CapEff
|
||||
`000000008000015b` (strengere Teilmenge). Erste Statusmessung direkt nach
|
||||
systemd-Type=simple-Start traf noch Pre-exec-Zustand und ist ausdrücklich kein
|
||||
Confinementbeleg. v2 verlangte irrtümlich alle acht Capabilities auch effektiv;
|
||||
nach lesender Diagnose wurde nur der Guard auf erlaubte effektive Teilmenge
|
||||
korrigiert, **keine Unit-/Kernelrechte gelockert**. Der schon laufende Probehelper
|
||||
wurde ohne Neustart weiter geprüft und nach bestätigtem leerem Ledger gestoppt.
|
||||
v3 ist der maßgebliche Sandboxbeleg, ältere Reports bleiben nachvollziehbar.
|
||||
- Netzwerkaccount kann weder Helperconfig/-Pin/State noch Provider/Installmetadata
|
||||
schreiben; Helperpin und State sind für UID993 nicht lesbar. Rootstate **0700**;
|
||||
Agentidentitäts-/Journal-Dateihashes und SQLite-Schema/Rows vor/nach unverändert.
|
||||
Agentunit bekommt nur einen neuen Root-eigenen versionierten Drop-in:
|
||||
`RMM_HELPER_SOCKET=/run/rmm-helper/control.sock`; kein Agentrestart, keine
|
||||
Enrollment-/Binding-/Journalmigration in diesem Schritt.
|
||||
- Abschließend VM bestätigt: Agent **gestoppt**, Helper **gestoppt**, Runtime-
|
||||
Socketverzeichnis entfernt, kein 18443-Listener. Kein Tunnel angelegt. Testpaket
|
||||
`rmm-mvp-test` nicht installiert und Testservice-Datei nicht vorhanden. Keine
|
||||
Paket-/Diensttest-/Update-/Rebootwirkung. Helper bleibt enabled für einen späteren
|
||||
ausdrücklich freigegebenen Systemstart; daraus folgt keine RMM-Jobgenehmigung.
|
||||
- Private Evidenz: `devstate/vm-root/{build,result,readiness-v3}.json` sowie
|
||||
`/etc/rmm/root-bootstrap-v1-report.json`, `root-readiness-v2-report.json` und
|
||||
maßgeblich `root-readiness-v3-report.json`. Teil-/Fehlerreports nicht löschen.
|
||||
- Tatsächliche Prüfungen: **15 Python-Guardtests bestanden**, Python-Syntaxprüfung
|
||||
bestanden. Tests prüfen generiertes Remoteprogramm/Hashabhängigkeiten und
|
||||
Secretcanary, Rootconfig ohne Paket-/Reboot-/Rootscript-Autorisierung, konservativen
|
||||
Cleanup und Verweigerung von Pre-exec-/überprivilegierten Kernelzuständen.
|
||||
Keine erneute Behauptung der früheren 18 Rusttests; hier Helper-Releasebuild,
|
||||
native Readiness und gezielte Pythonprüfungen, keine volle Workspace-Suite.
|
||||
|
||||
**Konkrete verbleibende APT-/Root-Ausführungsgates:** `apt_provider=null`,
|
||||
`allow_reboot=false`, `allow_root_scripts=false`; ausschließlich zukünftige
|
||||
`rmm-mvp-test.service` als erlaubte Dienstkennung. Keine Paketcapability aus
|
||||
Installation ableiten. Die Readinessunit hat kein CAP_SYS_ADMIN/CAP_MKNOD und
|
||||
verweigert Mount-/Rebootsyscalls; ProtectSystem=strict verhindert notwendige
|
||||
Paketdatenbank-/Payloadschreibzugriffe. Ein separat überprüfter APT-Setup-Runner
|
||||
braucht private Mount/PID/Netznamespace- und Devicenode-Erstellung, muss danach
|
||||
den Packagechild auf exakt die acht vorgesehenen Capabilities/NNP/seccomp
|
||||
reduzieren und Hostkontrollsocket-/Readonlypfade sicher ausblenden. Dies wurde
|
||||
nicht blind durch Entfernen der Unit-Härtung ermöglicht. Backend muss vollständige
|
||||
signierte Root-/APT-Manifeste erhalten; Agent muss Helperfähigkeiten ausdrücklich
|
||||
aushandeln und vorhandenen Sync-/Reconnectzustand abgleichen. Erst dann neue feste
|
||||
UI-genehmigte Jobs. **Kein Paket-/Rootaktions- oder Linux-MVP-Abschluss.**
|
||||
|
||||
### Neuester Nachweis: erster tatsächlicher nichtprivilegierter VM-Job erfolgreich
|
||||
|
||||
Der frühere Blocker in der Abschnittsüberschrift ist für **diesen ersten**
|
||||
Hello-World-Lauf behoben. Historische Fehlversuche darunter bleiben Nachweisprotokoll,
|
||||
keine Aussage über den jetzt bestätigten Endzustand.
|
||||
|
||||
- Tatsächlich ausgeführt: `python3 deploy/vm_job_test.py --run-service-hello`.
|
||||
PC-eigener strikter Reverse-Tunnel, VM-Listener ausschließlich
|
||||
`127.0.0.1:18443`, vertrauenswürdige CA/DNS-Prüfung `rmm-dev.internal`;
|
||||
keine Hostkey-/Firewall-/sshd-/Hostsänderung. Native systemd-Agent-PID
|
||||
**4144575**, tatsächliche UID **993**, kein Root-Netzwerkagent.
|
||||
- Zwei verschiedene frische Heartbeats derselben erhaltenen Geräteidentität:
|
||||
**18:04:45.200243 UTC** und **18:05:20.200437 UTC** am 2026-11-12.
|
||||
Zum Prüfzeitpunkt jeweils unter 90 s alt; `run_script` tatsächlich gemeldet.
|
||||
Tenant-B-Leser erhält für dieses Tenant-A-Gerät HTTP 404.
|
||||
- Echter rmcp-Streamable-HTTP-Client mit `initialize`/`notifications/initialized`,
|
||||
Protokoll **2025-11-25**; `operations.plan` und `operations.submit` beantragen
|
||||
exakt einen festen Job auf genau diesem VM-Asset. Exakte Bytes:
|
||||
`printf '%s\n' 'Hello World'` mit abschließendem LF, `/bin/sh`/`posix_sh`,
|
||||
`agent_service`, erwartete stdout `Hello World` mit LF, Laufzeitlimit 60 s,
|
||||
Outputlimit 65536 Bytes, Planstartfrist 15 Minuten, Parallelität 1.
|
||||
- Vor Genehmigung realer persistenter Antrag `pending_approval`, null Jobs,
|
||||
keine Executionaggregation; gerätebezogene DB-Leseprüfung ergab
|
||||
**Jobs/Outbox/Startgrants = 0/0/0**. Keine direkten Freigabe-API-/DB-Aufrufe.
|
||||
- **Tatsächlicher Playwrightlauf bestanden**, nicht nur Discovery: normales
|
||||
TLS-Login mit geschützter Loginfile, sichtbar simulierter Testprincipal,
|
||||
bestehenden Antrag öffnen, vollständigen unveränderlichen Einziel-Preview,
|
||||
Bytes/Nachbedingung/Identität/Limits und SHA256 der gespeicherten Planbytes prüfen,
|
||||
Checkbox und sichtbaren Genehmigungsbutton klicken, Ergebnis anzeigen, Logout.
|
||||
NSS-Trust isoliert, keine Screenshots, HAR, Traces oder Geheimnisausgaben.
|
||||
- Danach **Jobs/Outbox/Startgrants = 1/1/1**, genau ein serverseitiger
|
||||
`start_reserved`-Audit und ein `plan_authorization`-Audit. Serverjob `succeeded`,
|
||||
Revision 2, nichtleerer Journalannahmenachweis, exakte Agent-/Asset-/Jobbindung
|
||||
und `execution_identity=agent_service`. Ergebnis: Exitcode 0, stdout exakt
|
||||
`Hello World\n`, `postconditions_passed=true`. Kein separat beobachtetes
|
||||
`verifying`-Zwischenereignis behauptet; bestätigtes Endergebnis liegt vor.
|
||||
- Genehmigungsaudit: `approval_origin=dev_test_browser_simulation`,
|
||||
`testsimulation=true`, Principal `simulated-testprincipal-a`, exakt gebundener
|
||||
Planhash `b58910cdbdb1047355ddc36d03c0dd3c7d3a58eb39a91b965242b3c2c8c2fda9`.
|
||||
Ausschließlich Entwicklungs-Browsersimulation, **kein menschlicher
|
||||
Produktionsfreigabenachweis**.
|
||||
- Nachträgliche echte lesende VM-Prüfung: `journal.sqlite` enthält genau einen
|
||||
passenden Job/Versuch mit `succeeded` und derselben Grant-ID wie der Server;
|
||||
`job_events` leer (kein unbestätigtes Jobevidence mehr). `consumption.sqlite`
|
||||
enthält genau einen Verbrauch mit demselben Job und Grant sowie genau einen
|
||||
zugehörigen Executionevidence-Eintrag. Keine neue Wirkung oder Redelivery
|
||||
zum Beweis provoziert. Serverjob hat keine persistierte Bootspalte; deshalb
|
||||
kein zusätzlicher unabhängiger Boot-Bindungs-/Replaynachweis behauptet.
|
||||
- Erst nach terminalem Jobende eigenen Dienst gestoppt und eigenen Tunnel-PID
|
||||
**2110999** beendet. Nachträglich VM bestätigt: Dienst nicht aktiv, kein Listener
|
||||
auf 18443. Installation bleibt erhalten, nicht enabled; Identität/Journal nicht
|
||||
gelöscht, State 0700 und sämtliche State-Dateien 0600. Kein aktiver lokaler
|
||||
Testrecord. Geschützte Evidenz/PIDs/IDs: `devstate/vm-jobs/result.json`.
|
||||
- Abschließende **10 Python-Guardtests bestanden**, Syntaxprüfung bestanden,
|
||||
TypeScript-Typecheck und **9 lokale API/UI-Tests bestanden**. Regressionen prüfen
|
||||
tatsächliches generiertes Bootstrapprogramm, Secretcanary-Fehlertransport und
|
||||
dass aktive/unknown Zustände keinen automatischen Dienst-/Tunnelstop erlauben.
|
||||
- **Wiederaufnahme (geplant, nicht erneut ausgeführt):** zuerst PC-initiierten
|
||||
strikten Tunnel gemäß `docs/development.md` mit `-N -T`,
|
||||
`ExitOnForwardFailure=yes`, Keepalive 30/3 und
|
||||
`-R 127.0.0.1:18443:127.0.0.1:18443` über vorhandene vertrauenswürdige SSH-Daten
|
||||
aufbauen; anschließend über denselben verifizierten Bootstrapzugang
|
||||
`systemctl start rmm-agent.service`. Dienst benötigt diesen Dev-Tunnel.
|
||||
Kein neuer Job vor bestätigtem Backend-/Agent-Reconnectabgleich: der vorhandene
|
||||
Safetyzustand wird niemals gelöscht/umgeschrieben. Der Erstlauf-Testbefehl
|
||||
verweigert absichtlich vorhandene VM-Jobhistory und ist kein Wiederholungsbefehl.
|
||||
- **Offen:** Sync-/Reconnect- und Redelivery/ACK-Verlustabnahme, unabhängiger
|
||||
Bootnachweis, weitere UI-genehmigte Inventory-/Logjobs, Long Polling,
|
||||
Roothelper-/Dienst-/Paket-/Update-/Rebootstrecken. Keine dieser Zielwirkungen
|
||||
wurde ausgeführt. Rotation/Recovery/weitere Sicherheitsabnahmen weiterhin offen.
|
||||
Dieser positive Hello-World-Nachweis ist **kein M1-/Linux-MVP-Abschluss**.
|
||||
|
||||
### Fortsetzungsversuch mit ausdrücklich genehmigtem Dienstkonto-Bootstrap
|
||||
|
||||
**Nachtrag: kontrollierte Reparatur und Migration inzwischen erfolgreich.**
|
||||
|
||||
- Vor erneutem Installationsversuch tatsächlichen VM-Teilzustand ausschließlich
|
||||
lesend geprüft: Originalstate vorhanden, Zielstate fehlte; dediziertes nologin-
|
||||
Konto UID 993/GID 984 und eigene Binary/geschützter Bootstrapreport vorhanden,
|
||||
noch keine Unit. Keine supplementary Gruppenmitgliedschaft des Kontos.
|
||||
- Tatsächlicher ursprünglicher Loaderfehler zusätzlich konkretisiert: Hostbuild
|
||||
benötigt `libssl.so.1.1`/`libcrypto.so.1.1`; Ubuntu-VM-Loader meldete Exit 127 und
|
||||
fehlendes `libssl.so.1.1`. Der reine glibc-Vergleich genügte ausdrücklich nicht.
|
||||
- Reportinitialisierung vor Seiteneffekte gezogen, geschützten Report über
|
||||
`try/finally` persistiert, Fehlertransport auf Exceptionklasse und numerische
|
||||
Tracebackzeilen begrenzt. Keine Fehlermeldungen, Locals oder Payloads übertragen.
|
||||
Provenienzgeprüfte Fortsetzung verweigert fremde Dateien, veränderten Originalstate
|
||||
und unbekannte Configeinträge. Eigene alte Binary nur nach exaktem lokalem
|
||||
SHA256-Abgleich durch vorher VM-loadergeprüftes neues Artefakt ersetzt.
|
||||
- Aktuelles Artefakt separat in Docker gebaut:
|
||||
`docker build --target build -f deploy/Dockerfile -t rmm-vm-agent-build:dev .`.
|
||||
Build erfolgreich, **kein Serverdeploy/-restart**. Dockercontext schließt Secrets
|
||||
aus. Extrahiertes Agentartefakt benötigt glibc 2.34 und OpenSSL 3; dessen konkrete
|
||||
Bibliotheksauflösung auf der tatsächlichen Ubuntu-VM erfolgreich.
|
||||
- `python3 deploy/vm_job_bootstrap.py` danach **erfolgreich**: gleiche erhaltene
|
||||
Geräteidentität/Privatekey/SQLite-Dateibytes per atomarem Rename nach
|
||||
`/var/lib/rmm-agent` migriert, Source-Statepfad nicht als zweite aktive Identität
|
||||
erhalten. Vorher/nachher sämtliche Datei-SHA256 und SQLite-Schema-/Rowdigests
|
||||
identisch; ursprüngliches Journal hatte `counter` (1 Row), `pending` (0 Rows),
|
||||
noch keine Job-/Safetyhistory. Keine Tabellen-/Safetyflagänderung zur Migration.
|
||||
Geräteidentität nicht neu enrollt; keine DB-/PKI-Resets.
|
||||
- Stateverzeichnis 0700 und Dateien 0600, Konto UID 993; Root-eigene Binary/Unit,
|
||||
Root-eigene Configdirectory 0755, service-eigene Bindingdatei 0600 (vom Agentreader
|
||||
verlangt), öffentliche CA 0644. Eigene zuvor durch UMask 0077 versehentlich 0700
|
||||
angelegte Installationsdirectories nach Provenienzprüfung auf 0755 korrigiert.
|
||||
Unit hat `User/Group=rmm-agent`, keine Capabilities, NoNewPrivileges und strikte
|
||||
systemd-Sandbox. Nur daemon-reload, kein enable/start durch den Bootstraphelper.
|
||||
- Geschützte Evidenz: lokal `devstate/vm-jobs/bootstrap.json`, auf VM
|
||||
`/etc/rmm/vm-bootstrap-report.json`. Root-Helper nicht installiert/provisioniert.
|
||||
Keine Root-Jobs, Zielpakete, Updates oder Reboots ausgeführt.
|
||||
- **Rollbackplan:** Nur bei nachweislich inaktiven Jobs Dienst stoppen; nach
|
||||
internem Manifestabgleich gesamten State atomar zurück zum im privaten Report
|
||||
gespeicherten alten Pfad verlagern und ursprüngliche Rootownership wiederherstellen.
|
||||
Nie beide Identitätspfade gleichzeitig starten; keine automatische pauschale
|
||||
Ressourcen-/Accountlöschung. Erfolg dieses Plans wurde nicht praktisch getestet.
|
||||
- Zwei neue Regressionen führen das **wirklich generierte Remoteprogramm** isoliert
|
||||
mit gemockten OS-/Account-/Loaderaktionen aus: fehlender Binaryparent plus
|
||||
erfolgreiche Report-/Migrationsstrecke; Loaderexception mit Secretcanary im
|
||||
argv/stderr, nur Klasse/Zeilennummern im Transport und persistenter Teilreport.
|
||||
Erster Regressionslauf blockierte korrekt wegen eines vom Test offengehaltenen
|
||||
SQLitehandles; Test schließt dieses jetzt explizit. Danach **9 Guardtests bestanden**.
|
||||
Python-Syntaxprüfung bestanden; TypeScript-Typecheck und **9 lokale API/UI-
|
||||
Unit-Tests bestanden**. Kein neuer Rustquellcode geändert.
|
||||
- `deploy/vm_job_live.py` und `deploy/vm_job_test.py --run-service-hello` ergänzen
|
||||
begrenzte eigene Tunnel-/systemd-/MCP-/Browserorchestrierung. Sie lassen aktive
|
||||
oder unbekannte Jobs samt eigenem Tunnel konservativ bestehen und führen keine
|
||||
Freigabe über API/DB aus. Positive Laufzeitergebnisse sind separat nachzuweisen;
|
||||
dieser Bootstrapnachtrag allein ist **kein positiver Job- oder MVP-Nachweis**.
|
||||
|
||||
- Neue Bootstrapfreigabe erlaubt ausschließlich dediziertes nichtprivilegiertes
|
||||
Systemdienstkonto samt Agentinstallation und verlustfreier Zustandsmigration;
|
||||
keine Root-RMM-Jobs, Pakete, Updates oder Reboots wurden daraus abgeleitet.
|
||||
- `deploy/vm_job_bootstrap.py` implementiert einen create-only Installationsversuch,
|
||||
authentisierten öffentlichen Signingkey-Bezug, atomare State-Verlagerung auf
|
||||
derselben Partition und Vergleich von Datei-SHA256 sowie SQLite-Schema-/Rowdigests.
|
||||
Der Code ist **nicht erfolgreich auf der VM abgenommen**. Nach Fehlern nicht
|
||||
unverändert erneut ausführen: zuerst VM-Zustand und etwaigen Teilbootstrap prüfen.
|
||||
- Tatsächlich erfolgreicher aktueller Releasebuild:
|
||||
`~/.cargo/bin/cargo build --locked --release -p rmm-agent --target-dir devstate/vm-jobs/build`.
|
||||
Zuvor fehlte das lokal erwartete Docker-Rustimage, und `cargo` war nicht im PATH;
|
||||
der vorhandene explizite Cargo-Proxy funktionierte. Keine Serverneubauten/-neustarts.
|
||||
- Tatsächliche CA-verifizierte Operator-GETs erfolgreich: Gerätebestand HTTP 200
|
||||
mit erhaltenem Agentrecord einschließlich Enrollment-/Assignmentgenerationen;
|
||||
öffentlicher Job-Signierschlüssel HTTP 200. Keine privaten Serverkeys übertragen.
|
||||
- `python3 tests/vm_job_guards.py`: **7 bestanden** (zusätzlich Dateibytes und
|
||||
SQLite-Schema/Rows, Symlink-/Hardlink-Verweigerung). Syntaxprüfung des Bootstraphelpers
|
||||
bestanden. Kein erneuter positiver Browser- oder nativer Agentdienstnachweis.
|
||||
- Zwei konkrete Bootstrapaufrufe scheiterten im privaten Remote-Kommandopfad:
|
||||
`command failed; private diagnostics withheld`. Nach dem zweiten Fehlschlag
|
||||
angehalten. **Remote-Teiländerungen nicht ausgeschlossen**, Migration/Dienstkonto/
|
||||
Installation nicht als abgeschlossen behaupten. Kein erfolgreiches lokales
|
||||
`bootstrap.json`-Ergebnis. Vor Fortsetzung remote etwaiges
|
||||
`/etc/rmm/vm-bootstrap-report.json` und create-only Ressourcen kontrolliert prüfen;
|
||||
keine pauschale Löschung, kein Journalreset oder Reenrollment zur Reparatur.
|
||||
- Der Helper ruft keinen Agentstart auf; kein eigener Tunnel wurde erstellt.
|
||||
Hello-World-Plan, UI-Genehmigung, Audit- und Jobnachweise weiterhin nicht ausgeführt.
|
||||
Erforderliche nächste Arbeit ist die Fehlerdiagnose/Teilzustandsprüfung, nicht
|
||||
eine Behauptung erfolgreicher Migration oder ein blind wiederholter Installationslauf.
|
||||
|
||||
- Vollständige Spezifikation 1.5, Projektentscheidungen, Entwicklungsweg sowie
|
||||
Agent-/Backend-/Browserverträge vor dem Versuch gelesen. Kein RustDesk-Auftrag.
|
||||
- Tatsächlich erneut über SSH mit vorhandenen Hostkeys und
|
||||
`StrictHostKeyChecking=yes` geprüft: SSH-Benutzer hat UID 0, das erhaltene private
|
||||
Testverzeichnis gehört UID 0, vorhandene Geräteidentitätsdatei ist vorhanden.
|
||||
Kein bestehender dedizierter unprivilegierter Account namens `rmm-agent` oder
|
||||
`rmm-test` gefunden. Andere Konten wurden weder als Testaccount interpretiert
|
||||
noch übernommen. Keine Accountnamen-/Adress-/Identitätsinhalte ausgegeben.
|
||||
- `deploy/vm_job_test.py` ergänzt und tatsächlich ausgeführt. Es ist derzeit
|
||||
ausschließlich ein lesendes Readiness-Gate, **kein fertiger Deploy-/Jobrunner**.
|
||||
Exit 2 mit drei konkreten Blockern: Root-SSH braucht kontrolliertes Deployment
|
||||
unter bestehendem unprivilegiertem Account; kein solcher dedizierter Testaccount
|
||||
vorhanden; Root-eigener alter Zustand braucht kontrollierte Accountmigration.
|
||||
Kein Agentprozess und kein Listener auf 18443 vorgefunden. Geschütztes Ergebnis:
|
||||
`devstate/vm-jobs/preflight.json` (0600, Verzeichnis 0700).
|
||||
- Keinen Root-Netzwerkagenten als `agent_service` gestartet. Keine Accounts erstellt,
|
||||
keine Ownership-/Journal-/Identitätsänderung, kein Reenrollment, kein Journalreset,
|
||||
kein Tunnel, Deployment oder Serverrestart. Deshalb keine eigenen neuen Agent-/
|
||||
Tunnel-PIDs und kein Cleanup laufender Jobs erforderlich.
|
||||
- `tests/browser/vm-jobs.spec.ts` und `deploy/browser/run_vm_jobs.py` als **noch nicht
|
||||
positiv ausgeführte** Fortsetzung ergänzt. Der Browser öffnet einen ausdrücklich
|
||||
bezeichneten bestehenden Antrag, prüft null Jobs vor Genehmigung, vollständigen
|
||||
festen Einziel-Hello-World-Preview mit `agent_service`, exakte Skriptbytes,
|
||||
erwartete Ausgabe, Limits und gespeicherten Planhash, dann ausschließlich Checkbox
|
||||
und sichtbaren Genehmigungsbutton. Keine direkte API-/DB-Freigabe. Isolierter
|
||||
NSS-Truststore und bestehender geheimnisunterdrückender Reporter bleiben erhalten.
|
||||
- Tatsächlich ausgeführt: `python3 tests/vm_job_guards.py` (**5 bestanden**),
|
||||
Python-Syntaxprüfung der drei neuen Pythondateien, `npm run typecheck`
|
||||
(**bestanden**), `npm test -- src/api.test.ts` (**9 bestanden**).
|
||||
`npm run test:browser -- vm-jobs.spec.ts --list` war nur Testdiscovery;
|
||||
ausdrücklich **kein Browserlauf und kein VM-Jobnachweis**.
|
||||
- Nicht ausgeführt: aktueller kompatibler Agentbuild/-transfer, Signingkey-bootstrap,
|
||||
Bindingsabgleich, native nichtprivilegierte Agentstrecke, MCP-Plan/Submit für die VM,
|
||||
positive UI-Genehmigung, Audit-/Grant-/Journal-/Outputprüfung, Inventory-/Logjobs,
|
||||
Redelivery/ACK-Replay, systemd-, Paket-, Update- oder Rebootwirkungen. Das alte
|
||||
Artefakt aus dem passiven Nachweis wurde nicht als aktueller Build ausgegeben.
|
||||
- Nächster konkreter Schritt: dedizierten unprivilegierten Testaccount und eng
|
||||
begrenzte Migration der **erhaltenen** VM-Geräteidentität abstimmen. Danach
|
||||
Agentbuild und Deployment implementieren; vorhandenen Sync-/Reconnect-Schutz
|
||||
respektieren, niemals Safetyflag/Journal löschen. Frische Telemetrie unter 90 s,
|
||||
Auditursprung/Testprincipal und authentisierte Job-/Bootbindung bleiben offene
|
||||
Nachweise. Bei unklarer Wirkung kein weiterer Versuch. **Kein Linux-MVP-Abschluss.**
|
||||
|
||||
## Implementiert
|
||||
|
||||
- Sechs tatsächlich verwendete Rust-Crates: Domain, Protobuf-Protokoll, SQLx-Persistenz,
|
||||
Server (interne API-/Gateway-/TLS-Module), Linux-Collector und Agent (Transport/SQLite).
|
||||
Weitere Spec-Crategrenzen werden erst bei benötigten Anwendungsfällen extrahiert;
|
||||
keine leeren Worker-, MCP-, UI- oder Executor-Platzhalter.
|
||||
- Gepinnte stabile Toolchain 1.99.1. Beim Bootstrap live über den offiziellen Stable-
|
||||
Manifestkanal ermittelt: Manifestdatum 2026-10-15, rustc Commit `58cf8f9c3`.
|
||||
Cargo.lock hält die tatsächlich aufgelösten Bibliotheksversionen fest.
|
||||
- Docker-Compose-Projekt `rust-discovery-dev`, PostgreSQL intern, separater Migrator,
|
||||
API/Gateway nur über PC-Loopback 18443. Migrationen und Keys werden nicht im Image erzeugt.
|
||||
Serverrollen `api|gateway|all` getrennt auswählbar; API-only lädt keinen CA-Privatschlüssel.
|
||||
GitHub-Actions-Prüfworkflow angelegt, aber noch nicht auf einem CI-Runner ausgeführt.
|
||||
- Zwei Dev-Mandanten, zufällige getrennte Leser-Bearer. Expliziter Dev-Modus; Produktion
|
||||
wird grundsätzlich verweigert, bis echte Produktionsauthentisierung implementiert ist.
|
||||
- RLS auf Tenant-/Asset-/Agent-/Beobachtungsdaten. App ist weder Eigentümer, Superuser
|
||||
noch BYPASSRLS. Kontext über `set_config(..., true)` je Transaktion. Eng begrenzte,
|
||||
nicht öffentlich ausführbare SECURITY-DEFINER-Funktionen nur für Tokenverbrauch und
|
||||
Zertifikatfingerprint → Gerätebindung. Keine tenant_id im Telemetriepayload.
|
||||
- Atomarer Verbrauch eines gehashten einmaligen 15-Minuten-Enrollment-Tokens und
|
||||
Geräteanlage. Lokal erzeugter EC-Geräteschlüssel; CSR-Signaturprüfung; 30-Tage-Clientzertifikat.
|
||||
- rustls-TLS direkt im Rust-Server. Optionale Clientidentität ausschließlich für Enrollment/
|
||||
Dev-Lese-API; WSS verlangt gültiges Clientzertifikat plus registrierte, nicht widerrufene
|
||||
Leaf-Fingerprintbindung. Identität kommt aus der TLS-Verbindung, nie HTTP-Headern.
|
||||
- Binäre Protobuf-Envelope 1.0, begrenzte Frames, Hello, DB-Verbindungsgeneration/Fencing,
|
||||
flüchtiger frischer Heartbeat, einteiliger SHA-256-geprüfter `linux.base`-Snapshot,
|
||||
dauerhafter ACK nach Commit. Unbekannte Typen/Versionen werden nicht ausgeführt.
|
||||
- SQLite mit synchronem Sequenzzähler, einem begrenzten unbestätigten Snapshot,
|
||||
Replay/Deduplizierung und exklusivem Prozesslock. Kein Jobjournal, weil keine Jobs existieren.
|
||||
- Read-only nativer Linux-Collector für OS, Hostname, Architektur, verfügbare Root-Bytes/Inodes.
|
||||
Quelle/Erhebungs-/Empfangszeit, Teilinventar und unbekannter Gesundheitszustand sind sichtbar.
|
||||
- Begrenzte Fehlerantworten mit Code/Korrelation ohne Request-/Secret-Echo. 128 Verbindungen,
|
||||
TLS-/Hello-/Send-/Idle-Timeouts, Body-/Frame-Limits und einfache Kanalrate. Keine Lastfreigabe.
|
||||
|
||||
## Prüfprotokoll
|
||||
|
||||
Letzter tatsächlich ausgeführter Stand:
|
||||
|
||||
- Native Toolchaininstallation 1.99.1 erfolgreich.
|
||||
- `cargo build --locked -p rmm-server -p rmm-agent`: erfolgreich.
|
||||
- Vier betroffene Unit-Tests: erfolgreich (Dev-/Prod-Grenze, Golden-Wire,
|
||||
native lokale Linux-Inventur, SQLite-Persistenz/Lock).
|
||||
- Clippy aller sechs verwendeten Crates/Targets mit `-D warnings`: erfolgreich.
|
||||
- Abschließender nativer Build, `cargo fmt --all --check`, dieselben vier Unit-Tests
|
||||
und Clippy inklusive Fehlermiddleware/Serverrollen: erfolgreich.
|
||||
- Python-Syntaxprüfung für `deploy/dev.py`/`tests/local_integration.py`: erfolgreich.
|
||||
- Docker-Releasebuild von Server und Agent erfolgreich. PostgreSQL auf frischem eigenen
|
||||
Volume gestartet; SQLx-Migration erfolgreich (Migrationscontainer mit Exit 0).
|
||||
- **Dev-PKI repariert und lokal geprüft (2026-11-12).** Frühere Fehler: doppelte
|
||||
BasicConstraints aus Host-Konfiguration/`-addext`, danach fehlgeschlagener
|
||||
`/dev/null`-Konfigurationsversuch. Jetzt vollständige isolierte `deploy/openssl.cnf`
|
||||
mit CA-/Server-/Clientrollen, expliziten Extensions und DNS-SAN `rmm-dev.internal`.
|
||||
- `python3 tests/bootstrap.py`: zweimal erfolgreich auf Host-OpenSSL **1.1.1w**.
|
||||
Prüft frische PKI trotz absichtlich defekter Host-Konfiguration, eindeutige CA-/Server-
|
||||
BasicConstraints/KeyUsage, Servername/-zweck, Clientzweck, TLS-Parser, Dateirechte
|
||||
und Verweigerung des Überschreibens.
|
||||
- Bestehende projektlokale Dev-Zertifikate kontrolliert neu ausgestellt: zuvor **0**
|
||||
registrierte Agentidentitäten geprüft; CA-/Serverschlüssel unverändert, alte öffentliche
|
||||
Zertifikate privat unter gitignored `devstate/` gesichert. Kein DB-/Volume-Reset.
|
||||
- Erster Integrationslauf nach PKI-Reparatur: `ConnectionRefusedError`, obwohl der
|
||||
Server erfolgreich startete. Docker zeigte konfigurierte PortBindings, aber leere
|
||||
NetworkSettings.Ports auf internem Backend-Bridge-Netz. Separates Ingress-Netz nur
|
||||
für den Server ergänzt; danach `127.0.0.1:18443` tatsächlich veröffentlicht,
|
||||
PostgreSQL weiterhin ohne veröffentlichten Port (beides per Docker inspect geprüft).
|
||||
- Folgender Lauf erreichte TLS/RLS/Enrollment, scheiterte aber an `BrokenPipeError`
|
||||
beim Senden eines absichtlich übergroßen Frames: Server darf bereits den Header
|
||||
ablehnen. Test berücksichtigt nun Transportabbruch auch während `sendall`.
|
||||
- `python3 tests/local_integration.py`: anschließend **vollständig erfolgreich**.
|
||||
Echte lokale Enrollment-/mTLS-/WSS-/Heartbeat-/Inventarstrecke, TLS-Trust-/Namensfehler,
|
||||
anonyme/gefälschte Identität, Protokollmajor/fremde Agent-ID, alte Heartbeats, Größenlimit,
|
||||
RLS ohne Kontext/Transaktionsreset/Cross-Tenant-Insert, Leser-Tenantgrenzen,
|
||||
Rollenrechte, Enrollment-Rennen/CSR-Rollback, Agentneustart/Fencing und Widerruf geprüft.
|
||||
Keine Job-/Outbox-/Startgranttabellen vorhanden. Kein VM-Erfolgsnachweis.
|
||||
- Wiederholter Migrationscontainer: Exit **0**. Python-Syntaxprüfung für `deploy/dev.py`,
|
||||
`tests/bootstrap.py`, `tests/local_integration.py`: erfolgreich. Rust-Code unverändert;
|
||||
Rust-Build/Unit-Tests/Clippy in diesem PKI-Fix nicht erneut ausgeführt.
|
||||
- CI und VM-/systemd-Abnahme weiterhin **nicht ausgeführt**. Keine SSH-/Tunnel-/VM-
|
||||
Verbindung und keine Jobs, Updates oder Reboots in diesem Reparaturlauf.
|
||||
|
||||
## VM-Zugang und echter passiver VM-Nachweis
|
||||
|
||||
### VM-Zugangsvorbereitung, 2026-11-12
|
||||
|
||||
- `deploy/vm_access_check.py` ergänzt: striktes Datenparsing ohne Credentialausgabe,
|
||||
Prüfung von Eigentümer/0700-/0600-Modi und Ignore-Regel, vorhandene Benutzer-Hostkeys,
|
||||
strikte SSH-Namens-/Hostkeyprüfung. Fehlende/geänderte Hostkeys werden nicht akzeptiert;
|
||||
ein gegebenenfalls ausgegebener Scan-Fingerprint ist ausdrücklich unbestätigt.
|
||||
- Auf der tatsächlichen VM erfolgreich ausgeführt: minimaler lesender SSH-Check.
|
||||
Beobachtet: Ubuntu 24.04, Linux x86-64, glibc 2.39, Benutzerhome vorhanden;
|
||||
Port 18443 zum Prüfzeitpunkt frei. Keine privaten VM-Ziel-/Hostnamewerte dokumentiert.
|
||||
- `python3 tests/vm_access_check.py`: fünf Tests bestanden. Python-Syntaxprüfung bestanden.
|
||||
Keine Rust-Änderungen; Rust-/Docker-/Integrationstests in diesem Schritt nicht wiederholt.
|
||||
- Beim ersten Zugangscheck noch kein Reverse-Tunnel/Agentdeployment; nach ergänzter
|
||||
Pflichtlektüre wurde die folgende reale passive Strecke ausgeführt.
|
||||
|
||||
### Tatsächliche VM-Passivstrecke, 2026-11-12
|
||||
|
||||
- `deploy/vm_passive_test.py` ergänzt und erfolgreich ausgeführt: vorhandene Prozesse/
|
||||
Portbelegung prüfen, konkretes Docker-Agentartefakt auf ELF/glibc/Libraries prüfen,
|
||||
strikten PC-initiierten Loopback-Reversetunnel mit Keepalive herstellen und VM-Listener
|
||||
prüfen, ausschließlich benutzerlokal in neuem privaten Testverzeichnis deployen.
|
||||
- VM Ubuntu 24.04 x86-64/glibc 2.39; Artefakt benötigt maximal glibc 2.34. Konkrete
|
||||
Bibliotheksauflösung mit VM-Loader vor nativem Agentstart erfolgreich.
|
||||
- Enrollment mit einmaligem Dev-A-Token, lokal auf VM erzeugter Geräteidentität,
|
||||
vertrauter öffentlicher CA und bestehendem TCP-Override erfolgreich. TLS-SNI und
|
||||
Namensprüfung bleiben `rmm-dev.internal`; keine Zertifikatsprüfung ausgeschaltet.
|
||||
- Echtes VM-Inventar serverseitig über tenantgebundene Lese-API bestätigt: OS/Architektur,
|
||||
intern verglichener Hostname und positive verfügbare Root-Bytes/Inodes;
|
||||
`linux.base`, `partial`, Erhebung 16:40:12.632 UTC, Empfang 16:40:12.796518 UTC.
|
||||
Zwei frische Heartbeats um 16:40:44.849118 und 16:41:12.779675 UTC; Präsenz `online`.
|
||||
Leser von Dev-Mandant B sieht diese Geräteidentität nicht.
|
||||
- Eigene Agent-PID 4141792 nach exakter Executable-Prüfung per SIGTERM beendet und
|
||||
Prozessende bestätigt; eigene Tunnel-PID 1869118 beendet und darauf gewartet.
|
||||
Kein aktiver Testrecord; privates Benutzer-Testverzeichnis bleibt mit Zustand/Log,
|
||||
Tokenkopie entfernt. Geschützte Evidenz/PIDs/privater Pfad unter
|
||||
`devstate/vm-passive/result.json`; Details und ausgeführte Befehle in `docs/development.md`.
|
||||
- Fünf Parser-Tests und drei lokale Orchestrierungs-Guardtests bestanden,
|
||||
Python-Syntaxprüfung bestanden. Abschließender lesender VM-SSH-Check bestätigt
|
||||
Port 18443 nach Testende wieder frei. Keine Ruständerung;
|
||||
Build/Clippy/andere Integrationstests in diesem Schritt nicht wiederholt.
|
||||
- Kein systemd-/Rootbootstrap, keine Pakete/Hosts-/Firewall-/sshd-Änderungen, keine Jobs,
|
||||
Updates oder Reboots. Kein DB-/PKI-Reset. Passiver VM-Erstnachweis, **kein M1-Abschluss**.
|
||||
|
||||
## Bewusste Grenzen / keine Abnahmen behaupten
|
||||
|
||||
- Linux-M1 ist **teilimplementiert**, nicht abgenommen: passiver realer VM-Erstnachweis liegt vor,
|
||||
keine systemd-Installation, Zertifikatsrotation, Recovery nach Zertifikatsablauf,
|
||||
Long Polling, Proxyabnahme oder belastbare Klon-/Restoreerkennung.
|
||||
- Windows beginnt erst nach Linux-MVP-Abnahme; kein Windows- oder ARM-Supportnachweis.
|
||||
- CA-Signierung befindet sich nur im expliziten lokalen Dev-Gateway. Keine produktive
|
||||
Rollentrennung/Signer-Isolation, OIDC, UI/MCP, Audit-WORM, HA oder Betriebsreife.
|
||||
- Keine Jobs, Pläne, Genehmigungsendpunkte oder Executor. M2 darf erst mit echter
|
||||
interaktiver WebUI-Freigabe implementiert/ausgeführt werden; keine Testausnahme.
|
||||
- Snapshot-Scope beschränkt auf ein Root-Dateisystem, Qualität `valid` nur bei erfolgreicher
|
||||
vollständiger lokaler Erhebung dieses Teilscopes. Fehler schließen den Kanal statt Werte
|
||||
zu erfinden. Weitere Volumes/Software/Updates/Dienste sind nicht implementiert.
|
||||
- Journal auf einen Snapshot begrenzt. Alter über 72 Stunden sperrt Übertragung und braucht
|
||||
noch einen ausdrücklich entworfenen Gap-/Recoverypfad. Kein stilles Verwerfen/Erfolgs-ACK.
|
||||
- Antwortverlust nach Enrollment-Commit benötigt in diesem Entwicklungsslice ein neues
|
||||
Token/Enrollment; keine automatische Recovery mit unbewiesener Identität. Teilgeschriebene
|
||||
lokale Identitätsdateien benötigen kontrollierte manuelle Recovery.
|
||||
- Widerruf wird bei Reconnect und jeder Nachricht geprüft. Keine CRL/OCSP-Infrastruktur;
|
||||
bestehende stille Kanäle enden spätestens durch 65-Sekunden-Idle-Timeout bzw. nächste
|
||||
Nachricht. Keine Jobzustellung, die dieses Intervall ausnutzen könnte.
|
||||
- Geräteliste max. 100 mit sichtbarer Trunkierung, keine Cursor/Einzelgeräteansicht. Alte
|
||||
Beobachtungen aktualisieren keine Präsenz; aktuelle Inventaransicht wählt neueste Erhebungszeit.
|
||||
- Image-Tags/Lockfile sind gepinnt, Images noch nicht über Digest/SBOM/Supply-Chain-Verfahren
|
||||
freigegeben. Keine Produktionspasswörter/Private Keys oder VM-Credentials im Quellcode.
|
||||
|
||||
## Nächster Slice
|
||||
|
||||
1. Lokaler PKI-/TLS-/RLS-E2E-Nachweis liegt vor; vor weiterer Nutzung Gerätestatus und
|
||||
Testhistorie prüfen. Fehlgeschlagene frühere Integrationsläufe können Testidentitäten
|
||||
hinterlassen; keine vorhandenen Agentidentitäten oder Schlüssel pauschal ersetzen.
|
||||
2. SSH-Zugang, konkretes Artefakt und passive VM-Strecke über Loopback-Reversetunnel
|
||||
sind geprüft; private Testidentität/Verzeichnis für kontrollierte Fortsetzung erhalten.
|
||||
3. Reconnect, Widerruf und systemd-Lebenszyklus auf VM nachweisen; eine dauerhafte
|
||||
Dienstinstallation erst nach klarer Bootstrapfreigabe durchführen.
|
||||
PID/Logs ohne Secrets dokumentieren; keine Updates/Reboots/fremden Paketinstallationen.
|
||||
4. Linux-M1 um Rotation/Recovery/Long Polling und gezielte Fehlerabnahmen vervollständigen.
|
||||
5. Erst danach M2 mit persistenter Antragsstrecke und minimaler menschlicher WebUI-Genehmigung.
|
||||
@@ -0,0 +1,68 @@
|
||||
# Verbindliche Projektentscheidungen
|
||||
|
||||
Stand: **2026-11-12**, Spezifikation **1.5** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.4 führte Linux-first ein; 1.5 dokumentiert die neuen Userentscheidungen zur dev/test-Browsersimulation und zum MVP ohne RustDesk. Dieses Dokument fasst Entscheidungen zusammen und behauptet keinen Implementierungsstand.
|
||||
|
||||
## Produkt und Ausbaustufen
|
||||
|
||||
- **Linux-first für ALLE Features:** Zuerst tatsächliche Ausführung und Nachweis auf der Linux-Test-VM, nicht nur PC-/Containerlauf, Simulator oder Cross-Build.
|
||||
- **Erstes Phasenziel Linux-MVP (M0–M5):** Eigenständiger Linux-Agent x86-64, WebUI, MCP und autorisierte dauerhafte Jobs. Windows-x86-64-Implementierung und native Abnahmen folgen erst nach dokumentierter Linux-MVP-Abnahme. Physische Geräte und beliebige VMs sind gleichberechtigt; ein Gast mit unbekanntem Host/Hypervisor ist vollständig verwaltbar. Kein PVE-Agent, Proxmox-Host oder Hypervisorzugang erforderlich.
|
||||
- **Noch später:** M6a: Monitoringausbau und ARM64 mit nativen Tests. M6b: Proxmox-Modul/-Client auf demselben Linux-Agenten, Cluster und Backupbeobachtung samt Abnahmen; PBS optional. Keine vorgezogene PVE-Implementierung/-Abnahme als Teil des Linux-MVP oder vor der Windows-Phase.
|
||||
- **Weitere Betriebsreife (M7):** Terminal, signierte Agentupdates, Restoreverfahren, Lasttests und belastbarer Betrieb. M8 bewahrt optionale Geschäftsleistungen und zusätzliche Provider.
|
||||
- Keine eigene grafische Fernsteuerung; RustDesk bleibt eine getrennte Anwendung mit eigener Infrastruktur.
|
||||
- **Neuer Useroverride 2026-11-12:** „rustdesk musst du nicht machen ... das lasse aus“. RustDesk entfällt vollständig aus dieser Umsetzung: keine Installation, Profile/Provisionierung oder externe Desktopabnahme. M4 bleibt allgemeine Linux-Paketverwaltung; M5 prüft die drei übrigen Referenzabläufe ohne RustDesk. Bestehende RustDesk-Architekturtexte sind nur spätere optionale Integrationsverträge, keine MVP-Pflicht oder Abnahmeblocker. Keine eigene Desktop-Engine als Ersatz.
|
||||
|
||||
## WebUI-Genehmigung für alle Jobs
|
||||
|
||||
Die folgenden Produktregeln bleiben unverändert. Ausschließlich für diese Entwicklungsabnahme gilt die danach dokumentierte Bedienungsausnahme; kein Job darf die UI-Genehmigung überspringen.
|
||||
|
||||
- Jeder zur Ausführung eingestellte Job aus Menschen/UI, MCP oder Automatik benötigt vorher explizite Genehmigung eines berechtigten Menschen in der WebUI. Das gilt bereits für Hello World und ebenso für Live-Diagnosen, Reboot-Folgejobs und Retry/neue Versuche.
|
||||
- `operations.plan` speichert einen unveränderlichen Plan. `operations.submit` speichert ausschließlich einen dauerhaften Antrag `pending_approval` mit `operation_id`, noch keine ausführbaren Jobs oder Outbox. `jobs.get(operation_id)` zeigt diesen Antrag auch ohne Jobs.
|
||||
- Die WebUI zeigt alle festen Einzeljobs/Versuche, Zielanzahl und Zielgeräte, Inhalte und Skript-/Paketbyteshash, Fristen und Auswirkungen. Explizite Sammelgenehmigung dieses festen Pakets ist möglich; Dauer-/Wildcardfreigaben nicht. Erst Genehmigung erzeugt atomar Nachweis, Ausführung, Jobs und Outbox. JobOffer und Startgrant sind vorher verboten.
|
||||
- Policies dürfen nur begrenzen oder verweigern. MCP darf vorbereiten und beantragen, niemals genehmigen. MCP-/Automatisierungstokens sind selbst mit Approver-Rolle nicht freigabefähig; Freigabe verlangt authentisierten interaktiven WebUI-Kontext.
|
||||
- Geänderte Ziele, Bytes, Parameter, Fristen oder neue Versuche erfordern einen neuen menschlich genehmigten Plan. Redelivery desselben Versuchs erfordert keine neue Genehmigung, erlaubt aber keine zweite Wirkung. Technischer Grant-Ersatz nur bei nachgewiesenem Nichtstart und gültiger ursprünglicher Genehmigung.
|
||||
- Passive Standardtelemetrie/Heartbeat und Lesen bereits gespeicherter Daten sind keine Jobs und benötigen keine Einzelgenehmigung. Neue Live-Erhebung darf nicht als passive Telemetrie umgangen werden. Gebundene Nachprüfungen gehören zum genehmigten Job.
|
||||
|
||||
### Explizite Userentscheidung zur Entwicklungsabnahme (2026-11-12)
|
||||
|
||||
Der User hat neu ausdrücklich angeordnet: „Setz Linux MVP vollständig um und simuliere die menschlichen Aktionen. Du kannst Server auch neustarten“.
|
||||
|
||||
- Ausschließlich im **expliziten dev/test-Profil** darf Browserautomatisierung tatsächliche WebUI-Interaktionen einschließlich Genehmigung des angezeigten unveränderlichen Plans durchführen. Der Testprincipal muss deutlich sichtbar als **simulierter Testprincipal** gekennzeichnet sein; keine tatsächliche menschliche Identität vortäuschen.
|
||||
- Dies ist die einzige erlaubte simulierte Freigabe/Testausnahme, keine Dev-Autofreigabe, Testpolicy oder Code-Abkürzung. Jeder Job bleibt bis zur interaktiven UI-Genehmigung `pending_approval`; vorher keine ausführbaren Jobs, Outbox, JobOffers, Startgrants oder Wirkung. Planbindung, Rechte-, Tenant- und Policyprüfungen bleiben erhalten.
|
||||
- Audit muss `approval_origin` als browsergesteuerte dev/test-Simulation und `testsimulation` als wahr kennzeichnen und Testprincipal, Profil, Zeitpunkt und Planbezug nachvollziehbar zuordnen. Das sind Umsetzungsanforderungen, keine Behauptung bereits vorhandener Auditfelder oder bestandener Tests. Simulation und tatsächliche menschliche Genehmigung getrennt nachweisen; **kein Produktions-Freigabenachweis**.
|
||||
- KI/MCP dürfen weiterhin **keine direkten API-/DB-Freigaben** vornehmen und kein Token erhalten, das die interaktive Grenze unterläuft. Normale, über die WebUI ausgelöste Browserrequests bleiben an deren interaktiven Kontext gebunden. Produktionsverhalten und tatsächliche menschliche WebUI-Genehmigung in Produktion bleiben unverändert; die Simulation darf dort nicht verfügbar sein.
|
||||
- Lokale Serverneustarts sind ausdrücklich erlaubt. Keine impliziten VM-Reboots, Updates oder destruktiven Zieltests; Zieltestumfang weiterhin gesondert ausdrücklich abstimmen. RMM-Jobs behalten ihren festen WebUI-genehmigten Plan.
|
||||
|
||||
Die frühere absolute Aussage „keine simulierte Freigabe und keine Testausnahme“ wird ausschließlich für diese browsergesteuerte dev/test-Bedienung präzisiert. Spezifikation 1.5 Kapitel 0.1 ordnet diese Ausnahme den fortbestehenden Produktregeln zu. Linux-first, reale VM-Nachweise, TLS und Credentialregeln bleiben unverändert. Dokumentierte Erlaubnis ist keine ausgeführte Simulation oder Linux-MVP-Abnahme.
|
||||
|
||||
## Verständliche Startdefaults
|
||||
|
||||
| Bereich | Startwert / Bedeutung |
|
||||
| --- | --- |
|
||||
| Architektur | Modularer Rust-Monolith, getrennt startbare API/Gateway/Worker; React/TypeScript-WebUI, PostgreSQL, kein obligatorischer Broker |
|
||||
| Verbindung | Nur vom Agenten ausgehend: WSS über TLS 443, HTTPS Long Polling als Alternative; mTLS nach Enrollment |
|
||||
| Kontakt | Heartbeat alle 30 s mit Jitter; nach 90 s `stale`, nach 180 s `unreachable` – kein Beweis, dass das Gerät ausgeschaltet ist |
|
||||
| Daten | Systemmetriken alle 60 s; Vollinventar bei Start und täglich; Quelle und Datenalter immer sichtbar |
|
||||
| Genehmigung | Immer erforderlich für Ausführungsjobs, nicht abschaltbar; keine erlaubende Defaultpolicy |
|
||||
| Fristen | Planfrist ausdrücklich je Plan, UI-Vorschlag 24 h; Startgrant 60 s, nur für festen Versuch, kein neuer Offline-Start |
|
||||
| Enrollment | Nachweis einmalig, 15 min; Gerätezertifikat 30 Tage, Rotation spätestens nach 20 Tagen beginnen |
|
||||
| Rollout | Ein Rebootziel gleichzeitig je Abhängigkeitsgruppe; mehr Parallelität nur im menschlich genehmigten Plan innerhalb begrenzender Policies |
|
||||
| Fehlende Konfiguration | `not_configured`; nur betroffene Integration sperren, keine Werte oder Erfolge erfinden |
|
||||
|
||||
Die vollständigen Limits und Plattformabnahmen stehen in der Spezifikation. ARM64 ist bis zur nativen Abnahme geplant, kein MVP-Supportversprechen. Lokale Testidentitäten sind ausschließlich im expliziten Entwicklungsprofil erlaubt, niemals im Produktionsprofil.
|
||||
|
||||
## Repository, Infrastruktur und Zugänge
|
||||
|
||||
- Repository: <https://gitea.incoso.eu/kevin_janssen/rust-discovery>
|
||||
- SSH: `ssh://git@gitea.incoso.eu:2222/kevin_janssen/rust-discovery.git`
|
||||
- Bekannte RustDesk-Serveradresse: `rust.ease-technologies.de`. **Edition, Ports, öffentlicher Serverschlüssel und Version sind noch unbekannt.** Kein angenommenes Standardport-/443-/WSS-Profil und keine erfundene Version; vor Bereitstellung konkrete Konfiguration prüfen.
|
||||
- Lokaler Zugangspfad: `credentials/` im Projekt, durch `.gitignore` ausgeschlossen und niemals committen. Hier wird nur der Pfad dokumentiert; Secrets werden dafür nicht gelesen. Dateien nur als Daten behandeln, niemals mit `source` oder `eval` ausführen. Keine Secrets in normalen Logs, Jobausgaben oder MCP-/LLM-Kontexte übernehmen.
|
||||
- Benötigte Entwicklungs-/Testtools dürfen ausdrücklich installiert werden. Daraus folgt keine Genehmigung von Änderungen oder Neustarts auf Kundensystemen. Plattformjobs in Entwicklungsumgebungen behalten die WebUI-Genehmigungspflicht; nur die oben dokumentierte dev/test-Browsersimulation darf die tatsächliche menschliche Bedienung ersetzen. Lokale Serverneustarts sind für diese Entwicklungsabnahme ausdrücklich erlaubt.
|
||||
|
||||
## Verbindlicher lokaler Entwicklungsweg
|
||||
|
||||
- Regeln für alle AIs: `AGENTS.md`; geplanter, nicht getesteter Ablauf und Nachweisgates: `docs/development.md`.
|
||||
- Server lokal in Docker auf dem Entwickler-PC; veröffentlichte Ports ausschließlich Loopback, insbesondere `127.0.0.1:18443`. PC initiiert SSH zur VM mit `-N -T -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -o ServerAliveCountMax=3 -R 127.0.0.1:18443:127.0.0.1:18443`. SSH-Hostschlüssel vorher verifizieren, keine öffentliche Forward-Bindung.
|
||||
- VM-Agent verbindet sich ausgehend über VM-Loopback. TLS bleibt Ende-zu-Ende mit DNS SAN `rmm-dev.internal`; auf der VM `/etc/hosts`: `127.0.0.1 rmm-dev.internal`, alternativ getesteter Connect-Override unter Erhalt von SNI/Namensprüfung. Dev-CA vertrauen, niemals ungültige Zertifikate akzeptieren. SSH nur Dev/bootstrap, kein Ersatz für Enrollment/mTLS, RMM-Autorisierung oder Genehmigung.
|
||||
- VM-Daten: `credentials/linux-vm.conf`, Verzeichnis durch `.gitignore` ausgeschlossen, Modus 700 für `credentials/`, 600 für die Datei. Strikt als Daten parsen, kein `source`/`eval`; keine Secrets lesen/loggen/committen oder in LLM-Kontexte übernehmen.
|
||||
- Auch Linux-Dev hat keine Jobfreigabeabkürzung: erst `pending_approval`, dann WebUI-Genehmigung durch einen berechtigten Menschen oder ausschließlich die oben dokumentierte dev/test-Browsersimulation. Passives Standardinventar ist kein Job. Keine impliziten Reboots, Updates oder destruktiven Tests auf dem Ziel; ausdrücklich gesondert abstimmen, RMM-Jobs zusätzlich über ihren festen Plan in der WebUI genehmigen.
|
||||
- Kein Erfolg ohne realen Nachweis. Geplante Befehle und nicht ausgeführte Tests ausdrücklich so kennzeichnen; fehlende VM-Abnahme bleibt offen.
|
||||
Reference in New Issue
Block a user