Skip to content

Implement StableStation isolated remote assistance - #1

Draft
hurrisonma wants to merge 29 commits into
mainfrom
codex/remote-assistance-foundation
Draft

hurrisonma wants to merge 29 commits into
mainfrom
codex/remote-assistance-foundation

Conversation

@hurrisonma

@hurrisonma hurrisonma commented Jul 30, 2026 •

Copy link
Copy Markdown
Owner

What changed

  • add durable, expiring StableStation assistance authorizations with endpoint/device/Connector generation fencing
  • mint one-time RemoteDesktop-only Viewer tokens and enforce default-deny HTTP/ViewerHub capability boundaries
  • restrict the StableStation bootstrap service account to its minimal device/assistance API allowlist
  • abort the active Viewer on revoke, expiry, replacement, or disconnect and allow only one Viewer per authorization
  • add the Agent loopback HMAC gate with nonce replay protection, a 45-second maximum lease, generation matching, and DesktopClient termination
  • add focused Agent and Server tests plus the generated V1 OpenAPI contract
  • publish one immutable linux/amd64 Server image with SBOM/provenance and embed the matching Windows x64 Agent/DesktopClient/Installer downloads
  • normalize an upstream release-note filename that prevented Windows checkouts

Security boundary

StableStation sessions can use browser remote desktop only. Terminal, files, scripts, logs, VNC, device/tenant management, service-account operations, and future unmapped ViewerHub methods remain denied. The Agent starts with its local gate closed and does not fall back to upstream unattended remote control when StableStation gate configuration is absent.

Published internal-validation artifacts

  • source commit: 56cda4c789b4e674c168ec6045bf0fab1486d1ce
  • image: ghcr.io/hurrisonma/controlr-server:sha-56cda4c789b4e674c168ec6045bf0fab1486d1ce
  • digest: sha256:bce1af16af12c15bcf80485f9b634baed500baa0d7a520f18a1aa234f204fc5e
  • Windows artifact: stablestation-controlr-win-x64-56cda4c789b4e674c168ec6045bf0fab1486d1ce
  • workflow: https://github.com/hurrisonma/ControlR/actions/runs/30532234724

The Windows binaries are unsigned and are for controlled internal validation only. Production rollout requires an approved StableStation code-signing identity.

Validation

  • Agent gate/preflight tests: 8 passed
  • focused Server authorization/capability tests: 40 passed
  • EF migrations pending-model check: no pending model changes
  • Agent, Server, and DesktopClient test projects: build succeeded with 0 warnings
  • Windows x64 DesktopClient, Agent, and Installer: real GitHub Actions publish succeeded
  • Windows installer and Agent bundle: SHA-256 and ZIP CRC verification succeeded
  • immutable Server image publish: succeeded with SBOM and max provenance
  • git diff --check: passed

Two existing DesktopClient tests that require an X11 display cannot run on this headless Linux host; their project compiles successfully, and the Windows x64 publish completed on the Windows runner.

@hurrisonma hurrisonma changed the title Add remote desktop session capability Implement StableStation isolated remote assistance Jul 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant