Citrix SecurSpaces™

How it works

Citrix SecurSpaces™ is a cloud-native platform for hosting Cloud Development Environments (CDEs). It runs entirely on Kubernetes, either in your own cloud account or on your own hardware, and can run fully air-gapped. Development environments are containerized and Linux based, and nothing is installed on the developer’s device.

High-level architecture of SecurSpaces, showing a developer reaching the control plane and workspace pods through a load balancer, with the SecurSpaces proxy service handling HTTP(S), TCP/UDP, DNS, and SSH traffic to external services

The platform has three parts:

  • The control plane. A set of microservices and a configuration database. The control plane holds organizations, projects, policies, resources, and workspace state. It does not carry the developer’s code.
  • Workspaces. Each workspace is a Kubernetes pod running a container image, with its own CPU, memory, and disk allocation. Workspaces are created from templates, and are paused when idle and deleted according to your retention settings.
  • The SecurSpaces proxy service. All traffic leaving a workspace passes through it — HTTP and HTTPS, TCP and UDP, DNS, and SSH. This is where credentials are injected, network policy is applied, and traffic is recorded.

Because every path in and out of a workspace terminates in the SecurSpaces proxy service, the platform can give developers access to repositories, registries, and internal services without ever placing long-lived credentials on the developer’s device.

How developers connect

Developers reach a workspace in one of two ways:

  • In the browser. VS Code for the Web is served from the workspace over HTTPS. Nothing is installed locally, so any managed or unmanaged device can be used.
  • From a local IDE or terminal. VS Code Desktop, JetBrains Gateway, Cursor, Kiro, and Windsurf connect over SSH, as does a plain terminal.

The browser path is the one that supports the full set of data loss prevention controls, because the platform renders the session. See Connect over SSH, and Supported IDEs for versions and limitations.

Component overview

The following table describes the key architectural components and the technologies each one supports.

Detailed architecture showing SecurSpaces services and workspaces on Kubernetes or OpenShift, with integrations for authentication, source code, artifacts, and logs, and a MongoDB replica set

Component Description Supported Technologies
Platform Cloud-native, container-based environment (CDE) Kubernetes or Red Hat OpenShift. See Deployment guides.
Load Balancing Traffic management and ingress control NetScaler CPX (recommended, and deployed by the SecurSpaces chart), NGINX, HAProxy, or the Kubernetes Gateway API.
Database Metadata and workspace state storage MongoDB
Authentication Multi-factor and identity provider integration Google OAuth, Microsoft OAuth, SAML, SCIM, and OpenID Connect (OIDC).
Source Code Integrations with version control systems GitHub, GitLab, and Bitbucket (self-hosted and managed); Azure DevOps (managed).
Artifacts Container image management and credential storage Any OCI-compatible container registry (for example, JFrog Artifactory, Amazon ECR, or Google Artifact Registry); HashiCorp Vault for secrets and credentials.
Logs System and workspace telemetry System Analytics and the Event Log Catalog for audit trails. Supports SIEM integration using Common Event Format (CEF).

For infrastructure sizing and network requirements, see System requirements.

How a workspace starts

A single-region deployment resolves a workspace within one cluster. A multi-region deployment can place a workspace in a region close to the developer, or in a region required by data residency rules, while keeping one control plane and one entry point.

The following diagram shows a developer in the default region opening a workspace that lives in the US region.

Multi-region workspace resume flow. The developer's request enters the default region load balancer and is forwarded to the central service, which reads workspace and region information from MongoDB, sends an HTTP2 request to the US region to resume the workspace, and then redirects the developer to the US region cluster

The diagram numbers this sequence 1–4 and 6–10.

  1. The developer resumes and opens a workspace. The request arrives at the load balancer in the default region.
  2. The load balancer forwards the request to the central service.
  3. The central service requests the workspace record from MongoDB.
  4. MongoDB returns the workspace information, including the region the workspace belongs to.
  5. The central service sends an HTTP/2 request to the cluster in the US region.
  6. The workspace service in that region resumes the workspace pod.
  7. The region returns an HTTP/2 response.
  8. The default region reports success.
  9. The developer is redirected to the cluster in the workspace’s own region.

The developer’s browser then opens the workspace URL directly against that region, for example ws-123456.us.domain.com. The workspace service checks the developer’s credentials and, if they are valid, establishes a WebSocket connection between the workspace and the device. From that point the session runs against the regional cluster, and traffic in and out of the workspace passes through the SecurSpaces proxy service in that region.

Two supporting channels run continuously and are not part of the numbered sequence:

  • Coordination. The workspace service in each region maintains an MQTT client connection to the coordinator MQTT server in the default region, over WebSocket on port 1882. It appears on the diagram as the unnumbered WebSocket link. This is how the control plane reaches regions it does not own.
  • State. Regional clusters hold a TCP connection to MongoDB, so workspace state is recorded centrally regardless of which region runs the workspace.

Workspaces can also run in the default region. That is optional, and a deployment can keep the default region for the control plane alone.

Deployment guides

SecurSpaces can be deployed on any Kubernetes-compatible infrastructure, including public cloud, on-premises hardware, and hybrid environments. The following guides cover common deployment targets:

How it works