CTF-009: Range Integration¶
Statement¶
The system shall provide each CTF participant with an isolated, browser-accessible cyber range environment whose lifecycle is tied to the event, differentiating Shifter from standalone CTF platforms.
Rationale¶
Range integration is what differentiates Shifter CTF from standalone CTFd. CTFd has no concept of lab infrastructure, Shifter provides each participant their own attack/victim environment. This is the core value proposition: turnkey, self-service cyber ranges tied to CTF challenges. Without this integration, participants would need to provision their own labs, defeating the purpose of the platform.
Traceability¶
- IMPLEMENTS → CODE_FILE
shifter/shifter_platform/ctf/bridges.py(Guacamole bridge providing browser-accessible RDP/SSH access to participant ranges) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/ctf/models/(CTFEvent and CTFParticipant models with range_status, lifecycle status, and event-bound range fields) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/ctf/services/event/(Event lifecycle management: scheduling, task creation, teardown tied to event lifecycle) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/ctf/management/commands/run_ctf_scheduler.py(Scheduled task executor that polls and dispatches deploy/teardown tasks tying range lifecycle to events) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/ctf/signals.py(Signal handler syncing CMS RangeInstance status changes to CTFParticipant.range_status) - TESTS → TEST
shifter/shifter_platform/tests/ctf/test_services/test_range.py(Unit tests for range provisioning service) - TESTS → TEST
shifter/shifter_platform/tests/ctf/test_models.py(Tests for CTF models including range status and lifecycle fields) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/ctf/services/range/provision.py(Per-participant range provisioning (provision_participant_range + retry)) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/ctf/services/range/batch.py(Event-level throttled range provisioning (provision_event_ranges_throttled)) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/ctf/services/_event_range_lease.py(CTF event-to-range lease reconciliation) - IMPLEMENTS → CODE_FILE
shifter/shifter_platform/cms/services/_range_lease.py(Server-owned range lease and expiry lifecycle) - TESTS → TEST
shifter/shifter_platform/tests/ctf/test_mid_event_operations.py(CTF live-event lease rescheduling tests) - TESTS → TEST
shifter/shifter_platform/tests/ctf/test_range_expiry_projection.py(CTF range expiry projection tests)