Documentation Technique

Documentation WireGuard

Guide complet pour l'installation, la configuration et l'utilisation du VPN WireGuard intégré à NetTicket.

Table des Matières

Téléchargements

Introduction à WireGuard

WireGuard est un protocole VPN moderne, rapide et sécurisé qui utilise une cryptographie de pointe. Conçu pour être simple, léger et facile à auditer, il offre des performances supérieures aux protocoles VPN traditionnels comme OpenVPN et IPSec.

NetTicket intègre nativement WireGuard pour offrir un accès sécurisé à vos réseaux locaux, permettant aux administrateurs de gérer à distance leurs zones WiFi et leurs équipements réseau.

Avantages Principaux

  • Performance exceptionnelle : Latence réduite et débit élevé grâce à une implémentation dans le noyau Linux
  • Sécurité moderne : Cryptographie de pointe avec ChaCha20, Poly1305 et Curve25519
  • Configuration simple : Fichiers de configuration minimalistes et faciles à comprendre
  • Multiplateforme : Disponible sur Windows, macOS, Linux, iOS, Android et plus encore

Remarque Importante

WireGuard est intégré à NetTicket et ne nécessite pas d'installation séparée sur le serveur. Cette documentation concerne principalement la configuration des clients pour se connecter à votre infrastructure NetTicket.

Architecture WireGuard

Modèle de Sécurité

WireGuard utilise un modèle de sécurité basé sur l'échange de clés publiques, similaire à SSH. Chaque pair (client ou serveur) possède une paire de clés publique/privée.

  • Clé privée : Gardée secrète par chaque pair
  • Clé publique : Partagée avec les autres pairs pour établir la connexion

Composants Principaux

Serveur NetTicket
  • • Interface WireGuard configurée
  • • Gestion des clés publiques des clients
  • • Routage du trafic vers les zones WiFi
  • • Monitoring des connexions
Clients WireGuard
  • • Application WireGuard installée
  • • Configuration spécifique au client
  • • Authentification par clé publique
  • • Connexion chiffrée au serveur

Flux de Communication

  1. Le client initie une connexion au serveur NetTicket en utilisant l'adresse IP publique et le port configurés
  2. Le serveur vérifie la clé publique du client pour l'authentification (seuls les clients autorisés peuvent se connecter)
  3. Un tunnel chiffré est établi entre le client et le serveur, permettant une communication sécurisée
  4. Le client peut désormais accéder aux ressources du réseau local selon les règles de routage configurées

Installation du Client WireGuard

Pour vous connecter au VPN WireGuard de NetTicket, vous devez installer le client WireGuard sur votre appareil. Suivez les instructions ci-dessous pour votre système d'exploitation.

Installation sur Windows
  1. 1

    Téléchargez le programme d'installation depuis le site officiel de WireGuard

  2. 2

    Exécutez le fichier téléchargé (wireguard-installer.exe) et suivez les instructions d'installation

  3. 3

    Une fois l'installation terminée, lancez l'application WireGuard depuis le menu Démarrer

  4. 4

    Vous êtes maintenant prêt à importer votre fichier de configuration NetTicket (voir section Configuration)

Installation sur macOS
  1. 1

    Téléchargez l'application depuis le Mac App Store ou le site officiel

  2. 2

    Ouvrez le fichier .dmg téléchargé et faites glisser l'application WireGuard dans votre dossier Applications

  3. 3

    Lancez l'application WireGuard depuis le Launchpad ou le dossier Applications

  4. 4

    Lors du premier lancement, vous devrez peut-être autoriser l'installation d'un composant système (en saisissant votre mot de passe administrateur)

Installation sur Linux

Ubuntu/Debian

sudo apt update && sudo apt install wireguard

Fedora

sudo dnf install wireguard-tools

Arch Linux

sudo pacman -S wireguard-tools

Pour les interfaces graphiques, vous pouvez installer NetworkManager-wireguard ou utiliser l'application WireGuard officielle disponible sur wireguard.com

Installation sur iOS
  1. 1

    Ouvrez l'App Store sur votre appareil iOS (iPhone ou iPad)

  2. 2

    Recherchez "WireGuard" et téléchargez l'application officielle développée par WireGuard Development Team

    Lien direct: App Store

  3. 3

    Une fois installée, ouvrez l'application et vous serez prêt à importer votre configuration NetTicket

Installation sur Android
  1. 1

    Ouvrez le Google Play Store sur votre appareil Android

  2. 2

    Recherchez "WireGuard" et téléchargez l'application officielle développée par WireGuard Development Team

    Lien direct: Google Play

  3. 3

    Une fois installée, ouvrez l'application et vous serez prêt à importer votre configuration NetTicket

Configuration

