Aller au contenu principal

Prérequis de la SDA Gateway

Systèmes d'exploitation ​

Linux ​

Le service SDA Glue pour Linux repose sur SoftEther VPN Client et utilise la pile IP native de Linux ainsi qu'iptables pour la gestion du pare-feu. Bien que le service puisse fonctionner sur d'autres distributions Linux, il n'a pas été testé de manière approfondie sur les systèmes basés sur nftables, tels que Red Hat Enterprise Linux. Pour une compatibilité et une prise en charge optimales, nous recommandons vivement de déployer la Gateway sur des distributions basées sur Debian.

Exigences système :

  • Architecture : ARM, ARM64, i386 ou AMD64
  • Processeur et mémoire : processeur double cœur de 1 GHz minimum et 512 Mo de RAM
  • Gestion des services : systemd
  • Version du noyau : 5.6+
  • Distribution : distributions basées sur Debian ou Ubuntu
  • Dépendances : SoftEther VPN Client (installé automatiquement lors de la configuration) ; OpenVPN (facultatif, installation manuelle requise)

Windows ​

L'implémentation Windows de SDA Glue utilise le client communautaire OpenVPN et dépend de la traduction d'adresses réseau Windows (WinNAT/NetNat) pour ses fonctionnalités réseau. Notez que WinNAT peut ne pas être activé par défaut sur toutes les versions de Windows et peut nécessiter une activation manuelle.

Exigences système :

  • Système d'exploitation : Windows 10 Professionnel/Entreprise ou Windows Server 2016 ou version ultérieure
  • Architecture : ARM, ARM64, i386 ou AMD64
  • Processeur et mémoire : processeur double cœur de 2 GHz minimum et 2 Go de RAM
  • Autorisations : le service nécessite des autorisations élevées pour gérer les ressources réseau
  • Dépendances : client communautaire OpenVPN (installé automatiquement lors de la configuration)
  • Fonctionnalités réseau : WinNAT/NetNat (voir les instructions de configuration ci-dessous)

Vérifier WinNAT

Pour vérifier si la fonctionnalité WinNAT est activée sur votre système :

  1. Ouvrez PowerShell en tant qu'administrateur
  2. Exécutez la commande suivante :
Get-NetNat

Résultats attendus :

  • Fonctionnalité activée : la commande s'exécute correctement (elle peut renvoyer un résultat vide si aucune configuration NAT n'existe)
  • Fonctionnalité désactivée : le message d'erreur « Get-NetNat : Invalid class » s'affiche

Activation de WinNAT

Si WinNAT n'est pas activé, procédez comme suit pour l'activer :

  1. Ouvrez PowerShell en tant qu'administrateur
  2. Exécutez les commandes suivantes :
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart
  1. Redémarrez l'ordinateur après une exécution réussie
  2. Vérifiez l'activation en exécutant de nouveau Get-NetNat

Docker et Kubernetes ​

SDA Glue peut être déployé dans des environnements conteneurisés, sous réserve d'exigences de configuration spécifiques permettant d'activer les fonctionnalités VPN. Le service nécessite l'accès au périphérique TUN de l'hôte ainsi que des capacités d'administration réseau pour établir des tunnels sécurisés.

Exigences système :

  • Architecture hôte : ARM64 ou AMD64
  • Accès au périphérique TUN : --device=/dev/net/tun — accès à l'interface de tunnel réseau virtuel
  • Capacités réseau : --cap-add=NET_ADMIN — configuration des interfaces réseau et gestion du routage

Périphérique TUN (/dev/net/tun) : l'interface TUN est un périphérique réseau virtuel qui fonctionne à la couche 3 (niveau IP) de la pile réseau et qui est couramment utilisé par les clients VPN pour établir des tunnels sécurisés. Les clients VPN utilisent les périphériques TUN pour chiffrer les données avant de les transmettre au serveur VPN via le tunnel. Sans accès à ce périphérique, la version conteneurisée de SDA Glue ne peut pas créer les tunnels réseau nécessaires à la connectivité.

Capacité NET_ADMIN : cette capacité Linux permet au conteneur d'effectuer des opérations liées au réseau, notamment la configuration des interfaces, la modification de la table de routage et la gestion du pare-feu. Les conteneurs VPN requièrent la capacité NET_ADMIN pour gérer les ressources réseau et établir un routage approprié en vue de communications sécurisées avec les services SDA Cloud.

 docker run -d \
   --name glue \
   --restart always \
   --device=/dev/net/tun \
   -p 8080:8080 \
   -v glue-data:/var/lib/sdaglue \
   --cap-add=NET_ADMIN \
   public.ecr.aws/t9c5s2d1/sdaglue:latest

Détails complets de déploiement, exemples de configuration et guide de dépannage.