// travaux pratiques · Administration sécurité
TP02 - Générer les clés et monter un premier tunnel
- TP 2 / 6
- 9 étapes
- ≈ 45 min
- Accès libre
Objectif : générer les paires de clés de la passerelle et du poste nomade, écrire les deux fichiers de configuration et établir un premier tunnel chiffré, puis observer concrètement le routage par clé.
Contexte
Dans un VPN WireGuard, l’identité de chaque appareil se résume à une paire de clés. La façon dont on les génère, les stocke et les échange conditionne toute la sécurité du dispositif : une clé privée copiée par mail ou laissée lisible par tous équivaut à un badge d’accès abandonné dans un couloir. En entreprise, c’est aussi l’étape que l’on répétera à chaque arrivée d’un salarié ou d’un nouvel appareil.
À la fin de ce TP, vous saurez produire des clés avec les bons droits, rédiger une configuration minimale côté passerelle et côté client, monter et démonter un tunnel avec wg-quick, et lire la sortie de wg show pour savoir si un tunnel fonctionne.
Prérequis : TP01 terminé ; machines vpn-gw et nomade démarrées, avec wireguard-tools installé.
Durée estimée : 45 minutes.
Actions à réaliser
Générer la paire de clés de la passerelle. Sur vpn-gw, en root, placez-vous dans
/etc/wireguardet restreignez les droits des fichiers créés avant de générer quoi que ce soit :sudo -i cd /etc/wireguard umask 077 wg genkey | tee vpn-gw.key | wg pubkey > vpn-gw.pub ls -lumask 077fait que les fichiers créés ne sont lisibles que par leur propriétaire ;wg genkeyproduit une clé privée aléatoire,teel’enregistre tout en la passant àwg pubkey, qui en calcule la clé publique. Résultat attendu : deux fichiers en-rw-------, chacun contenant une chaîne de 44 caractères en base64 terminée par=.Générer la paire de clés du poste nomade. Même opération sur nomade, avec ses propres noms de fichiers :
sudo -i cd /etc/wireguard umask 077 wg genkey | tee nomade.key | wg pubkey > nomade.pubLa clé privée du poste est créée sur le poste et n’en sortira jamais : c’est le principe à respecter pour tous les appareils.
Échanger uniquement les clés publiques. Affichez chaque clé publique avec
cat vpn-gw.pubetcat nomade.pub, puis recopiez-la sur l’autre machine (copier-coller dans la session SSH). Une clé publique n’est pas un secret, mais vérifiez qu’elle est recopiée sans espace ni caractère manquant.Écrire la configuration de la passerelle. Sur vpn-gw, créez
/etc/wireguard/wg0.conf:[Interface] Address = 10.8.0.1/24 ListenPort = 51820 PrivateKey = <contenu de vpn-gw.key> [Peer] # nomade - poste de test du labo PublicKey = <contenu de nomade.pub> AllowedIPs = 10.8.0.2/32La passerelle n’a pas d’
Endpointpour ce pair : elle apprendra son adresse à la première poignée de main.AllowedIPs = 10.8.0.2/32signifie que ce pair ne peut émettre qu’avec cette seule adresse source. Résultat attendu :ls -l wg0.confaffiche des droits-rw-------grâce à l’umask.Écrire la configuration du poste. Sur nomade, créez à son tour
/etc/wireguard/wg0.conf:[Interface] Address = 10.8.0.2/24 PrivateKey = <contenu de nomade.key> [Peer] # passerelle de l'entreprise PublicKey = <contenu de vpn-gw.pub> Endpoint = 10.10.20.10:51820 AllowedIPs = 10.8.0.0/24Le poste indique où joindre la passerelle (
Endpoint) et accepte, via ce pair, tout le sous-réseau du tunnel. AucunListenPortn’est nécessaire côté client : un port aléatoire est choisi.Monter le tunnel. Sur les deux machines :
wg-quick up wg0wg-quick affiche chaque commande qu’il exécute, précédée de
[#]: création de l’interface de type wireguard, application de la configuration avecwg setconf, ajout de l’adresse, réglage de la MTU (1420 sur un lien Ethernet standard) et activation de l’interface. Résultat attendu : aucune erreur et une interfacewg0visible avecip -br addr.Tester et lire l’état du tunnel. Depuis nomade, pinguez la passerelle à travers le tunnel, puis affichez l’état :
ping -c 3 10.8.0.1 wg showRésultat attendu : le ping répond. Sur vpn-gw,
wg showindique pour le pair unendpointégal à 10.10.20.50 suivi d’un port aléatoire, une lignelatest handshakede quelques secondes et des compteurstransfernon nuls dans les deux sens.Observer le filtrage par AllowedIPs. Sur nomade, ajoutez temporairement une seconde adresse au tunnel et tentez de l’utiliser comme source :
ip addr add 10.8.0.99/24 dev wg0 ping -c 3 -I 10.8.0.99 10.8.0.1 ip addr del 10.8.0.99/24 dev wg0Résultat attendu : 100 % de perte. Les paquets arrivent bien chiffrés avec la bonne clé, mais la passerelle les rejette car 10.8.0.99 ne figure pas dans les AllowedIPs du pair : c’est la protection contre l’usurpation d’adresse.
Rendre le tunnel permanent. Démontez l’interface lancée à la main puis confiez-la à systemd, sur les deux machines :
wg-quick down wg0 systemctl enable --now wg-quick@wg0 systemctl status wg-quick@wg0Résultat attendu : l’unité est
active (exited), ce qui est normal pour un service qui configure l’interface puis se termine, etenabledpour le démarrage automatique.
Vérification
Le TP est réussi si : ping 10.8.0.1 fonctionne depuis nomade et ping 10.8.0.2 depuis vpn-gw ; wg show affiche une poignée de main récente des deux côtés ; le tunnel revient seul après un redémarrage des deux machines ; les fichiers de /etc/wireguard sont tous en mode 600.
Problèmes fréquents
- Pas de ligne « latest handshake » côté passerelle. Cause : clé publique mal recopiée (caractère manquant, clé privée collée à la place de la publique). Correction : comparer avec
wg show wg0 public-keysur la machine d’origine. - « Line unrecognized » ou « Configuration parsing error » au démarrage. Cause : faute de frappe dans un nom d’option ou section mal écrite. Correction : relire le fichier, les options sont sensibles à l’orthographe exacte (
AllowedIPs,PublicKey). - Le ping échoue alors que la poignée de main a lieu. Cause : AllowedIPs trop étroites d’un côté, par exemple l’adresse de la passerelle absente des AllowedIPs du poste. Correction : vérifier que chaque adresse jointe figure dans les AllowedIPs du pair concerné.
- « RTNETLINK answers: File exists ». Cause : l’interface wg0 existe déjà (montée à la main puis via systemd). Correction :
wg-quick down wg0avant de relancer.
Bonnes pratiques et sécurité
- Générez chaque clé privée sur l’appareil qui l’utilisera ; seule la clé publique est transmise.
- Utilisez toujours
umask 077avant de générer des clés ou d’écrire un fichier de configuration. - Annotez chaque section
[Peer]d’un commentaire (propriétaire, appareil, date) : WireGuard n’identifie les pairs que par leur clé. - Ne sauvegardez
/etc/wireguardque sur un support chiffré : ces fichiers contiennent des secrets.
Questions de contrôle
1. Pourquoi la passerelle n’a-t-elle pas d’Endpoint pour le pair nomade ?
Voir la réponse
L’adresse publique du poste est inconnue et change selon le réseau utilisé. La passerelle l’apprend à chaque paquet authentifié reçu, ce qui permet l’itinérance.
2. Que prouve l’échec du ping avec la source 10.8.0.99 ?
Voir la réponse
Que la passerelle filtre en réception selon les AllowedIPs : un pair authentifié ne peut pas utiliser une adresse source qui ne lui a pas été attribuée.
3. Quelle information de wg show indique qu’un tunnel est réellement établi ?
Voir la réponse
Une ligne latest handshake récente (moins de deux à trois minutes en présence de trafic), accompagnée de compteurs transfer qui augmentent.
Pour aller plus loin
- Relisez la présentation du protocole dans notre article WireGuard : le VPN moderne, simple et rapide pour faire le lien entre la poignée de main observée ici et sa conception.
- Essayez
wg showconf wg0: la configuration active est restituée au format fichier, pratique pour comparer avec ce que vous avez écrit.
Laissez le tunnel actif : le TP03 l’étend au réseau interne.
// 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.