La configuration de WireGuard avec NetTicket est simple grâce à notre système de génération automatique de configuration. Voici comment configurer votre client WireGuard pour vous connecter à votre infrastructure NetTicket.

Configuration Serveur

La configuration du serveur WireGuard est automatiquement gérée par NetTicket. Voici un aperçu de ce que contient la configuration côté serveur :

[Interface]
# Configuration de l'interface WireGuard du serveur
PrivateKey = <clé_privée_du_serveur>
Address = 10.10.0.1/24
ListenPort = 51820
PostUp = iptables -A FORWARD -i wg0 -j ACCEPT; iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
PostDown = iptables -D FORWARD -i wg0 -j ACCEPT; iptables -t nat -D POSTROUTING -o eth0 -j MASQUERADE

# Configuration des clients autorisés
[Peer]
# Client 1
PublicKey = <clé_publique_client_1>
AllowedIPs = 10.10.0.2/32

[Peer]
# Client 2
PublicKey = <clé_publique_client_2>
AllowedIPs = 10.10.0.3/32

# ... autres clients

Note Importante

Vous n'avez pas besoin de configurer manuellement le serveur WireGuard. NetTicket gère automatiquement la configuration du serveur, l'ajout de nouveaux clients et la révocation des accès depuis l'interface d'administration.

Configuration Client

Pour configurer un client WireGuard, vous devez importer un fichier de configuration généré par NetTicket. Voici comment procéder :

  1. 1

    Générer la configuration client

    Connectez-vous à votre interface d'administration NetTicket et accédez à la section "VPN WireGuard"

    Cliquez sur "Ajouter un client", donnez un nom au client (ex: "Ordinateur Bureau") et cliquez sur "Générer la configuration"

  2. 2

    Télécharger le fichier de configuration

    Téléchargez le fichier de configuration (.conf) ou scannez le code QR avec l'application mobile WireGuard

    client-bureau.conf

    Note: Ce fichier contient des informations sensibles, ne le partagez pas avec des tiers

  3. 3

    Importer la configuration

    Ouvrez l'application WireGuard sur votre appareil et importez le fichier de configuration :

    Windows

    Cliquez sur "Importer un tunnel depuis un fichier" et sélectionnez le fichier .conf téléchargé

    macOS

    Cliquez sur le bouton "+" puis "Ajouter un tunnel vide..." et importez le fichier .conf

    Mobile

    Appuyez sur le bouton "+" puis scannez le code QR ou importez le fichier .conf

    Une fois importé, le tunnel apparaîtra dans la liste des tunnels disponibles

  4. 4

    Activer la connexion

    Activez le tunnel en cliquant sur le bouton d'activation ou en faisant glisser l'interrupteur. Vous êtes maintenant connecté au VPN NetTicket !

Exemple de fichier de configuration client

[Interface]
# Configuration de l'interface WireGuard du client
PrivateKey = <clé_privée_du_client>
Address = 10.10.0.2/32
DNS = 1.1.1.1, 8.8.8.8

[Peer]
# Configuration du serveur NetTicket
PublicKey = <clé_publique_du_serveur>
Endpoint = vpn.netticket.com:51820
AllowedIPs = 10.10.0.0/24, 192.168.1.0/24
PersistentKeepalive = 25

Explication des paramètres

  • PrivateKey :Clé privée du client, générée automatiquement par NetTicket
  • Address :Adresse IP virtuelle attribuée au client sur le réseau VPN
  • DNS :Serveurs DNS à utiliser lorsque le VPN est actif (personnalisable dans NetTicket)
  • PublicKey :Clé publique du serveur NetTicket
  • Endpoint :Adresse IP ou nom de domaine et port du serveur NetTicket
  • AllowedIPs :Réseaux accessibles via le VPN (peut être configuré pour un accès total ou partiel)
  • PersistentKeepalive :Envoie un paquet toutes les 25 secondes pour maintenir la connexion active (utile derrière un NAT)

Gestion des Clés

NetTicket gère automatiquement les clés WireGuard pour vous. Voici comment gérer les clés et les accès VPN :

Rotation des Clés

Pour des raisons de sécurité, il est recommandé de renouveler régulièrement les clés de vos clients VPN.

  1. 1

    Accédez à la section "VPN WireGuard" dans l'interface d'administration

  2. 2

    Sélectionnez le client dont vous souhaitez renouveler les clés

  3. 3

    Cliquez sur "Renouveler les clés" et téléchargez la nouvelle configuration

  4. 4

    Importez la nouvelle configuration sur l'appareil client (l'ancienne configuration ne fonctionnera plus)

Révocation d'Accès

