WireGuard : une poignée de main, des clés publiques et presque rien d’autre
WireGuard a choisi de faire moins que ses aînés : pas de négociation, pas de certificats, pas de mode TCP. C’est précisément ce qui en fait le meilleur protocole à étudier.
Pour qui veut construire son propre VPN, WireGuard est un cas d’école. Conçu par Jason A. Donenfeld, présenté en 2017 au symposium NDSS, intégré au noyau Linux dans sa version 5.6 en 2020, il tenait à l’origine en environ 4 000 lignes de code. À titre de comparaison, une pile IPsec complète ou OpenVPN, avec les bibliothèques dont ils dépendent, se comptent en centaines de milliers. Moins de code, c’est moins d’endroits où se cachent des failles, et un protocole qu’une seule personne peut lire en entier.
Une cryptographie fixe, sans négociation
WireGuard ne négocie rien. Il utilise toujours Curve25519 pour l’échange de clés, ChaCha20-Poly1305 pour le chiffrement authentifié, BLAKE2s pour le hachage, HKDF pour la dérivation et SipHash pour ses tables internes. Si l’une de ces briques venait à être cassée, il faudrait publier une nouvelle version du protocole et mettre à jour tous les pairs.
Ce choix supprime d’un coup toute une famille d’attaques : celles qui forcent deux pairs à se replier sur l’algorithme le plus faible qu’ils acceptent. Il supprime aussi des milliers de lignes de code de négociation, et les erreurs qui vont avec. Le revers, c’est la rigidité : on ne peut pas imposer un algorithme certifié par une administration, ce qui écarte WireGuard de certains marchés publics.
Le routage par clé
Chaque pair WireGuard est défini par une clé publique et une liste d’adresses autorisées. Cette table sert dans les deux sens, et c’est l’idée centrale du protocole :
- en sortie, l’adresse de destination d’un paquet désigne le pair, donc la clé avec laquelle chiffrer ;
- en entrée, un paquet déchiffré avec la clé d’un pair n’est accepté que si son adresse source figure dans la liste de ce pair.
[Peer]
PublicKey = <clé publique du client>
AllowedIPs = 10.66.0.2/32
Il n’y a pas de notion de connexion ni d’utilisateur : une clé publique est une identité, et une identité a des adresses. Le contrôle d’usurpation entre clients, qu’il faut ajouter à la main dans d’autres protocoles, est ici automatique.
La poignée de main Noise_IKpsk2
La poignée de main suit un modèle du cadre Noise, nommé IKpsk2. L’initiateur connaît d’avance la clé publique statique du répondeur, ce qui permet de tout faire en un seul aller-retour. Le premier message contient une clé éphémère, l’identité de l’initiateur chiffrée et un horodatage chiffré ; le répondeur rejette tout horodatage qui n’est pas plus récent que le précédent, ce qui empêche de rejouer une ancienne initiation. La réponse apporte la clé éphémère du répondeur. Les deux pairs combinent alors plusieurs échanges Diffie-Hellman, entre clés statiques et éphémères, pour obtenir leurs clés de session.
Une clé prépartagée optionnelle peut être mêlée au calcul. Elle ajoute une couche de protection si Curve25519 tombait un jour face à un ordinateur quantique : un attaquant devrait aussi connaître cette clé, qui ne circule jamais.
Silencieux par conception
Un serveur WireGuard ne répond à aucun paquet qu’il ne peut pas authentifier. Chaque message de poignée de main porte un premier code, calculé avec la clé publique du destinataire : sans la connaître, impossible d’obtenir une réponse. Le port est donc invisible à un balayage. Sous forte charge, le répondeur peut en plus exiger un second code, dérivé d’un cookie qu’il envoie dans un message de 64 octets, pour ne traiter que les initiateurs capables de recevoir des réponses à leur adresse.
Il n’y a pas non plus de message de maintien par défaut. Un client derrière un NAT peut en activer un, toutes les 25 secondes selon la valeur conseillée, pour que le routeur garde sa traduction ouverte.
Minuteries et renouvellement des clés
Les clés de session sont renouvelées toutes les deux minutes par une nouvelle poignée de main, et refusées au-delà de trois minutes. Chaque paquet de données porte un compteur de 64 bits, qui sert de nonce au chiffrement et alimente une fenêtre anti-rejeu. Comme les clés changent sans cesse, la compromission d’une clé de session n’expose que quelques minutes de trafic.
Un paquet de données ajoute 32 octets : un en-tête de 16 octets (type, index du destinataire, compteur) et une étiquette d’authentification de 16 octets. Avec l’en-tête UDP et un en-tête IPv6, le surcoût atteint 80 octets, d’où la MTU de 1 420 octets retenue par défaut sur un lien à 1 500. Cette question est détaillée dans la page sur les interfaces virtuelles.
Changer de réseau sans couper
WireGuard n’a pas de notion de connexion, et c’est un avantage sur mobile. Quand un téléphone passe du Wi-Fi à la 4G, son adresse change ; le serveur l’apprend simplement en recevant un paquet correctement authentifié depuis la nouvelle adresse, et y envoie désormais ses réponses. Aucune renégociation n’est nécessaire, et l’utilisateur ne voit rien. IKEv2 n’obtient le même résultat qu’avec une extension, MOBIKE. La règle est stricte : seule une authentification réussie peut déplacer un pair, sans quoi n’importe qui pourrait détourner son trafic en envoyant un paquet depuis une autre adresse.
Ce que WireGuard ne fait pas
- Il n’attribue pas d’adresses dynamiquement : chaque pair a ses adresses fixées dans la configuration.
- Il n’authentifie pas d’utilisateurs, seulement des clés. Un service qui veut des comptes doit construire sa propre couche de gestion autour.
- Il garde en mémoire la dernière adresse IP de chaque pair, ce qui pose une question de confidentialité aux services grand public, obligés d’ajouter leurs propres mécanismes.
- Il ne cherche pas à se cacher : ses messages ont des types et des tailles fixes, faciles à reconnaître par un filtre réseau.
- Il ne fonctionne qu’en UDP.
Pourquoi c’est le meilleur code à lire
Le protocole a fait l’objet de preuves formelles, et plusieurs implémentations indépendantes existent : le module du noyau Linux en C, wireguard-go en Go, un pilote noyau pour Windows, et boringtun en Rust. Pour apprendre, deux chemins de lecture :
- dans le noyau Linux, le dossier
drivers/net/wireguard:messages.hpour les formats,noise.cpour la poignée de main,send.cetreceive.cpour les deux boucles,allowedips.cpour le routage par clé ; - dans wireguard-go, le dossier
device:noise-protocol.go,send.go,receive.goetallowedips.go, plus faciles à suivre pour qui ne connaît pas le noyau.
Ces deux boucles d’envoi et de réception sont exactement celles que décrit le squelette d’un programme VPN. Et pour voir les messages de 148 et 92 octets passer réellement, il suffit d’un serveur de test et de tcpdump. Les briques cryptographiques, elles, sont expliquées dans la page sur les algorithmes.