// travaux pratiques · Administration sécurité
TP04 - Déployer les clients poste de travail et smartphone
- TP 4 / 6
- 8 étapes
- ≈ 55 min
- Accès libre
Objectif : raccorder à la passerelle un poste Windows et un smartphone avec les clients officiels WireGuard, en ajoutant une clé pré-partagée et sans interrompre le poste nomade déjà connecté.
Contexte
Dans une PME, les utilisateurs du VPN ne sont pas des serveurs Linux : ce sont des portables Windows ou macOS et des smartphones. Chaque nouvel appareil doit être enrôlé proprement (une clé par appareil, une adresse de tunnel dédiée, une entrée dans l’inventaire) et la passerelle doit l’accepter sans couper les sessions déjà ouvertes. Pour les smartphones, le QR code évite de recopier une longue configuration à la main, mais il impose de générer la clé ailleurs que sur l’appareil : il faut alors traiter ce fichier comme un secret à usage unique.
À la fin de ce TP, vous saurez enrôler un poste dont la clé est générée par le client lui-même, produire un QR code de configuration pour un mobile, ajouter des clés pré-partagées et recharger la passerelle à chaud avec wg syncconf.
Prérequis : TP03 terminé ; une machine virtuelle Windows 10 ou 11 reliée à NET-WAN (adresse 10.10.20.60/24) ; facultativement un smartphone Android ou iOS capable de joindre NET-WAN (réseau virtuel ponté sur votre Wi-Fi de test).
Durée estimée : 55 minutes.
Actions à réaliser
Installer le client Windows. Sur la VM Windows, téléchargez le client depuis la page officielle
https://www.wireguard.com/install/et installez-le avec un compte administrateur. Le client crée une interface réseau virtuelle par tunnel actif.Résultat attendu : l’application WireGuard s’ouvre sur une liste de tunnels vide.
Laisser le client générer sa clé. Menu Add Tunnel puis Add empty tunnel… : le client génère lui-même la clé privée, l’insère dans la section
[Interface]et affiche la clé publique correspondante en haut de la fenêtre. Nommez le tunnelentrepriseet complétez :[Interface] PrivateKey = (générée par le client, ne pas modifier) Address = 10.8.0.4/32 [Peer] PublicKey = <contenu de vpn-gw.pub> PresharedKey = <clé pré-partagée de l'étape 3> Endpoint = 10.10.20.10:51820 AllowedIPs = 10.8.0.0/24, 172.16.10.0/24La clé privée ne quitte jamais le poste : seule la clé publique affichée est transmise à l’administrateur.
Créer la clé pré-partagée et déclarer le pair. Sur vpn-gw, en root dans
/etc/wireguard:umask 077 wg genpsk > win-claire.psk cat win-claire.pskAjoutez ensuite à
wg0.conf:[Peer] # win-claire - VM Windows du labo - enrôlé le JJ/MM/AAAA PublicKey = <clé publique affichée par le client Windows> PresharedKey = <contenu de win-claire.psk> AllowedIPs = 10.8.0.4/32La clé pré-partagée doit être identique des deux côtés ; recopiez-la dans le client Windows à la ligne
PresharedKey. Contrairement à la clé publique, c’est un secret : transmettez-la par un canal sûr (session d’administration à distance, gestionnaire de mots de passe partagé), jamais par messagerie.Recharger la passerelle sans coupure. Appliquez uniquement les différences :
wg syncconf wg0 <(wg-quick strip wg0) wg show wg0 peerswg-quick stripretire les options propres à wg-quick (Address, etc.) quewgne comprend pas ; la syntaxe<( )exige le shell bash. Résultat attendu : deux clés publiques listées, et la poignée de main du nomade Linux n’est pas réinitialisée (vérifiez avecwg showque sontransfercontinue d’augmenter).Activer et tester le tunnel Windows. Dans le client, enregistrez puis cliquez sur Activate. Dans un terminal PowerShell :
ping 10.8.0.1 ping 172.16.10.20Résultat attendu : le client affiche le statut Active, une date de Latest handshake et des compteurs de transfert ; les deux pings répondent. Si le pare-feu Windows bloque l’ICMP entrant, cela n’affecte pas ces tests sortants.
Préparer la configuration d’un smartphone. Pour un mobile, on génère la configuration sur la passerelle dans un répertoire temporaire, puis on la transmet par QR code :
apt install qrencode mkdir -m 700 /root/enrol && cd /root/enrol umask 077 wg genkey | tee tel.key | wg pubkey > tel.pub wg genpsk > tel.pskRédigez
tel.confsur le modèle du client Windows, avecAddress = 10.8.0.3/32, la clé privée detel.key, la clé pré-partagée etPersistentKeepalive = 25dans la section[Peer]: un téléphone passe en permanence derrière des NAT d’opérateurs, et la documentation officielle indique que 25 secondes conviennent à la plupart des pare-feu.Déclarer le téléphone et afficher le QR code. Ajoutez dans
wg0.confune section[Peer]avec la clé publique detel.pub, la même clé pré-partagée etAllowedIPs = 10.8.0.3/32, rechargez avecwg syncconf, puis :qrencode -t ansiutf8 < tel.confL’option
-t ansiutf8dessine le QR code dans le terminal. Dans l’application WireGuard du téléphone, choisissez l’ajout d’un tunnel par QR code et scannez-le. Résultat attendu : le tunnel apparaît dans l’application ; une fois activé,wg showsur la passerelle affiche une poignée de main pour la clé du téléphone.Détruire les secrets temporaires. La clé privée du téléphone n’a rien à faire sur la passerelle :
cd /root shred -u enrol/tel.key enrol/tel.conf enrol/tel.psk rm -r enrolshred -uécrase puis supprime chaque fichier. Résultat attendu : seulswg0.confet les fichiers de la passerelle restent dans/etc/wireguard.
Vérification
Le TP est réussi si wg show sur vpn-gw liste trois pairs (nomade, Windows, téléphone si vous en disposez), chacun avec une poignée de main récente et une ligne preshared key: (hidden) pour les deux nouveaux ; si le poste Windows joint 172.16.10.20 ; et si le nomade Linux n’a subi aucune coupure pendant les rechargements.
Problèmes fréquents
- Le client Windows reste sans poignée de main. Cause : clé pré-partagée différente des deux côtés, ou clé publique du poste mal recopiée sur la passerelle. Correction : comparer les valeurs ; une seule différence suffit à faire échouer silencieusement la poignée de main.
- « syntax error near unexpected token ‘(‘ » lors du rechargement. Cause : commande lancée dans un shell autre que bash (sh, ou via
sudosans shell). Correction : passer en root avecsudo -iou utilisersudo bash -c '…'. - Le téléphone se connecte puis se déconnecte au bout de quelques minutes d’inactivité. Cause : la traduction d’adresses de l’opérateur expire. Correction : vérifier la présence de
PersistentKeepalive = 25côté téléphone. - Deux pairs ne fonctionnent jamais en même temps. Cause : même adresse de tunnel attribuée à deux pairs ; WireGuard la retire au premier. Correction : une adresse /32 unique par appareil, tenue dans l’inventaire.
Bonnes pratiques et sécurité
- Privilégiez les clients qui génèrent eux-mêmes leur clé (« tunnel vide ») ; réservez la génération côté passerelle aux mobiles, avec destruction immédiate des fichiers.
- Utilisez une clé pré-partagée par appareil, jamais une clé commune à tous les pairs.
- Exigez le chiffrement du disque et le verrouillage de l’écran sur les appareils enrôlés : la configuration stockée suffit à se connecter.
- Mettez à jour l’inventaire à chaque enrôlement : propriétaire, appareil, adresse, date.
Questions de contrôle
1. Pourquoi l’option « Add empty tunnel » est-elle préférable à un fichier préparé par l’administrateur ?
Voir la réponse
Elle génère la clé privée sur le poste lui-même : la clé n’existe nulle part ailleurs et n’a jamais transité.
2. Que fait wg syncconf que ne ferait pas un redémarrage de wg-quick@wg0 ?
Voir la réponse
Il applique seulement les différences de configuration sans détruire l’interface, donc sans couper les sessions des pairs déjà connectés.
3. Pourquoi ajouter PersistentKeepalive côté téléphone et pas côté passerelle ?
Voir la réponse
C’est le téléphone qui se trouve derrière un NAT : c’est à lui d’entretenir la correspondance NAT pour rester joignable. La passerelle a une adresse fixe.
Pour aller plus loin
- Testez un tunnel complet sur le client Windows avec
AllowedIPs = 0.0.0.0/0, ::/0: il faudra alors autoriser le transit de wg0 vers Internet et ajouter une traduction d’adresses sur la passerelle. - Au-delà de quelques dizaines d’appareils, une surcouche de gestion des clés devient utile : voir notre article Headscale, l’alternative auto-hébergeable au serveur de contrôle Tailscale.
Laissez les pairs en place : le TP06 s’en servira pour les opérations de révocation.
// formation sur mesure
Former votre équipe sur ce sujet ?
Azur Secure anime des sessions intra-entreprise, à distance ou dans vos locaux sur la Côte d'Azur, adaptées au niveau de vos équipes.