CTF-903: Browser-Based Range Access¶
Statement¶
CTF participants shall access their range VMs via the existing Mission Control terminal page, which provides browser-based RDP and SSH access through Guacamole. No CTF-specific browser access implementation is needed. Browser-based remote access connections are automatically configured when ranges are provisioned via CMS, mapping each participant to their specific VM instances. The CTF layer shall not duplicate Guacamole URL generation or connection info assembly.
Rationale¶
Browser-based access is non-negotiable for Shifter's target users, PANW consultants cannot install VPN clients, RDP tools, or SSH clients on their corporate laptops. Guacamole provides zero-install access to VMs via the browser. This already exists in Mission Control and must extend to CTF events so participants can seamlessly access their attack boxes.
Traceability¶
- IMPLEMENTS → CODE_FILE
shifter/shifter_platform/ctf/models/(CTF Models - CTFParticipant range fields) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/mission_control/guacamole.py(Guacamole integration - RDP and SSH URL generation) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/mission_control/api/guacamole.py(Guacamole RDP/SSH URL and bootstrap status endpoints - browser-based range access) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/engine/services/(engine get_rdp_connection_info - connection info for Guacamole) - TESTS → TEST
shifter/shifter_platform/tests/mission_control/test_guacamole_ssh.py(Guacamole SSH/RDP URL generation tests) - IMPLEMENTS → GITHUB_ISSUE
Brad-Edwards/bigrae#543(CTF-903: Browser-Based Range Access) - DOCUMENTS → GITHUB_ISSUE
Brad-Edwards/bigrae#848(Guacamole URL bootstrap blocks portal requests on synchronous token API call) - IMPLEMENTS → PULL_REQUEST
Brad-Edwards/bigrae#854(Fix Guacamole bootstrap request blocking) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/mission_control/guacamole_bootstrap.py(Async Guacamole bootstrap runner) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/mission_control/views/_guacamole_bootstrap.py(Guacamole bootstrap helpers used by the API views) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/mission_control/models.py(GuacamoleBootstrapRequest pollable state model) - TESTS → TEST
shifter/shifter_platform/tests/mission_control/test_views_guacamole.py(Guacamole bootstrap view tests) - TESTS → TEST
shifter/shifter_platform/tests/mission_control/test_api_instance_ssh_url.py(Range instance Guacamole bootstrap API tests) - TESTS → TEST
shifter/shifter_platform/tests/mission_control/test_api_ngfw_ssh_url.py(NGFW Guacamole bootstrap API tests) - TESTS → TEST
shifter/shifter_platform/tests/mission_control/test_guacamole_readiness.py(Guacamole token-exchange readiness retry tests (issue #395)) - TESTS → TEST
shifter/shifter_platform/tests/mission_control/test_guacamole_ssh.py(Guacamole SSH URL generation unit tests) - DOCUMENTS → DOCUMENTATION
docs/architecture/guacamole-first-click-rdp-preflight-395.md(First-click Guacamole RDP preflight design note (issue #395)) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/mission_control/guacamole_session.py(Guacamole remote-access session service (browser-based range access orchestration)) - TESTS → TEST
shifter/shifter_platform/tests/mission_control/test_guacamole_session.py(Behavior tests for the Guacamole remote-access session service)