Files
rust-discovery/README.md
2026-11-15 13:42:37 +01:00

123 lines
8.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Rust Discovery / RMM
**Stand 15. November 2026, Spezifikation 1.23.** Linux M0–M5 ist auf der
Ubuntu-Cloud-VM im dev/test-Betrieb abgenommen. Der zusätzliche Auftrag umfasst
die Windows-11-VM, die genehmigte Skriptkonsole und den Agent-Selbstupdater.
Beide aktiven Geräte melden sich an `discovery.ease-technologies.de` und sind
über MCP mit gespeicherten Inventardaten abrufbar. Das Notebook dient der
Entwicklung. [Abgleich der Geräte nach dem Gatewaywechsel](docs/server-time-gateway-deploy.md)
## Tatsächlich nachgewiesen
| Bereich | Aktueller Nachweis |
| --- | --- |
| M0 | Gepinnter Rust-Workspace, Migrationen/RLS, native ARM64-Serverbuilds und erhaltende Deployments; getrennte API-/Gatewayrollen, PostgreSQL intern und Verwaltungszugang über SSH-Tunnel. |
| M1 | Nativer unprivilegierter Linux-Dienst, Enrollment/mTLS, WSS und HTTPS, passives Inventar/Heartbeats; tatsächlicher Auto-Fallback nach zwei WSS-Abweisungen. TLS-Negativfälle, Rotation und Widerruf nachgewiesen. Generalhelper nach kontrollierter Startverweigerung automatisch wieder angelaufen. |
| M2 | Feste persistente Anträge, tatsächliche WebUI-Genehmigung, Journale/Startgrants; Hello, Live-Inventur und Rootdienstjobs; Doppelzustellung und verlorenes Ergebnis-ACK ohne zweite Wirkung. Aktiver Offline-Wiederkontakt, Ablauf und UI-Genehmigungsentzug bestanden. Agentprozessabbruch mit dauerhaftem lokalem/zentralem Unknown, Abschluss desselben Verbrauchs und unabhängigem Zähler 1 bestanden. |
| M3 | Gespeicherte Geräte-/Jobergebnisse über WebUI, HTTP und MCP; Mandantentrennung; separat genehmigte begrenzte Rootlogs mit Quelle, Zeit und ehrlicher Teilabdeckung. |
| M4, begrenzter Katalog | Echtes Fixture-Update 1.0→1.1 mit unabhängiger Paket-/Nutzdateinachprüfung und nativer Acceptance; danach eigene erfolgreiche `ensure_package`- und `apply_updates`-Noops auf 1.1. |
| M5 | MCP-Endbericht mit sieben bestehenden erfolgreichen Referenzoperationen einschließlich Reboot, festem Linuxziel und tatsächlicher Submit-Idempotenz bestanden. Der einmal genehmigte Reboot ist mit rechtzeitigem Originalbeleg, frischer Verifikation und normalem signiertem Sync desselben Grants abgeschlossen; Rebootrechte wieder geschlossen. |
Die Paketabnahme gilt ausschließlich für die gepinnten Rezepte von
`rmm-mvp-test` auf Ubuntu 24.04 x86-64. Beide Noops belegen
`changed=false`, `already_desired=true` und `transaction_executed=false`;
`apply_updates` ist dabei keine zweite Updateausführung. Der tatsächliche
Host-Neustartbedarf war bei diesen Paketjobs sichtbar `true`; sie stießen
keinen Reboot an. Beliebige Pakete, Repositories sowie OS-/Kernelupdates sind nicht
abgenommen.
Frühere APT-Teilwirkungen und der Configureversuch wurden originalgebunden und
über normalen signierten Sync ehrlich als fehlgeschlagene Abnahmen geschlossen.
Eine fehlende historische Host-Vorhermessung wurde nicht erfunden. Auch der erste
Noop mit veralteter Baseline bleibt als wirkungsloser `STATUS_FINGERPRINT`-Fehler
erhalten; der spätere erfolgreiche Noop hatte einen eigenen festen UI-Plan.
Am ursprünglichen Reboot blockierte zuerst die beim Boot unvertraute Uhr den
Helperstart, später das volle 256-MiB-Journal den Sync. Eine eigene DBkopie
belegte `SQLITE_FULL`; derselbe Insert gelang bei der endlichen 1-GiB-Grenze,
jeweils mit vollständigem Rollback und unverändertem Original. Neue Agent-/
Helperartefakte sind mit 126 lokalen Tests qualifiziert. Die aktuelle
APT-Laufzeit wurde danach separat an einer Kopie nativ nachqualifiziert;
dies wiederholt keine Paketwirkung oder historische Acceptance.
Der signierte Rebootabschluss ist nun erfolgreich: 18 geschlossene
Rootverbräuche, alte Ledgerzeilen und Datenbank-Inodes erhalten. Es gab keinen
zweiten Reboot; die ursprüngliche Generalpolicy ist wiederhergestellt.
Die begrenzte Helper-Startwiederholung (`on-failure`, 5 Sekunden) ist ebenfalls
nativ geprüft: Startfehler bleibt verweigert, nach behobener Ursache erfolgt
der automatische Wiederanlauf unter Erhalt des Zustands, ohne weiteren Reboot.
APT-Dienst und Agentendpunkt bleiben geschlossen. Der finale MCP-Bericht liest
nur sieben bestehende erfolgreiche Operationen, keine neuen Jobs.
Der native Endabgleich ist bestanden: **30 Jobs / 30 Outbox / 26 Grants /
0 ungeklärte Wirkungen**, alle **18 Rootverbräuche geschlossen und faultfrei**,
Agent und Helper mit derselben angewandten signierten Entscheidung bereit.
Artefaktpins, erhaltene Historien, Dienstrechte und geschlossene Testgrenzen
sind im geschützten Abschlussbeleg gebunden. Dies gilt für die eine reale
Linux-Cloud-VM und das explizite dev/test-Profil.
[Abschlussaudit](docs/mvp-final-audit.md) und [Abnahmegates](docs/mvp-gates.md)
führen die Nachweise und Grenzen; weitere Arbeiten stehen unter
[Aufgaben nach dem MVP](docs/post-mvp.md).
## Genehmigung und Entwicklungsgrenzen
Jeder Ausführungsjob beginnt als persistenter Antrag `pending_approval`.
Vor dem WebUI-Klick existieren keine ausführbaren Jobs, Outboxeinträge oder
Startgrants. Die bisherigen positiven Abnahmen verwenden die ausdrücklich
erlaubte, sichtbar simulierte dev/test-Identität; das ist keine menschliche
Produktionsfreigabe. MCP und Automatik können nicht genehmigen. Passive
Standardinventur und Lesen gespeicherter Ergebnisse benötigen keinen Job.
Die Windows-11-VM wird auf eigenen Auftrag weiterentwickelt. Der passive
LocalService-Client ist mit Enrollment, mTLS, WSS und explizitem HTTPS,
gespeichertem Inventar, konkreten ACKs und Mandantentrennung nativ geprüft;
sieben native Tests bestanden. Automatischer HTTPS-Fallback nach zwei
gezielten authentisierten WSS-Abweisungen ist ebenfalls nachgewiesen;
Testhooks sind wieder geschlossen und die ursprüngliche WSS-Konfiguration
wurde unverändert wiederhergestellt. Danach wurde die bestehende VM separat
zustandserhaltend auf dauerhaft `transport=auto` umgestellt und nativ geprüft:
WSS bevorzugt, zwei frische Heartbeats und konkretes ACK, gleiche LocalService-
Identität und weiterhin keine Jobs. Dies ist keine neue Installationsabnahme.
Separate native TLS-Proben als Bootstrapadministrator belegen falsche CA,
falschen Servernamen und ein abgelaufenes Clientzertifikat, mit gültiger
Kontrolle vor und nach den Ablehnungen. Das sind keine LocalService-
TLS-Negativnachweise. Der permanente Dienst und seine Geräteidentität blieben
erhalten; private Schlüssel verließen die VM nicht.
Auf Windows laufen der passive Agent und der getrennte SYSTEM-Helper. Die
beiderseitige Identitätsprüfung zwischen den Diensten ist nativ belegt. Der
PowerShell-Executor und die Bindung an den genehmigten Plan sind implementiert.
Für die erste durchgängige Abnahme fehlen der unabhängige signierte Zeitabgleich
der beiden laufenden Rollen sowie ein WebUI-genehmigter Auftrag mit überprüfter
Ausgabe. Selbstupdates benötigen noch eine native Aktualisierung des installierten
Agent-/Helper-Paars unter Erhalt der Geräteidentität. APT- und MSI-Paketfälle
prüfen die Verwaltung anderer Software. [Windows-Abnahmen](docs/windows-gates.md)
und [Agent-Selbstupdate](docs/agent-updater-runtime-source.md).
Weitere Agentplattformen, PVE/PBS/Cluster/Backups und Betriebsreife
folgen außerhalb des Linux-MVP. RustDesk ist ausdrücklich ausgelassen.
## Projektunterlagen
- [Verbindliche Spezifikation](Rust_RMM_Implementierungsspezifikation.md),
[AGENTS.md](AGENTS.md), [Projektentscheidungen](docs/project-decisions.md).
- [Tatsächlicher Implementierungsstand](docs/implementation-status.md),
[Plattformmatrix](docs/platform-support.md), [Abschlussaudit](docs/mvp-final-audit.md).
- [Server und aktuelle Topologie](docs/server-deployment.md),
[Entwicklungsregeln](docs/development.md), [Übergabe](docs/handover.md).
- [APT-Nachweise und Hostflagvertrag](docs/apt-ambient-reboot.md),
[Zustellungsabnahme](docs/delivery-acceptance.md),
[Auto-Fallback](docs/transport-acceptance.md),
[Offlinefälle](docs/cloud-offline-acceptance.md),
[Agentabbruch](docs/agent-crash-acceptance.md),
[Reboot](docs/reboot-acceptance.md), [Journalbudget](docs/journal-capacity.md),
[Windows-Client](deploy/windows/CLIENT.md), [Aufgaben nach dem MVP](docs/post-mvp.md).
Rust und Lockdatei sind auf die vorhandene Toolchain **1.99.1** festgelegt.
Lokale Builds und isolierte Tests ergänzen die nativen Cloudnachweise.
Historische lokale Server-, Notebook-Agent- und Reverse-Tunnelanleitungen sind
keine aktuellen Startanweisungen; maßgeblich bleibt die dokumentierte Cloudtopologie.