feat(vpn): add example for VPN Gateway and Connection management

Author: s-inter

examples/vpn/go.mod

@@ -0,0 +1,16 @@
+module github.com/stackitcloud/stackit-sdk-go/examples/vpn
+
+go 1.26
+
+// This is not needed in production. This is only here to point the golangci linter to the local version instead of the last release on GitHub.
+replace github.com/stackitcloud/stackit-sdk-go/services/vpn => ../../services/vpn
+
+require (
+	github.com/stackitcloud/stackit-sdk-go/core v0.26.0
+	github.com/stackitcloud/stackit-sdk-go/services/vpn v0.8.0
+)
+
+require (
+	github.com/golang-jwt/jwt/v5 v5.3.1 // indirect
+	github.com/google/uuid v1.6.0 // indirect
+)

examples/vpn/go.sum

@@ -0,0 +1,8 @@
+github.com/golang-jwt/jwt/v5 v5.3.1 h1:kYf81DTWFe7t+1VvL7eS+jKFVWaUnK9cB1qbwn63YCY=
+github.com/golang-jwt/jwt/v5 v5.3.1/go.mod h1:fxCRLWMO43lRc8nhHWY6LGqRcf+1gQWArsqaEUEa5bE=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
+github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/stackitcloud/stackit-sdk-go/core v0.26.0 h1:jQEb9gkehfp6VCP6TcYk7BI10cz4l0KM2L6hqYBH2QA=
+github.com/stackitcloud/stackit-sdk-go/core v0.26.0/go.mod h1:WU1hhxnjXw2EV7CYa1nlEvNpMiRY6CvmIOaHuL3pOaA=

examples/vpn/vpn.go

@@ -0,0 +1,98 @@
+package main
+
+import (
+	"context"
+	"fmt"
+	"os"
+
+	"github.com/stackitcloud/stackit-sdk-go/core/config"
+	vpn "github.com/stackitcloud/stackit-sdk-go/services/vpn/v1api"
+)
+
+func main() {
+	region := "eu01"          // Region where the resources will be created
+	projectId := "PROJECT_ID" // the uuid of your STACKIT project
+	planId := "PLAN_ID"       // the id of the plan you want to use for the VPN Gateway. You can get the available plans with `ListPlans`.
+
+	// STACKIT VPN enforces the following requirements for a secure PSK:
+	// - must be at least 20 characters long
+	// - must be at least 16 different characters
+	// - must have at least one upper case letter
+	// - must have at least one lower case letter
+	// - must have at least one number
+	psk := "Super.$ecret_Shared3Key12345"
+
+	// Create a new API client, that uses default authentication and configuration
+	vpnClient, err := vpn.NewAPIClient(
+		config.WithRegion(region),
+	)
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Creating API client: %v\n", err)
+		os.Exit(1)
+	}
+
+	// Create a VPN Gateway
+	createVpnGatewayPayload := vpn.CreateGatewayPayload{
+		DisplayName: "exampleVpnGateway",
+		PlanId:      planId,
+		RoutingType: vpn.ROUTINGTYPE_ROUTE_BASED,
+		AvailabilityZones: vpn.CreateGatewayPayloadAvailabilityZones{
+			Tunnel1: "eu01-1",
+			Tunnel2: "eu01-2",
+		},
+	}
+
+	gatewayResp, err := vpnClient.DefaultAPI.CreateGateway(context.Background(), projectId, vpn.Region(region)).CreateGatewayPayload(createVpnGatewayPayload).Execute()
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Error when calling `CreateVpnGateway`: %v\n", err)
+		os.Exit(1)
+	}
+	fmt.Printf("Created VPN Gateway with id \"%s\".\n", *gatewayResp.Id)
+
+	// Create a VPN Connection
+	phase1 := vpn.TunnelConfigurationPhase1{
+		DhGroups:             []string{"ecp384"},
+		EncryptionAlgorithms: []string{"aes256"},
+		IntegrityAlgorithms:  []string{"sha2_384"},
+	}
+	phase2 := vpn.TunnelConfigurationPhase2{
+		DhGroups:             []string{"ecp384"},
+		EncryptionAlgorithms: []string{"aes256"},
+		IntegrityAlgorithms:  []string{"sha2_384"},
+	}
+	tunnel := vpn.TunnelConfiguration{
+		Phase1:        phase1,
+		Phase2:        phase2,
+		PreSharedKey:  &psk,
+		RemoteAddress: "0.0.0.0",
+	}
+
+	createGatewayConnectionPayload := vpn.CreateGatewayConnectionPayload{
+		DisplayName: "exampleVpnConnection",
+		Tunnel1:     tunnel,
+		Tunnel2:     tunnel,
+	}
+	connectionResp, err := vpnClient.DefaultAPI.CreateGatewayConnection(context.Background(), projectId, vpn.Region(region), *gatewayResp.Id).CreateGatewayConnectionPayload(createGatewayConnectionPayload).Execute()
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Error when calling `CreateVpnConnection`: %v\n", err)
+		os.Exit(1)
+	}
+	fmt.Printf("Created VPN Connection with id \"%s\".\n", *connectionResp.Id)
+
+	// Delete the VPN Connection
+	err = vpnClient.DefaultAPI.DeleteGatewayConnection(context.Background(), projectId, vpn.Region(region), *gatewayResp.Id, *connectionResp.Id).Execute()
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Error when calling `DeleteVpnConnection`: %v\n", err)
+		os.Exit(1)
+	}
+	fmt.Printf("Deleted VPN Connection with id \"%s\".\n", *connectionResp.Id)
+
+	// Delete the VPN Gateway
+	err = vpnClient.DefaultAPI.DeleteGateway(context.Background(), projectId, vpn.Region(region), *gatewayResp.Id).Execute()
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Error when calling `DeleteVpnGateway`: %v\n", err)
+		os.Exit(1)
+	}
+	fmt.Printf("Deleted VPN Gateway with id \"%s\".\n", *gatewayResp.Id)
+
+}