Files
rust-discovery/docs/transport-acceptance.md
T
2026-11-13 19:46:40 +01:00

95 lines
6.1 KiB
Markdown

# Tatsächlicher automatischer WSS-/HTTPS-Fallback
Stand 2026-11-13. **Tatsächlicher passiver Cloudnachweis bestanden**, einschließlich
ergänzender Verifikation desselben Falls nach einer unten offengelegten
Auswertungskorrektur. Ein ausdrücklich gewählter HTTPS-Modus und ein
WSS-Reconnect allein ersetzen diesen Nachweis nicht.
Der minimale Entwicklungsadapter sitzt nach gültigem mTLS-Peer, Ablaufprüfung
und autoritativer Gerätebindung im WSS-Connectpfad, noch vor dem Upgrade.
Nur das konfigurierte Tenant-/Agentpaar erhält HTTP 503. HTTPS bleibt normal;
es entstehen keine JobOffers, Grants oder Genehmigungen.
Aktivierung ausschließlich mit `RMM_DEV_TRANSPORT_FAULTS=true`,
`RMM_DEV_TRANSPORT_FAULT_FILE=/root-policy/transport-fault.json`,
`RMM_PROFILE=development` und `RMM_DEV_AUTH=true`. Standardmäßig deaktiviert;
Produktionsaktivierung und mehrdeutige Konfiguration verweigern den Start.
Datei/Verzeichnis im bestehenden read-only Rootpolicy-Mount müssen UID 10001,
Modi 0600/0700 und sichere reguläre Inodes besitzen. Striktes Konfigurationsschema:
Version 1, neue Fault-UUID, exakte Tenant-/Agent-UUIDs, `issued_at` und
`expires_at` mit höchstens 15 Minuten. Kein öffentlicher Faultendpunkt.
Zwei begrenzte append-only Audit-Slots erfassen tatsächliche authentisierte
Handshakeabweisungen: Peerzertifikatfingerprint, unterschiedliche Handshake-IDs,
Status 503, Zeit sowie exakte Fault-/Scope-/Konfigurationsbindung. Nach zwei
Slots bleibt die Abweisung bis Ablauf aktiv, ohne weiteren Auditbestand
anzuhäufen. Bestehende Slots dürfen nicht mit anderer Konfiguration wieder-
verwendet werden. Keine Job-/Outbox-/Grantänderung und keine neue Migration.
Tatsächlich lokal bestanden: drei gezielte Guards für explizites Opt-in,
Produktionsverweigerung, exakten Scope, Fristen und stabile begrenzte Audit-Slots;
Server-Clippy aller Targets mit `-D warnings`; Syntaxprüfung des Cloudrunners.
`deploy/cloud_transport_acceptance.py` wurde tatsächlich für diesen Fall
ausgeführt; nach der Auswertungskorrektur wurde kein weiterer Fault aktiviert:
1. Nur permanente Cloud-VM und `discovery.ease-technologies.de`; keine offenen
Wirkungen. Bekannte Agent-/Compose-/vorherige Konfigurationshashes prüfen.
2. Den erhaltenen Agenten im tatsächlichen Automatikmodus prüfen; ausschließlich
einen bekannten alten Transport-Testoverride bei Bedarf versioniert entfernen.
Standard-WSS, Heartbeat und signierten Sync bestätigen.
3. Den begrenzten privaten Hook aktivieren. Der normale ausgehende Agent muss
zweimal an authentisiertem WSS scheitern und selbstständig auf HTTPS wechseln.
Zwei echte Peer-Auditbelege sowie anschließend gespeicherten frischen
**HTTPS-Heartbeat** und `sync_ready` nachweisen. Kein TLS-Bypass.
4. Im `finally`-Pfad Hook deaktivieren, tatsächlich laufende Serverrollen ohne
aktiven Flag/FILE prüfen und nach kontrolliertem, identitätserhaltendem
Agentneustart normalen WSS-Heartbeat samt Sync wiederherstellen.
Keine geänderte Geräteidentität, keine neuen Jobs/Outbox/Grants. Auch bei einer
verlorenen SSH-Antwort akzeptiert Cleanup ausschließlich vorher bekannte alte
oder vorgesehene neue Hashes, keinen ungeprüften Hostzustand.
## Tatsächlicher Cloudfall
Fall-ID `697b19ba-e7ff-4ebf-8a45-f5a0b0514fea`, permanente Ubuntu-Cloud-VM gegen
`discovery.ease-technologies.de`, tatsächlich geprüfter Automatikmodus.
| Tatsächlicher Beleg | Ergebnis / UTC am 2026-11-13 |
| --- | --- |
| Authentisierte WSS-Abweisung 1 | HTTP 503 um 18:21:21.708609 |
| Authentisierte WSS-Abweisung 2 | HTTP 503 um 18:21:21.737690; andere tatsächliche Handshake-ID |
| HTTPS nach beiden Abweisungen | Tatsächlicher Heartbeat und signierter Sync bereits um 18:21:22.070325 beobachtet; erhaltene ergänzende HTTPS-Aufnahme Generation 78, Heartbeat 18:23:28.546877, `sync_ready=true` |
| Hook deaktiviert | Tatsächlich laufende API/Gatewayrollen jeweils Flag `false`, FILE fehlt |
| Operative WSS-Wiederherstellung | Nach kontrolliertem Agentneustart im Automatikmodus Generation 79, Heartbeat 18:24:41.316642, signierter Sync bereit |
| Historie / Ausführungsgrenze | Vorher und nachher unverändert **19 Jobs / 19 Outbox / 17 Grants / 0 offen**; kein neuer RMM-Job oder Antrag |
| Gerätebindung | Gleiche Agent-/Asset-IDs, Enrollmentgeneration und Zuordnungsversion; beide Faultbelege mit demselben tatsächlichen Peerzertifikatfingerprint |
Der ursprüngliche Runner meldete nach tatsächlichem Fallback `KeyError`, weil
die private Bootstrap-DTO nur Agent-/Asset-IDs enthält, die Auswertung aber
zusätzliche Generation-/Zuordnungsfelder dort voraussetzte. Diese Felder werden
nun gegen den tatsächlich gespeicherten initialen Serverkanal verglichen.
Der Fehler blieb im ursprünglichen Checkpoint erhalten. Die ergänzende
Verifikation las denselben Auditfall und den tatsächlichen HTTPS-Kanal; keine
neue Fault-ID und keine Wiederholung der beiden Abweisungen.
Außerdem bleibt ein bestehender HTTPS-Aktor gegebenenfalls auf HTTPS, nachdem
der Hook entfernt wurde. `auto` wählt beim Verbinden; eine selbstständige Rückkehr
zu WSS wird hier **nicht behauptet**. Bei weiterhin null offenen Wirkungen wurde
der erhaltene Agent kontrolliert neu gestartet und dessen normale WSS-Verbindung
erneut nachgewiesen. Der korrigierte Runner führt diesen Schritt ausdrücklich
im Cleanup aus. Weder Geräteidentität, Journale, Helper/Provider noch Artefakte
wurden ausgetauscht.
Geschützte tatsächliche Belege:
`devstate/cloud-transport/697b19ba-e7ff-4ebf-8a45-f5a0b0514fea/` mit ursprünglichem
`checkpoint.json`, `passive-before-wss-restoration.json`,
`preserving-auto-restart.json` und abschließend geprüftem `completion.json`.
Die ergänzende Prüfung bestätigte sämtliche oben genannten Bindungen und
unveränderten Ausführungszähler. Der korrigierte vollständige Runner wurde
nicht als zweiter Faultlauf ausgeführt.
Diese passive Transportabnahme benötigt keine Jobgenehmigung. Sie darf keine
laufenden RMM-Wirkungen oder einen anderen VM-/Deploymenttest unterbrechen.
Der Fall ist kein TLS-Negativ-, Widerrufs-, Paket- oder Produktionsnachweis und
schließt die übrigen MVP-Gates nicht ab.