Comment écrire un point de terminaison IPv6 dans une configuration VPN

Une adresse IPv6 est pleine de deux-points, et un champ de point de terminaison qui porte aussi un port a besoin d’un moyen de marquer où l’adresse se termine. Si vous vous trompez, le client refuse d’analyser le profil ou se connecte silencieusement à la mauvaise chose. La forme correcte n’est pas universelle : elle dépend de si le champ contient une adresse avec port, une adresse nue ou un nom d’hôte. Parcourez le guide dans l’ordre, car une correction de syntaxe et une correction d’accessibilité ne se ressemblent pas du tout dès que vous lisez la sortie du client.

Vérifiez le type de champ avant de saisir une adresse

Pour un champ WireGuard Endpoint avec un port, le littéral IPv6 utilise des crochets autour de l’adresse, comme dans [2001:db8::10]:51820. Le préfixe de documentation de cet exemple n’est pas un serveur public, et les crochets font partie de la syntaxe, pas de l’adresse.

D’autres formats ont leurs propres règles. Un URI peut porter un littéral IPv6 entre crochets, mais une configuration VPN n’est pas forcément un URI. Un client avec des champs séparés pour l’adresse et le port peut attendre le littéral seul dans l’un et le numéro dans l’autre, et y ajouter des crochets est aussi faux que de les omettre dans un champ combiné.

Mettez le littéral entre crochets quand le port partage le champ

La règle à retenir est simple : les crochets apparaissent quand un port suit dans la même chaîne. Ils n’apparaissent pas quand l’adresse est seule dans un champ sans port.

Copier la chaîne de point de terminaison complète d’un protocole dans chaque client est la cause habituelle de cette erreur. OpenVPN, les profils IPsec et les interfaces d’application documentent chacun leur propre syntaxe, et une chaîne correcte pour l’un peut être rejetée ou mal interprétée par un autre. Lisez la documentation du client lui-même pour le champ que vous modifiez, et gardez le préfixe de documentation ou l’adresse d’exemple dans un commentaire pour que personne ne l’envoie comme un hôte réel. Quand le manuel donne deux formes, utilisez celle qui correspond au type de champ devant vous.

Séparez les champs d’adresse et de port

Quand le client vous donne deux champs, mettez l’adresse dans l’un et le port dans l’autre. Une forme combinée collée dans le champ d’adresse produit une erreur d’analyse ou, pire, une adresse qui se résout en quelque chose d’inattendu.

Vérifiez les espaces de fin et les caractères invisibles quand une valeur semble correcte. Une adresse copiée porte souvent un espace insécable ou un caractère de largeur nulle que le client ne peut pas analyser et que l’écran n’affiche pas. Retapez la valeur au lieu de la coller quand l’erreur n’a pas de sens.

Gérez les identifiants de zone avec prudence

Un littéral de lien local peut exiger un identifiant de zone lié à une interface, écrit avec un signe de pourcentage et le nom de l’interface. Cette forme est valide sur l’hôte qui possède l’interface, et elle ne remplace pas un point de terminaison distant accessible de façon générale.

La portée et le routage comptent encore après une analyse réussie. Une adresse qualifiée par zone que le client accepte peut n’avoir aucun chemin depuis la machine, et un point de terminaison distant atteint par internet ne devrait pas du tout dépendre d’une zone locale. Décidez par quelle interface le paquet doit sortir avant d’écrire la zone, pas après l’échec de la poignée de main.

Vérifiez l’analyse, puis l’accessibilité

Séparez explicitement les deux échecs. Une adresse mal formée produit une erreur d’analyse ou un rejet immédiat, tandis qu’un point de terminaison bien formé qui refuse l’authentification ou ne répond jamais est un autre problème avec une autre solution.

Après une correction prise en charge, confirmez que le tunnel négocie et que l’application visée fonctionne. Une poignée de main seule ne prouve pas le chemin, et un ping vers le point de terminaison ne prouve pas le tunnel. Quand l’opérateur fournit un nom d’hôte, gardez le nom pris en charge et ses vérifications d’identité au lieu de le remplacer par une adresse numérique trouvée ailleurs.

Notez le champ exact, la valeur utilisée et la réponse du client dans la note de changement. Sinon, la personne suivante qui modifiera le profil refera l’expérience des crochets, et la réponse est déjà dans votre ticket.