Add reproducible LAN-only RDP access on Helium

This commit is contained in:
cabbage committed 2026-10-08 14:26:52 +00:00
1 parent 90d6b05f4d
commit 34274f0f62
9 files changed
+452 -1

No files matched your search

+1
View File
@@ -849,6 +849,7 @@ mirror; update both documents when the fixture is reprovisioned.
| Devices | Audio (`none`), playback/capture, clipboard/file transfer, drag-and-drop, and shared folders disabled; OHCI enabled for the standard USB tablet, EHCI/xHCI disabled, no USB passthrough filters, PS/2 keyboard unchanged; Windows mouse-class `UpperFilters = mouclass`, `VBoxMouse` detached/stopped, standard `mouclass`/`mouhid` drivers active; Intel 82540EM NIC, cable connected |
| Network | NAT; last observed guest IPv4 `10.0.2.15` is DHCP state only; NAT rule `rvbox-rdp` maps host `192.168.50.162:3390` to guest `:3389` |
| Diagnostic VRDE | Enabled only on Helium loopback at `127.0.0.1:3389`, external/`VBoxAuthSimple` authentication, input/display enabled, audio/USB/clipboard/RDPDR disabled; reach it only through an explicitly temporary, private SSH forward, and treat it as diagnostic-only because client compatibility is unreliable |
| Optional LAN RDP | `test/rdp-access/rdp-access lan-up` starts a small, digest-pinned Docker Compose relay on Helium's detected private LAN IP/subnet; current endpoint `192.168.50.162:3389`, limited to `192.168.50.0/24`. Backend remains loopback-only VRDE, Windows `TermService` and baseline unchanged. `lan-status`/`lan-down`/`lan-clean [--images]` manage only this profile. `up --lan` can enable web and LAN routes together; web cleanup does not implicitly stop LAN access. Disconnect Guacamole before an RDP app uses the single console slot. |
| Native Windows RDP | Disabled in baseline (`TermService` stopped, `fDenyTSConnections=1`); port 3390 must not be treated as a usable control endpoint |
| Test account | Local `rvboxtest`; split-token local administrator; console session 1 observed; Guest Control verified with `whoami`, `whoami /groups`, and `query user` |
| Baseline | Reset target `baseline-clean-python-usb-ready` (UUID `a4851b6a-24d6-42f8-96c2-ff9f554c9198`): no RVBox service, tray registration, state, logs, or staged binary; built-in `Administrator` is enabled only for the fixture's high-token Guest Control installation path; all-users Python 3.13.16 amd64, pip, venv and launcher installed at `C:\Python313` on machine PATH; pending Windows servicing restart completed; USB tablet and standard Windows mouse drivers, unnecessary `VBoxMouse` filter detached, with a small rollback record preserved. Retain the Python/servicing-ready parent `baseline-clean-python-ready` (UUID `dfadee95-156f-43ee-bdab-a10a44be4070`), initial Python snapshot `baseline-clean-python` (UUID `2d00a8a2-a7cf-4f7b-bee2-80bd71574e89`), pre-Python parent `baseline-clean-administrator` (UUID `ba5ce5f1-77e3-44b0-8d91-534becce27ff`), `baseline-clean` (UUID `5e79176a-3e56-4c5d-bb61-a405a6dcdd59`) and `baseline-disk-first` (UUID `9430a9a4-754a-4b22-beaa-8dfd90043f5b`) as diagnostics. |
+2 -1
View File
@@ -75,7 +75,8 @@ hard-coded into a harness.
| --- | --- |
| Host management | SSH to `helium-remote`, then invoke `VBoxManage`; do not assume `VBoxManage` is installed on the Linux controller |
| Guest management | VirtualBox Guest Control over the host; use explicit executable/argument vectors and the password file above |
| VRDE (VirtualBox RDP) | Enabled for diagnostics on Helium loopback at `127.0.0.1:3389`; external authentication, `VBoxAuthSimple` user `rvboxtest`, `Security/Method=RDP`, single connection only, multiconnection and connection reuse off. Reach it only through an explicitly temporary, private SSH forward. |
| VRDE (VirtualBox RDP) | Enabled for diagnostics on Helium loopback at `127.0.0.1:3389`; external authentication, `VBoxAuthSimple` user `rvboxtest`, `Security/Method=RDP`, single connection only, multiconnection and connection reuse off. Reach it through the private SSH/Guacamole path or the explicitly enabled LAN-only Docker relay. |
| Optional LAN RDP relay | `test/rdp-access/rdp-access lan-up` detects Helium's private IPv4/subnet and exposes the existing VRDE endpoint; currently `192.168.50.162:3389`, peers limited to `192.168.50.0/24`. `lan-status`, `lan-down`, and `lan-clean [--images]` manage only the independent relay; no Windows or baseline change. Disconnect Guacamole before using an RDP app. |
| VRDE TLS material | Auto-generated certificate and private key under `/home/cabbage/VirtualBox VMs/RVBox/Tests/rvbox-win10-test/`; keep both on Helium and do not copy them into the repository or test artifacts |
| VRDE channels | Input/display enabled; audio, upstream audio, USB, clipboard, and RDP device redirection disabled; no video channel |
| Native Windows RDP forward | NAT rule `rvbox-rdp`: host `192.168.50.162:3390` to guest port `3389` |
+8
View File
@@ -207,6 +207,14 @@ than treating it as a stable endpoint. VRDE is enabled only on Helium loopback
at `127.0.0.1:3389` for diagnostics, while native Windows RDP is disabled in
the baseline.
Direct LAN RDP access can be enabled with `test/rdp-access/rdp-access lan-up`:
the small Docker relay runs on Helium, binds its private LAN IP, restricts peers
to that subnet, and preserves the existing private VRDE backend and Windows
session. The independent `lan-status`/`lan-down`/`lan-clean` lifecycle is documented
in [the RDP helper](../test/rdp-access/README.md#direct-rdp-on-heliums-lan).
Disconnect the Guacamole desktop before switching to an RDP app; VRDE still
has one console slot and this does not enable Windows `TermService`.
Interactive browser access is a deliberately temporary recovery path only. See
[`test/rdp-access`](../test/rdp-access/README.md) for the Docker-only,
self-signed HTTPS Guacamole lifecycle; it must be started only after the native