Accueil » Formations » Administration sécurité » VPN d’entreprise avec WireGuard » TP02 – Générer les clés et monter un premier tunnel

TP02 – Générer les clés et monter un premier tunnel

← VPN d’entreprise avec WireGuard

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

  1. Générer la paire de clés de la passerelle. Sur vpn-gw, en root, placez-vous dans /etc/wireguard et 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 -l

    umask 077 fait que les fichiers créés ne sont lisibles que par leur propriétaire ; wg genkey produit une clé privée aléatoire, tee l’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 =.

  2. 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.pub

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

  3. Échanger uniquement les clés publiques. Affichez chaque clé publique avec cat vpn-gw.pub et cat 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.

  4. É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/32

    La passerelle n’a pas d’Endpoint pour ce pair : elle apprendra son adresse à la première poignée de main. AllowedIPs = 10.8.0.2/32 signifie que ce pair ne peut émettre qu’avec cette seule adresse source. Résultat attendu : ls -l wg0.conf affiche des droits -rw------- grâce à l’umask.

  5. É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/24

    Le poste indique où joindre la passerelle (Endpoint) et accepte, via ce pair, tout le sous-réseau du tunnel. Aucun ListenPort n’est nécessaire côté client : un port aléatoire est choisi.

  6. Monter le tunnel. Sur les deux machines :

    wg-quick up wg0

    wg-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 avec wg 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 interface wg0 visible avec ip -br addr.

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

    Résultat attendu : le ping répond. Sur vpn-gw, wg show indique pour le pair un endpoint égal à 10.10.20.50 suivi d’un port aléatoire, une ligne latest handshake de quelques secondes et des compteurs transfer non nuls dans les deux sens.

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

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

  9. 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@wg0

    Résultat attendu : l’unité est active (exited), ce qui est normal pour un service qui configure l’interface puis se termine, et enabled pour 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-key sur 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 wg0 avant 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 077 avant 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/wireguard que 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.

Demander un programme
Défiler vers le haut