Accueil » Formations » Administration sécurité » VPN d’entreprise avec WireGuard » TP04 – Déployer les clients poste de travail et smartphone

TP04 – Déployer les clients poste de travail et smartphone

← VPN d’entreprise avec WireGuard

// 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

  1. 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.

  2. 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 tunnel entreprise et 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/24

    La clé privée ne quitte jamais le poste : seule la clé publique affichée est transmise à l’administrateur.

  3. 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.psk

    Ajoutez 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/32

    La 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.

  4. Recharger la passerelle sans coupure. Appliquez uniquement les différences :

    wg syncconf wg0 <(wg-quick strip wg0)
    wg show wg0 peers

    wg-quick strip retire les options propres à wg-quick (Address, etc.) que wg ne 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 avec wg show que son transfer continue d’augmenter).

  5. 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.20

    Ré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.

  6. 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.psk

    Rédigez tel.conf sur le modèle du client Windows, avec Address = 10.8.0.3/32, la clé privée de tel.key, la clé pré-partagée et PersistentKeepalive = 25 dans 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.

  7. Déclarer le téléphone et afficher le QR code. Ajoutez dans wg0.conf une section [Peer] avec la clé publique de tel.pub, la même clé pré-partagée et AllowedIPs = 10.8.0.3/32, rechargez avec wg syncconf, puis :

    qrencode -t ansiutf8 < tel.conf

    L’option -t ansiutf8 dessine 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 show sur la passerelle affiche une poignée de main pour la clé du téléphone.

  8. 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 enrol

    shred -u écrase puis supprime chaque fichier. Résultat attendu : seuls wg0.conf et 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 sudo sans shell). Correction : passer en root avec sudo -i ou utiliser sudo 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 = 25 cô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.

Demander un programme
Défiler vers le haut