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

3.2 KiB

Tatsächlicher automatischer WSS-/HTTPS-Fallback

Stand 2026-11-13. Implementiert und lokal geprüft, noch nicht auf Cloud ausgeführt oder abgenommen. Ein ausdrücklich gewählter HTTPS-Modus und ein WSS-Reconnect 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 ist vorbereitet, nicht ausgeführt:

  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 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.

Diese passive Transportabnahme benötigt keine Jobgenehmigung. Sie darf keine laufenden RMM-Wirkungen oder einen anderen VM-/Deploymenttest unterbrechen. Fehlende Nativebelege bleiben offen; erst tatsächliche Ergebnisse hier ergänzen.