constellation/dev-docs/howto/vpn
Markus Rudy 284c7e99d1
docs: add Helm chart for VPN connectivity (#2577)
Co-authored-by: 3u13r <lc@edgeless.systems>
2023-11-22 15:08:11 +01:00
..
files docs: add Helm chart for VPN connectivity (#2577) 2023-11-22 15:08:11 +01:00
templates docs: add Helm chart for VPN connectivity (#2577) 2023-11-22 15:08:11 +01:00
.helmignore docs: add Helm chart for VPN connectivity (#2577) 2023-11-22 15:08:11 +01:00
Chart.yaml docs: add Helm chart for VPN connectivity (#2577) 2023-11-22 15:08:11 +01:00
README.md docs: add Helm chart for VPN connectivity (#2577) 2023-11-22 15:08:11 +01:00
values.yaml docs: add Helm chart for VPN connectivity (#2577) 2023-11-22 15:08:11 +01:00

Constellation VPN

This Helm chart deploys a VPN server to your Constellation cluster.

Installation

  1. Create and populate the configuration.

    helm inspect values . >config.yaml
    
  2. Install the Helm chart.

    helm install -f config.yaml vpn . 
    
  3. Follow the post-installation instructions displayed by the CLI.

Architecture

The VPN server is deployed as a StatefulSet to the cluster. It hosts the VPN frontend component, which is responsible for relaying traffic between the pod and the on-prem network, and the routing components that provide access to Constellation resources. The frontend supports IPSec and Wireguard.

The VPN frontend is exposed with a public LoadBalancer to be accessible from the on-prem network. Traffic that reaches the VPN server pod is split into two categories: pod IPs and service IPs.

The pod IP range is NATed with an iptables rule. On-prem worklaods can establish connections to a pod IP, but the Constellation workloads will see the client IP translated to that of the VPN frontend pod.

The service IP range is handed to a transparent proxy running in the VPN frontend pod, which relays the connection to a backend pod. This is necessary because of the load-balancing mechanism of Cilium, which assumes service IP traffic to originate from the Constellation cluster itself. As for pod IP ranges, Constellation pods will only see the translated client address.

Limitations

  • Service IPs need to be proxied by the VPN frontend pod. This is a single point of failure, and it may become a bottleneck.
  • IPs are NATed, so the Constellation pods won't see the real on-prem IPs.
  • NetworkPolicy can't be applied selectively to the on-prem ranges.
  • No connectivity from Constellation to on-prem workloads.