IW RustDesk UCS – corresponding source / Version 2, 17.11.2026

Lizenzen
Der enthaltene RustDesk-Server einschließlich der Änderungen in src/iw_auth.rs,
rendezvous_server.rs und relay_server.rs steht unter der ursprünglichen
GNU AGPL v3 (rustdesk-server-1.1.16/LICENSE). Die eigenen Rust-Erweiterungen
unter ucs-bridge/transport/*.rs werden ebenfalls unter AGPL-3.0 bereitgestellt.
Die eigenständige Python-UCS-Bridge, Vorlagen, Styles und Patchwerkzeuge stehen
unter MIT (ucs-bridge/LICENSE). Upstream-Abhängigkeiten behalten ihre Lizenzen.
Es wird kein RustDesk-Server-Pro-Code eingesetzt.

Herkunft und Build
RustDesk OSS 1.1.16, Commit 73523b31cfd25d77dee862e6fc9f5e1fb5e485ef.
hbb_common: 83419b6549636ee39dacef7776c473f5802e08d6.
Das Archiv enthält den tatsächlich gebauten, bereits angepassten Quellbaum,
das vollständige hbb_common-Untermodul, Cargo.lock und Buildskripte.
BUILD-MANIFEST.json nennt die Quellhashes, Binärhashes und Protokollprüfungen.

Build im offiziellen Docker-Image:
rust@sha256:ade39a710ef85f3506cffcfec3e8a24ba090badef1dff2fb798f71d878833fea
Arbeitsverzeichnis: rustdesk-server-1.1.16
Umgebung: CARGO_BUILD_JOBS=2, CARGO_INCREMENTAL=0,
CARGO_PROFILE_RELEASE_LTO=false, CARGO_PROFILE_RELEASE_CODEGEN_UNITS=8
Kommandos:
  cargo test --locked --release --lib --bins
  cargo build --locked --release --bin hbbs --bin hbbr
Ausgaben: target/release/hbbs und target/release/hbbr.
Der Build benötigt Zugriff auf die in Cargo.lock festgelegten Rust-Abhängigkeiten.
Die ursprüngliche Version bleibt 1.1.16; dies ist der eigene Patchstand
ucs-required-v2, kein offizielles unverändertes Upstream-Binärpaket.

ucs-bridge/transport/patch_server.py dokumentiert den Patch gegen den exakten
offiziellen Ursprung und verweigert unerwartete Quellanker. Nicht erneut auf
den bereits angepassten Baum anwenden. Die vollständige Quelle im Archiv ist
für diesen Build maßgeblich; Formatierung und generierte Versionsdateien können
gegenüber einem neu angewendeten Patch abweichen.

Bridge
Python 3.11, Abhängigkeiten aus ucs-bridge/requirements.txt.
  python3 -m venv venv
  venv/bin/pip install -r ucs-bridge/requirements.txt
Konfiguration über EnvironmentFile in der mitgelieferten systemd-Unit.
Erforderlich: IW_RD_BASE_URL, IW_RD_ISSUER, IW_RD_CLIENT_ID,
IW_RD_SECRET_FILE, IW_RD_CA_FILE, IW_RD_ID_SERVER, IW_RD_PUBLIC_KEY_FILE,
IW_RD_DATABASE, IW_RD_ADMINS_FILE, IW_RD_AUTH_SOCKET, IW_RD_SOURCE_ARCHIVE.
admins.json ist eine explizite Liste von {"issuer":"…","sub":"…"} für
freigegebene Administratoridentitäten. Es gibt keinen Erstbenutzer-Admin.
Secrets, Benutzer-/Gerätedaten, Datenbanken und private Serverschlüssel sind
absichtlich kein Bestandteil des öffentlichen Quellarchivs. Eigene Identität,
Zertifikate, Dienstkonten, Datenpfade und Hostnamen separat konfigurieren.

Transportänderungen
Verschlüsselter nativer Account-Handshake vor authentifizierten Verbindungs-
anforderungen; UCS-Tokenprüfung über den geschützten Unix-Socket der Bridge.
Nur Relay, keine P2P-/LAN-Adressen; Einmalfreigaben für beide Relay-Rollen.
Laufende Relays werden alle zehn Sekunden erneut gegen UCS-Sitzung, Geräte-
schlüssel, Eigentum und Freigaben geprüft. Fehler verweigern den Zugriff.
Alte unauthentifizierte lokale Steuerkommandos und WebSocket-Wege sind gesperrt.
Der Server erzwingt Anmeldung für Verbindungen über diesen Dienst. Unabhängiger
Direkt-IP-Zugriff am Endgerät benötigt zusätzlich die dortigen Einstellungen
bzw. eine Betriebssystemrichtlinie; der Server kann fremde Wege nicht sperren.

Keines der historischen Installations-/Aktivierungsskripte ist eine allgemeine
Neuinstallation oder ein sicherer Rückweg von Version 2 zu Version 1. Vor einem
eigenen Deployment die Units, Pfade, CA und OIDC-Anbindung konkret anpassen.

Gastfreigaben, 17.11.2026
Ergänzung der eigenständigen Bridge: Ohne UCS-Konto Hilfe erhalten oder als Gast
helfen, nur nach frischer UCS-Administratorfreigabe und eigener Gastbestätigung.
Einmaliger zufälliger Code, nur gehasht gespeichert; feste zwei Geräte mit
Schlüssel-/UUID-/Adressbindung, 5/15/30 Minuten, genau eine Relay-Kennung.
Gast-Programmsitzungen sind ein separater RAM-Typ und erhalten keine Benutzer-
oder Adressbuchidentität. Native aktuelle-Benutzer-/Heartbeat-/Logout-Anfragen
sind auf die eigene Gastfreigabe beschränkt; private Verwaltungs-/Adressbuch-APIs
bleiben gesperrt. Empfangender Gast kann keine Verbindung starten. Gäste nutzen
den vorhandenen nativen Drittanmeldedialog „Gast“ mit browsergebundener Code-
prüfung und ausdrücklicher Bestätigung. Widerruf, Ablauf, Schlüsseländerung und
Policy-Neustart sperren die Freigabe; laufende Relays werden weiterhin geprüft.
39 synthetische Backend-Tests und isolierte echte hbbs/hbbr-Relaytests für beide
Gast-Richtungen mit Widerruf/Ablauf bestanden. Kein tatsächlicher Desktop wurde
für die Abnahme verwendet. Die native Transportbinärdatei ist dabei unverändert.

Intranet-Fernhilfe, 18.11.2026
Die eigenständige Bridge enthält server/portal.py: UCS-Code/PKCE-Anmeldung über
den unveränderten Callback, origin- und S256-gebundener Einmalcode, höchstens
60 Sekunden zur Übergabe. Ausschließlich zwei feste Intranet-Ursprünge; keine
Cookies/Credentials für CORS. Ein separater kurzlebiger RAM-Sitzungstyp erlaubt
nur die Portal-APIs und keinen nativen Transport. Die aktuelle UCS-Aktivität
und bestehende Registry-Rechte werden bei jedem Portalabruf erneut geprüft.
Ablauf bleibt an die ursprüngliche Anmeldung gebunden. Keine Refresh-Tokens,
Browser-Persistenz oder automatische Hintergrundabgleiche. Bestehende Revisionen,
Geräteschlüssel und ausdrückliche Freigaben gelten auch aus dem Intranet.
Die Oberfläche verwendet das vorhandene IW-Logo und die Portal-Farben; sämtliche
Gast-/Bestätigungsseiten teilen dieselbe responsive Hell-/Dunkel-Grundgestaltung.
Native Binaries, Transportprotokoll, Units und Firewall bleiben unverändert.
51 synthetische Backendprüfungen einschließlich der bestehenden UCS-/Gastregeln
bestanden; die Endgerät-Fernsteuerung wurde dafür nicht auf echten PCs bedient.