Si un appareil est perdu, volé ou si un utilisateur ne doit plus avoir accès au VPN, vous pouvez révoquer son accès :

  1. 1

    Accédez à la section "VPN WireGuard" dans l'interface d'administration

  2. 2

    Sélectionnez le client dont vous souhaitez révoquer l'accès

  3. 3

    Cliquez sur "Révoquer l'accès" et confirmez l'opération

  4. 4

    L'accès est immédiatement révoqué et le client ne pourra plus se connecter au VPN

Dépannage

Si vous rencontrez des problèmes avec votre connexion VPN WireGuard, voici quelques solutions aux problèmes les plus courants.

Problèmes Courants

Impossible de se connecter au serveur VPN

1

Vérifiez votre connexion Internet - Assurez-vous que votre appareil est connecté à Internet

2

Vérifiez l'adresse du serveur - Assurez-vous que l'adresse du serveur (Endpoint) dans votre configuration est correcte

3

Vérifiez le pare-feu - Assurez-vous que le port UDP utilisé par WireGuard (généralement 51820) n'est pas bloqué par votre pare-feu

4

Vérifiez le statut du serveur - Consultez le tableau de bord NetTicket pour vérifier que le service VPN est actif

Connexion établie mais impossible d'accéder aux ressources

1

Vérifiez les AllowedIPs - Assurez-vous que les réseaux auxquels vous souhaitez accéder sont inclus dans la configuration AllowedIPs

2

Vérifiez le routage - Contactez votre administrateur NetTicket pour vérifier la configuration du routage côté serveur

3

Testez la connectivité - Utilisez ping ou traceroute pour tester la connectivité vers les ressources du réseau local

Performance dégradée ou latence élevée

1

Changez de serveur - Si plusieurs serveurs VPN sont disponibles, essayez-en un autre plus proche géographiquement

2

Vérifiez votre bande passante - Testez votre connexion Internet sans VPN pour comparer les performances

3

Optimisez la configuration - Ajustez le paramètre PersistentKeepalive selon votre type de connexion

Logs et Diagnostics

Pour diagnostiquer les problèmes de connexion VPN, vous pouvez consulter les logs WireGuard sur votre appareil :

Logs Windows

Sur Windows, les logs WireGuard sont accessibles via l'interface graphique :

  1. 1. Ouvrez l'application WireGuard
  2. 2. Sélectionnez votre tunnel
  3. 3. Cliquez sur "Afficher les logs"
  4. 4. Recherchez les erreurs ou messages d'avertissement
Logs Linux

Sur Linux, utilisez les commandes suivantes pour consulter les logs :

sudo journalctl -u wg-quick@wg0
sudo wg show

Questions Fréquentes

Combien d'appareils puis-je connecter simultanément ?

Le nombre d'appareils dépend de votre plan NetTicket : 2 connexions pour Starter, 10 pour Professional, et illimitées pour Enterprise. Chaque appareil nécessite sa propre configuration unique.

Le VPN WireGuard fonctionne-t-il sur tous les réseaux ?

WireGuard fonctionne sur la plupart des réseaux, y compris derrière un NAT. Cependant, certains réseaux d'entreprise ou publics peuvent bloquer le trafic VPN. Dans ce cas, contactez votre administrateur réseau.

Puis-je utiliser le VPN pour accéder à Internet ?

Par défaut, le VPN NetTicket est configuré pour l'accès aux ressources locales uniquement. Si vous souhaitez router tout votre trafic Internet via le VPN, contactez votre administrateur pour modifier la configuration AllowedIPs.

Que faire si j'ai perdu mon fichier de configuration ?

Connectez-vous à l'interface d'administration NetTicket, accédez à la section VPN WireGuard, et téléchargez à nouveau votre configuration. Si vous ne trouvez pas votre appareil dans la liste, contactez votre administrateur.

Le VPN consomme-t-il beaucoup de batterie sur mobile ?

WireGuard est optimisé pour les appareils mobiles et consomme très peu de batterie. Il utilise des techniques avancées de gestion de l'énergie et ne maintient des connexions actives que lorsque nécessaire.

Puis-je partager ma configuration VPN avec d'autres personnes ?

Non, chaque configuration VPN est unique et liée à un appareil spécifique. Partager votre configuration compromettrait la sécurité. Chaque utilisateur doit avoir sa propre configuration générée par l'administrateur NetTicket.

Besoin d'Aide Supplémentaire ?

Si vous ne trouvez pas la réponse à votre question dans cette documentation, notre équipe de support est là pour vous aider.

Support Technique

Pour les problèmes techniques liés au VPN WireGuard

Contacter le Support

Documentation Complète

Téléchargez le guide complet au format PDF

WhatsApp
Messenger
Telegram
Facebook
Instagram
Twitter
Canal Telegram
Canal WhatsApp
Chaîne YouTube