Files
WGSecure/CHANGELOG.md
T
2026-09-06 12:40:51 +02:00

469 lines
41 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Changelog — WGSecure (WGS)
Toutes les modifications notables de ce projet sont documentées ici.
Format basé sur [Keep a Changelog](https://keepachangelog.com/fr/1.0.0/).
Ce projet suit le [Versionnage Sémantique](https://semver.org/lang/fr/).
---
## [0.8.0] — 2026-09-06
### Sécurité
- **Le code à 6 chiffres est désormais validé par le serveur, plus par l'application.** Jusqu'ici le secret TOTP était stocké côté client : l'application vérifiait un code qu'elle pouvait elle-même produire, et ne verrouillait donc que sa propre interface — un fichier `.conf` dérobé suffisait à entrer via le client WireGuard standard. Le tunnel monte maintenant en quarantaine réseau : le serveur ne laisse passer le trafic vers les ressources distantes qu'après validation du code, contre un secret que l'application ne détient pas.
### Modifié
- **Le tunnel est installé une fois, puis simplement démarré et arrêté.** Créer ou supprimer un service Windows n'est jamais délégable à un utilisateur standard, le démarrer peut l'être : c'est la réinstallation à chaque connexion qui imposait une authentification administrateur à chaque connexion *et* déconnexion. Le démarrage emprunte trois voies en cascade — appel direct, service `wgsecure-helper`, puis élévation en dernier recours — pour fonctionner quelle que soit la configuration du poste.
- Deux réglages dans le panneau Administrateur : l'identifiant VPN tel que connu du serveur, et l'URL de son API (déduite de l'adresse du client si laissée vide).
---
## [0.7.19] — 2026-09-05
### Sécurité
- **La clé privée ne subsiste plus en clair dans `%APPDATA%\WGSecure`.** Le fichier `.conf` généré pour monter le tunnel y restait indéfiniment, lisible par l'utilisateur : il est désormais écrasé puis supprimé dès que `wireguard.exe` l'a consommé (celui-ci en conserve sa propre copie, chiffrée par DPAPI, dans `ProgramData\WireGuard\Configurations`, et la désinstallation du tunnel ne prend que le nom de l'interface). Windows uniquement : sous Linux, `/etc/wireguard/<iface>.conf` reste indispensable à `wg-quick down`.
- **Le `.conf` importé peut être effacé dans la foulée.** Après un import, l'application propose d'écraser et supprimer le fichier source, qui contient lui aussi la clé privée en clair — il traîne sinon dans Téléchargements ou sur le Bureau. Proposé et non imposé : c'est un fichier choisi par l'utilisateur, le détruire sans confirmation serait irrattrapable si l'import s'avérait incorrect.
### Corrigé
- **« Erreur interne : module win32pipe has no attribute ImpersonateNamedPipeClient » à la connexion.** Cette fonction appartient à `win32security`, pas à `win32pipe` (vérifié par introspection de pywin32, et non plus supposé).
---
## [0.7.18] — 2026-09-05
### Corrigé
- **« Chemin de configuration hors du dossier attendu » à l'installation du tunnel par le service.** Le service exigeait que le `.conf` se trouve dans `%ProgramData%\WireGuard\`, alors que l'application l'écrit sous Windows dans `%APPDATA%\WGSecure\` (`get_client_config_path`) — le seul endroit où un utilisateur non-admin peut écrire. Ce dossier ne peut pas être recalculé par le service, qui tourne en LocalSystem et verrait le `%APPDATA%` de SYSTEM : la validation repose désormais sur l'usurpation d'identité du client du pipe (`ImpersonateNamedPipeClient`), le fichier devant être ouvrable **par l'appelant lui-même** — un utilisateur ne peut donc jamais faire lire à SYSTEM un fichier auquel il n'a pas déjà accès. S'y ajoutent des contrôles structurels (chemin absolu, sans remontée de répertoire, nommé exactement `<interface>.conf` dans un dossier `WGSecure`).
- Les messages de refus indiquent maintenant ce qui a été reçu **et** ce qui était attendu, au lieu du seul chemin rejeté.
---
## [0.7.17] — 2026-09-05
### Corrigé
- **Le service `wgsecure-helper` ne démarrait jamais réellement** — cause racine des invites d'authentification qui persistaient malgré les v0.7.12 à v0.7.16. Lancé par le gestionnaire de services, l'exécutable ne reçoit aucune commande sur sa ligne d'appel : `win32serviceutil.HandleCommandLine()` se contentait alors d'afficher son aide et de sortir, sans jamais entrer dans le dispatcher de service. `SvcDoRun()` n'était donc jamais exécuté (d'où l'absence totale de fichier journal), le pipe n'existait jamais, et l'application retombait systématiquement sur l'élévation UAC. Le point d'entrée bascule désormais sur `servicemanager.PrepareToHostSingle()` + `StartServiceCtrlDispatcher()` quand le service est démarré par le SCM, et ne conserve `HandleCommandLine()` que pour les invocations manuelles (`install`, `start`, `debug`…).
- Un échec de création du journal fichier est désormais signalé dans le journal d'événements Windows (source « WGSecureHelper ») au lieu de rester totalement silencieux.
---
## [0.7.16] — 2026-09-04
### Corrigé
- **Le service `wgsecure-helper` répondait au premier appel puis devenait injoignable** (connexion automatique au démarrage sans prompt, puis retour aux invites UAC ensuite). La boucle principale ne capturait que `pywintypes.error` et ne protégeait pas `CloseHandle` individuellement dans son nettoyage — une exception non prévue sur une requête, ou un échec de fermeture de handle, pouvait faire sortir de la boucle et arrêter tout le service. Chaque étape (création du pipe, connexion, traitement, fermeture) est désormais individuellement protégée par une capture large, avec un filet de sécurité final qui journalise toute erreur inattendue au lieu de laisser le service disparaître en silence. Gère aussi correctement `ERROR_PIPE_CONNECTED` (client connecté entre la création du pipe et l'appel `ConnectNamedPipe` — un cas normal, pas rare, qui faisait auparavant rater la requête).
---
## [0.7.15] — 2026-09-04
### Corrigé
- **Le service `wgsecure-helper` n'était jamais réellement utilisé par l'app** (split-DNS fonctionnait, mais toujours via le chemin élevé — 2 invites UAC à la connexion au lieu de 0). Le client du pipe (`app/utils/helper_ipc.py`) ne déclarait les signatures `ctypes` explicites que pour `CreateFileW` : sans elles, `ReadFile`/`WriteFile`/`CloseHandle` marshalaient le HANDLE (pointeur 64 bits) comme un entier 32 bits par défaut, le tronquant silencieusement — l'échange avec le service échouait alors systématiquement, et l'app retombait sur son ancien chemin élevé sans que rien ne le signale. Signatures explicites ajoutées pour chaque appel.
---
## [0.7.14] — 2026-09-04
### Corrigé
- **Le service `wgsecure-helper` n'était jamais enregistré par l'installeur.** Les entrées `[Run]` posant `sc.exe create ...` via l'échappement de guillemets `""` imbriqués d'Inno Setup produisaient une commande invalide — silencieusement : aucune erreur affichée pendant l'installation, alors que la même commande, lancée à la main avec une syntaxe équivalente, fonctionnait. Remplacé par un appel `Exec()` scripté (Pascal, `AddQuotes`) après la copie des fichiers, qui construit et lance la commande sans juggler des niveaux d'échappement de chaîne imbriqués. Même mécanisme pour la désinstallation (arrêt + suppression du service).
---
## [0.7.13] — 2026-09-04
### Corrigé
- **Pose de la règle split-DNS (NRPT) systématiquement en échec.** `Add-DnsClientNrptRule` n'a pas de paramètre `-Name` (contrairement à `Get-`/`Set-`/`Remove-DnsClientNrptRule` : la règle créée reçoit un identifiant GUID auto-généré) — `-Name` était résolu par PowerShell comme une abréviation ambiguë entre `-Namespace`/`-NameServers`/`-NameEncoding` (« le nom du paramètre "name" est ambigu »). Bug présent depuis l'introduction du split-DNS, resté invisible jusqu'à la v0.7.9 (les messages d'erreur d'une commande élevée remontaient vides). La règle est désormais identifiée/retrouvée via `-Comment`, comme le fait déjà le nettoyage générique du fichier. Corrige à la fois le chemin élevé classique et le service `wgsecure-helper` (v0.7.12), qui réutilise cette même fonction.
---
## [0.7.12] — 2026-09-04
### Ajouté
- **Service Windows privilégié `wgsecure-helper`.** Élimine les authentifications admin restantes à la connexion/déconnexion pour un compte non-admin. Tourne en LocalSystem, exécutable séparé jamais chargé par l'app principale ; expose cinq commandes fixes (`install_tunnel`, `uninstall_tunnel`, `set_split_dns`, `clear_split_dns`, `get_status`) via un pipe nommé sécurisé (SDDL explicite), chacune validant strictement ses paramètres — jamais de script/commande arbitraire accepté. L'app principale tente ce service en premier (client `ctypes` pur, sans nouvelle dépendance) et retombe sur le chemin élevé existant s'il est absent : purement additif, installation optionnelle. Corrige au passage le handshake qui ne se rafraîchissait jamais (`wg show` échouait systématiquement sans élévation complète, même avec les délégations de la v0.7.6).
- L'ACL du service WireGuard (bouton « Configurer les permissions ») ne délègue que démarrer/arrêter un tunnel déjà installé, jamais le créer/supprimer — WGSecure réinstalle pourtant le tunnel à chaque connexion/déconnexion. C'est ce qui rendait les invites d'authentification inévitables malgré la v0.7.6 à v0.7.11 ; le nouveau service couvre cette étape.
---
## [0.7.11] — 2026-09-04
### Corrigé
- **« Configurer les permissions » échouait si un tunnel était actif.** `Restart-Service` refuse d'arrêter le service WireGuard tant qu'un tunnel dépendant (`WireGuardTunnel$<nom>`) tourne — ce qui annulait toute l'opération alors que l'ACL et le registre venaient d'être appliqués avec succès. Le redémarrage est désormais tenté en best-effort : un échec produit un avertissement (déconnectez le tunnel puis redémarrez le service, ou redémarrez la machine) sans faire échouer le reste.
---
## [0.7.10] — 2026-09-04
### Corrigé
- **« Configurer les permissions » échouait à chaque nouvelle tentative une fois le groupe déjà accordé.** Le cas « déjà membre du groupe » était détecté en cherchant le texte anglais `already a member` dans le message d'erreur — jamais présent sur un Windows en français, qui renvoie « est déjà membre du groupe ». Détection basée désormais sur `FullyQualifiedErrorId` (`MemberExists,...`), stable et indépendant de la langue du système.
---
## [0.7.9] — 2026-09-04
### Corrigé
- **`sc sdset` échouait toujours (erreur 1804, SDDL invalide).** Le correctif précédent ajoutait l'ACE en fin de chaîne SDDL, mais la sécurité d'un service porte souvent aussi une clause `S:` (SACL — étiquette d'intégrité obligatoire, ex. `S:(ML;;NW;;;LW)`) : l'ACE se retrouvait alors insérée après le `S:`, produisant une SDDL syntaxiquement invalide. L'ACE est désormais insérée à l'intérieur de la clause `D:`, avant tout `S:` éventuel.
- **Caractères accentués corrompus dans les messages d'erreur Windows** (« échoué » affiché « chou »). Les outils console natifs (`sc.exe`, PowerShell non-Core) écrivent dans le codepage OEM de la console (CP850 en français), pas en UTF-8 ni en ANSI : `run_command()` décode désormais explicitement avec ce codepage. Le fichier de capture d'une commande élevée (v0.7.7) utilisait quant à lui la redirection `*>` brute, qui écrit en UTF-16LE par défaut sous Windows PowerShell — remplacée par `Out-File -Encoding utf8` explicite, lu en UTF-8.
---
## [0.7.8] — 2026-09-04
### Corrigé
- **ACL du service WireGuard jamais réellement posée par « Configurer les permissions ».** Le script PowerShell récupérait la SDDL actuelle via `Get-WmiObject ... .DACL.ToString()``.DACL` est un tableau d'objets PowerShell, pas une chaîne SDDL, donc `.ToString()` ne produisait pas la syntaxe attendue par `sc sdset`. L'échec n'était jamais vérifié : le bouton annonçait un succès alors que l'ACL n'était jamais appliquée, laissant l'installation/désinstallation du tunnel exiger une élévation en plus de celle (inévitable) du split-DNS — deux invites UAC au lieu d'une. Remplacé par `sc.exe sdshow` (format texte natif) avec insertion correcte de l'ACE et vérification explicite des codes de sortie (`sc sdset`, `Restart-Service`).
---
## [0.7.7] — 2026-09-04
### Corrigé
- **Messages d'erreur Windows toujours « erreur inconnue » pour toute opération élevée** (split-DNS, installation/désinstallation du tunnel). Un processus lancé via l'invite UAC (`ShellExecuteEx`/`runas`) ne peut jamais faire remonter son stdout/stderr au processus appelant — ni même via `Start-Process -RedirectStandardOutput`, qui échoue pour la même raison. La commande élevée écrit désormais elle-même sa sortie dans un fichier temporaire, relu ensuite : les messages d'échec redeviennent lisibles.
- **Handshake jamais affiché sur la page d'accueil sous Windows.** `wg show` était abandonné sans même être tenté dès que le processus n'était pas administrateur. L'appel non élevé est désormais réellement essayé (sans jamais ouvrir de fenêtre UAC) — il peut réussir si le mécanisme ci-dessous est actif.
### Ajouté
- **Délégation Windows étendue au mécanisme officiel WireGuard.** Le bouton « Configurer les permissions » active désormais aussi `LimitedOperatorUI` et l'ajout au groupe *Opérateurs de configuration réseau* (en plus de l'ACL du service déjà posée), pour élargir ce qu'un utilisateur non-admin peut faire sans invite UAC.
- **Diagnostic Windows honnête sur le split-DNS.** Aucune délégation à un utilisateur non-admin n'existe pour les règles NRPT (`Add`/`Remove-DnsClientNrptRule`) — le panneau Tests & diagnostic le signale désormais explicitement au lieu de laisser croire que l'ACL du service suffit à supprimer tous les prompts.
---
## [0.7.6] — 2026-09-04
### Ajouté
- **Fichier log texte des opérations.** En plus du journal JSON interne (`events.json`, limité à 200 entrées et illisible hors de l'application), chaque événement est désormais aussi écrit dans `wgsecure.log` (rotation automatique, 1 Mo × 3 fichiers) dans le dossier applicatif (`%APPDATA%\WGSecure` sous Windows, `~/.wgsecure` sous Linux) — consultable avec un simple éditeur de texte pour diagnostiquer un échec (ex. configuration du split-DNS) sans dépendre de l'interface.
### Corrigé
- **Messages du panneau Journal tronqués sans moyen de les lire en entier.** La barre de défilement horizontale était explicitement désactivée sur le panneau Journal, coupant net les messages longs (ex. une erreur NRPT complète sous Windows). Le défilement horizontal est réactivé et une infobulle affiche désormais le message complet au survol de chaque entrée.
---
## [0.7.5] — 2026-09-04
### Corrigé
- **Connexion Windows en échec silencieux sur « Accès refusé ».** `wireguard.exe /installtunnelservice` et `/uninstalltunnelservice` étaient lancés sans élévation en misant sur le manifeste UAC natif de `wireguard.exe` — qui ne s'auto-déclenche que lancé depuis l'explorateur ou via ShellExecute, jamais via l'appel process-à-process utilisé ici. Sans les ACLs du service accordées, la connexion échouait donc directement, sans jamais afficher la moindre invite. L'appel tente maintenant d'abord sans élévation (aucune UAC si les ACLs ont été accordées via le bouton dédié), puis retente avec une véritable élévation UAC (`ShellExecuteEx "runas"`) si le premier essai échoue.
- **Diagnostic d'élévation Windows trompeur.** Le panneau Tests & diagnostic annonçait qu'une invite UAC apparaîtrait à chaque connexion sans mentionner que les ACLs accordées au service l'évitent — corrigé pour refléter les deux cas.
---
## [0.7.4] — 2026-09-04
### Ajouté
- **Diagnostic du split-DNS.** Le test de connexion vérifie désormais que le(s) domaine(s) configuré(s) en split-DNS se résolvent bien vers le réseau distant (et pas juste qu'un résolveur quelconque répond) ; un outil de résolution à la demande est disponible dans le panneau Admin pour tester n'importe quel nom précis.
- **Verrouillage des champs après import d'un .conf.** Un fichier `.conf` importé décrit un pair déjà fonctionnel côté serveur : les champs se verrouillent désormais pour éviter qu'une modification manuelle ultérieure ne diverge silencieusement de la configuration réelle. Un bouton « Déverrouiller » reste disponible.
- **Aperçu du fichier de configuration à la demande.** Remplace l'aperçu qui restait dupliqué en permanence à côté des champs du formulaire.
### Corrigé
- **Split-DNS Linux reposé sur `resolvectl` par interface** au lieu d'un fichier global dans `/etc/systemd/resolved.conf.d/` suivi d'un redémarrage complet de `systemd-resolved`. Évite des droits que `make setup-sudoers` ne couvrait pas, une configuration en concurrence avec d'autres interfaces, et un résidu à nettoyer après un crash — systemd-resolved retire la config par lien dès que l'interface disparaît.
- **Règle NRPT Windows incomplète.** Un domaine de split-DNS sans point de tête ne matchait que le nom exact, jamais ses sous-domaines ; les deux formes de namespace sont désormais posées, comme `~domaine` le fait déjà sous Linux.
- **Échec silencieux de la configuration split-DNS.** Une erreur réelle d'`Add-DnsClientNrptRule` (Windows) ou de `resolvectl` (Linux) n'était pas remontée : le tunnel se déclarait « activé » même quand les noms du réseau distant ne se résolvaient jamais. Le message de succès affiche désormais un avertissement si le split-DNS n'a pas pu être appliqué.
### Interface
- **Couleurs de l'interface consolidées dans `app/ui/theme.py`.** Les teintes codées en dur dans les boîtes de dialogue MFA et Historique sont remplacées par les jetons partagés du thème, pour rester cohérentes si le thème évolue.
- Ajout du style des menus déroulants (`QComboBox`) dans le thème sombre.
---
## [0.7.3] — 2026-09-02
### Ajouté
- **Support du Split-DNS pour Linux et Windows.** Permet de configurer un serveur DNS dédié pour les noms du réseau distant (ex: 192.168.1.210) tout en utilisant le DNS système pour le reste du trafic internet. Sous Linux, utilise `systemd-resolved` ; sous Windows, utilise les règles NRPT.
- **Bouton de configuration des permissions Windows.** Dans l'onglet Tests & diagnostic → Élévation, un nouveau bouton permet à l'administrateur de configurer les ACLs du service WireGuard pour autoriser l'utilisateur actuel à créer/supprimer ses tunnels sans invite UAC.
### Corrigé
- **Appels à sc.exe supprimés sous Windows.** Remplacés par PowerShell `Get-Service` pour la détection, et `wireguard.exe` pour la gestion des services. Supprime les messages d'erreur "service inexistant" et évite les doubles appels à `uninstalltunnelservice`.
- **UAC déclenchée par WGSecure sous Windows.** Désormais, `wireguard.exe` est appelé via `run_command()` (pas `run_privileged`) et gère lui-même l'élévation via son manifeste natif. Si l'utilisateur a les permissions ACLs, aucune UAC n'est affichée.
- **Handshake bloqué par le redémarrage de systemd-resolved.** Le redémarrage de systemd-resolved est maintenant effectué de manière asynchrone pour éviter de bloquer le handshake WireGuard.
### Améliorations UI
- **Infobulles ajoutées** sur tous les champs de configuration principaux pour guider l'utilisateur (endpoint, clés, DNS, AllowedIPs, etc.).
---
## [0.7.1] — 2026-09-01
### Ajouté
- **Diagnostic : DNS hors des IPs autorisées.** Sur un tunnel scindé (AllowedIPs ≠ 0.0.0.0/0), NetworkManager/systemd-resolved associe le DNS configuré à l'interface WireGuard avec un domaine de routage global (`~.`) : toute résolution de nom est alors tentée via cette interface, qui n'a de route que vers les réseaux listés dans les IPs autorisées. Un DNS hors de cette liste (typiquement un résolveur public comme 1.1.1.1 sur un tunnel qui ne route que des sous-réseaux internes) devient injoignable par ce chemin — la résolution échoue en bloc alors que le reste d'Internet continue de fonctionner (d'où un `ping` sur une IP qui réussit à côté d'un `ping` sur un nom qui échoue). Le test de connexion signale maintenant ce cas précis.
### Corrigé
- **CHANGELOG.md absent de l'exécutable compilé.** `datas=[]` dans le build PyInstaller n'embarquait jamais le fichier, et son chemin — calculé depuis `__file__` — ne survivait de toute façon pas à l'extraction onefile : la page « À propos » restait vide une fois l'application compilée. Le fichier est désormais ajouté via `--add-data`, et son chemin bascule sur `sys._MEIPASS` en mode figé (frozen).
- **Badge de latence toujours « hors ligne » alors que le tunnel fonctionne.** Il se basait uniquement sur un ping ICMP vers l'endpoint du serveur ; de nombreux serveurs ou pare-feux bloquent l'ICMP echo tout en laissant le tunnel WireGuard fonctionner normalement. Repli sur l'âge du dernier handshake réel quand l'ICMP échoue.
- **Outils de diagnostic figeant l'application (« Ne répond plus »).** Le test de connexion, l'analyse de fuite DNS et la réparation DNS exécutaient leurs sondes (ping, `dig`, handshake, élévation de privilèges) directement sur le thread graphique — jusqu'à plusieurs secondes de gel total. Déportés sur des threads dédiés, comme le reste de l'application.
- **Installeur Windows incomplet.** WireGuard for Windows, prérequis de WGSecure, n'était jamais installé automatiquement. `wgsecure.iss` l'installe désormais en silence s'il est absent, au même titre que le Visual C++ Redistributable ; `make installer-deps` télécharge les deux binaires.
## [0.7.0] — 2026-09-01
### Ajouté
- **Instance unique.** Un second lancement (icône du menu, raccourci double-cliqué, autostart concurrent d'un lancement manuel) réveille désormais l'instance déjà active au lieu d'ouvrir une deuxième fenêtre sur le même tunnel. Implémenté via un socket local nommé (`app/core/single_instance.py`), portable Linux/Windows.
- **Lancement automatique et reconnexion automatique activés par défaut** pour une nouvelle installation (reconnexion à 15 s). Une configuration existante n'est jamais modifiée sans action explicite.
- **Page « À propos » refaite** sur le modèle QuiOulé/TuxMarket : cinq onglets (Fonctions, Garanties, Technique, Journal, Auteur), en-tête avec pastilles d'état vivantes (MFA, configuration sudoers). Contenu déplacé dans `app/app_info.py`, séparé de la présentation ; version lue dynamiquement depuis `app.__version__`.
### Corrigé
- **Dernier handshake et compteurs RX/TX qui ne s'affichaient plus.** `wg show` exige les droits root même en lecture seule ; l'appel se faisait sans élévation et échouait silencieusement dès que l'application ne tournait plus en root (le cas normal une fois `make setup-sudoers` en place). Nouvelle fonction `run_privileged_readonly` : élévation silencieuse via `sudo -n` uniquement, jamais de dialogue sur un sondage exécuté toutes les 3 secondes.
- **Diagnostic des droits sudo trompeur.** `make check-privileges` testait chaque commande avec `--version`/`-V`, des appels qui ne correspondent à aucune règle NOPASSWD restreinte par motif (ex. `ip link delete dev *`) : le diagnostic affichait « dialogue à chaque appel » même quand tout était correctement configuré. Les sondes reproduisent maintenant un appel réel couvert par les règles installées.
- **`make setup-sudoers` restait bloqué indéfiniment** hors session graphique (SSH, tmux, terminal sans agent polkit) : `pkexec` attendait une réponse d'un agent d'authentification absent. Remplacé par `sudo`, qui invite directement dans le terminal. La cible est aussi rendue idempotente : une relance ne redemande le mot de passe que si les règles ont changé.
- **README obsolète** : retrait des mentions d'un Kill Switch iptables absent du code actuel (probablement retiré lors d'un refactor sans mise à jour de la doc) ; section sur l'élévation de privilèges corrigée pour refléter l'ordre réel (`sudo -n` → askpass → `pkexec`, et non l'inverse).
## [0.6.0] — 2026-09-01
### Ajouté
- **Test de handshake réel, sans monter le tunnel.** Le diagnostic s'arrêtait au constat « le port
UDP ne rejette rien », qui est le maximum qu'une sonde aveugle puisse dire : un serveur WireGuard
ignore silencieusement tout paquet non authentifié, si bien qu'un port non redirigé, une clé
inconnue du serveur et un serveur en parfaite santé produisent exactement la même absence de
réponse. Le tunnel n'étant pas monté, les étapes suivantes étaient sautées et le rapport
concluait « chaîne validée » sur une configuration qui n'avait aucune chance de négocier.
WGSecure construit désormais un vrai message d'initiation et interprète la réponse : il distingue
un handshake complet, une clé pré-partagée attendue, en trop ou différente, un cookie anti-déni
de service, un port fermé et un silence complet — sans ouvrir de tunnel ni demander de privilèges.
- **Détection du filtrage sur port source.** Quand le serveur reste muet, une seconde tentative
part depuis le port du serveur. S'il répond alors, c'est qu'un équipement en chemin n'accepte le
trafic que si le port source égale le port de destination — une règle courante sur FortiGate,
dont l'objet Service porte un `udp-portrange 51820:51820`. Un client WireGuard émettant depuis un
port aléatoire ne peut jamais la satisfaire, et rien dans les journaux ne le disait.
### Modifié
- **Fenêtre d'administration ramenée à 720 × 600** (minimum 640 × 520) : le découpage en
sous-onglets a supprimé l'empilement qui imposait une grande fenêtre.
- **Encarts d'introduction retirés au-dessus des sous-onglets**, où ils répétaient ce que les
sous-onglets annoncent déjà. Ceux placés dans chaque sous-onglet sont conservés.
### Corrigé
- **Verdict trompeur quand le tunnel est inactif.** « Chaîne validée jusqu'au tunnel » laissait
croire que tout avait été vérifié, alors que les étapes sautées sont précisément celles qui
échouent quand un tunnel refuse de négocier. Le rapport annonce maintenant « rien de bloquant
détecté, mais le tunnel est inactif » et nomme les étapes non évaluées.
- **Causes du handshake manquant** : le port UDP du serveur figure désormais parmi les pistes
citées, un port erroné ne produisant aucune erreur visible.
### Technique
- Nouveau module `app/core/wg_handshake.py` : implémentation de la poignée de main
Noise_IKpsk2_25519_ChaChaPoly_BLAKE2s du protocole WireGuard v1. Aucun état n'est conservé, la
session négociée est jetée aussitôt et le serveur traite l'initiation comme celle d'un pair qui
se reconnecte.
## [0.5.0] — 2026-09-01
### Ajouté
- **Option « Le serveur utilise une clé pré-partagée »** : la présence d'une PSK ne se devinait
plus au fait que le champ soit rempli. Un serveur qui n'en utilise pas — le cas par défaut de
WireGuard — déclenchait un avertissement à chaque diagnostic, et une clé oubliée dans le champ
se retrouvait écrite dans la configuration alors que le serveur n'en attendait aucune, ce qui
casse le handshake aussi sûrement qu'une clé manquante. Le champ et ses boutons suivent la case.
- **Encart d'introduction en tête de chaque onglet** : les pages s'ouvraient sur un formulaire nu,
sans dire ce qu'on y décidait ni ce qui se passait si on n'y touchait pas.
### Modifié
- **Onglets « WireGuard » et « Clés » fusionnés** en un seul, découpé en sous-onglets *Tunnel*,
*Clés* et *Profils & fichiers*. Les deux se chevauchaient : la clé publique du serveur se
saisissait dans l'un pendant que l'assistant qui la produit vivait dans l'autre, et les quatre
façons de sortir une configuration (aperçu, .conf, QR Code, volet serveur) étaient réparties
entre les deux sans logique.
- **Onglet « Test » en sous-onglets** *Chaîne de connexion*, *Fuite DNS* et *Droits* : les trois
tests s'empilaient sur une page unique où le rapport de diagnostic, le plus long, se retrouvait
comprimé entre les deux autres.
- **Onglets « MFA » et « Sécurité » regroupés** sous *Sécurité*, en sous-onglets *MFA* et
*Mot de passe* : ils répondent à la même question, qui a le droit de se connecter et
d'administrer. La barre passe de sept onglets à cinq.
- **Couleurs unifiées** : le panneau d'administration comptait vingt-quatre couleurs écrites en
dur, cinq bandeaux d'onglets sans rapport de teinte entre eux, et des blocs de résultat dont le
fond ne correspondait ni à celui de la page ni à celui de leurs voisins. Tout passe par une
palette commune.
- **L'aperçu de configuration se remplit à l'ouverture** au lieu d'exiger un clic sur
« Rafraîchir ».
### Corrigé
- **Section « Droits d'exécution » inadaptée sous Windows** : elle parlait de règles sudo, d'un
fichier sudoers et de `make setup-sudoers`, qui n'existent pas sur cette plateforme, et
concluait « privilèges root, rien à configurer » là où le rapport était simplement vide. Elle
devient *Élévation*, vérifie les droits administrateur et la présence de WireGuard, et explique
comment éviter la fenêtre UAC à chaque connexion.
- **Causes du handshake manquant plus fidèles** : le message citait la clé pré-partagée sans
savoir si elle était en jeu, et passait sous silence le port UDP du serveur — un port erroné ne
produit aucune erreur visible, WireGuard ignorant silencieusement les paquets.
### Technique
- Nouveau module `app/ui/theme.py` : jetons de couleur, styles de blocs de résultat par état,
bandeaux et barres d'onglets.
- Le drapeau `use_preshared_key` vaut `None` par défaut et non `False` : la fusion des valeurs par
défaut recopie ce défaut dans toute configuration antérieure au drapeau, et `False` aurait
désactivé la clé pré-partagée d'un tunnel qui fonctionnait. Une configuration existante conserve
donc sa PSK, une configuration neuve démarre sans.
## [0.4.6] — 2026-09-01
### Corrigé
- **Handshake impossible quand le réseau local figure dans les « IPs autorisées »** : si la
passerelle qui mène au serveur appartient à une plage autorisée, `wg-quick` route cette plage
vers le tunnel avec une métrique de 0 — la route l'emporte sur celle de la carte réseau, la
passerelle n'est plus joignable que par le tunnel, et le tunnel a justement besoin d'elle pour
sortir. Le tunnel montait, l'interface existait, et plus aucun paquet de handshake ne quittait
la machine. Le diagnostic détecte désormais ce cas et le signale comme point de blocage, au lieu
du simple avertissement « imprimante et NAS passeront par le VPN » qui n'en disait pas la gravité.
- **Rapport de test de connexion illisible** : le panneau de résultat était un simple libellé que
la mise en page comprimait à quelques lignes tronquées, alors que le rapport en réclame le double.
Il devient une zone de texte défilante en pleine largeur, et la fenêtre d'administration, jusque-là
figée à 700 × 600, s'ouvre plus grande et se redimensionne librement.
### Technique
- Nouvelle fonction `_next_hop()` (`app/core/wireguard.py`) : détermine la passerelle réellement
empruntée pour joindre le serveur, via `ip route get` sous Linux et `Find-NetRoute` sous Windows.
- `_dark_page()` accepte une option `scroll` : les onglets dont le contenu grandit à l'usage
disposent d'une zone défilante.
## [0.4.5] — 2026-08-31
### Corrigé
- **Tunnel « connecté » sans jamais négocier de handshake** : la clé pré-partagée (PresharedKey)
n'était écrite dans aucune configuration client. L'assistant « Générer config serveur + client »
en produisait une, visible à l'écran, mais impossible à enregistrer ; et l'import d'un fichier
`.conf` l'ignorait purement et simplement. Face à un serveur qui en attend une, le tunnel montait,
l'interface existait, l'application affichait « Connecté » — et pas un paquet ne passait. La clé
pré-partagée est désormais un champ à part entière : saisie, importée, exportée et écrite dans la
configuration du tunnel.
- **Latence du serveur jamais mesurée hors système anglophone** : la sortie de `ping` est traduite
(« temps= » en français), et seule la forme anglaise était reconnue. Un serveur qui répondait
correctement était rapporté comme injoignable.
### Ajouté
- **Diagnostic complet de la chaîne de connexion** : le bouton « Lancer le test de connexion »
ne se contentait plus d'un simple test UDP. Il déroule maintenant toute la chaîne et désigne
l'étape exacte qui bloque : présence de WireGuard, complétude de la configuration, cohérence de
la paire de clés du client, clé pré-partagée, résolution du nom du serveur, route empruntée,
cohérence des « IPs autorisées », ping ICMP, port UDP, montage du tunnel, handshake, trafic
chiffré, joignabilité du pair distant et résolution DNS dans le tunnel.
- **Détection des deux pièges de routage classiques** : l'adresse du serveur incluse dans les
« IPs autorisées » (le tunnel se coupe l'herbe sous le pied dès qu'il monte) et le réseau local
couvert par ces mêmes plages (imprimante, NAS et box basculent dans le VPN).
- **Champ MTU** : réglable, laissé automatique par défaut, importé et exporté avec les fichiers `.conf`.
- **Bouton « Appliquer le volet client »** dans l'assistant de génération : reporte clés et clé
pré-partagée directement dans la configuration, au lieu de les laisser dans une fenêtre à recopier.
### Modifié
- **Statistiques du tunnel** : le dernier handshake est lu via `wg show latest-handshakes`, ce qui
permet d'en donner l'ancienneté exacte et de signaler un pair qui a cessé de répondre.
## [0.4.4] — 2026-08-31
### Corrigé
- **Tunnel impossible à monter sous Windows** : les commandes envoyées à `wireguard.exe`
utilisaient des options qui n'existent pas (`/installtunnel`, `/uninstalltunnel`). WireGuard
affichait sa boîte d'aide et sortait sans rien faire : le bouton « Connecter » ne montait jamais
le tunnel. Les vraies options `/installtunnelservice` et `/uninstalltunnelservice` sont
désormais utilisées.
- **WireGuard déclaré absent sous Windows** : l'installateur WireGuard n'ajoute pas son
répertoire au PATH, et l'application cherchait `wireguard.exe` et `wg.exe` sans chemin. Ils sont
maintenant localisés dans `C:\Program Files\WireGuard`.
- **« Accès refusé » silencieux sous Windows** : installer ou retirer un tunnel exige les droits
administrateur, qui n'étaient jamais demandés. Une invite UAC apparaît désormais au moment
voulu, et l'annulation de cette invite est signalée clairement.
- **Détection de WireGuard toujours négative sous Windows** : le test d'installation lançait
`wireguard --help`, une option inexistante sur une application graphique. La présence du
logiciel est maintenant vérifiée sur le disque.
- **Échec annoncé sur un tunnel qui montait** : le service du tunnel démarre de façon asynchrone
et l'état était vérifié trop tôt. L'application attend désormais son démarrage effectif.
### Ajouté
- **Statistiques du tunnel sous Windows** : volumes envoyés/reçus, pair et dernier handshake,
jusqu'ici affichés vides.
## [0.4.3] — 2026-08-31
### Corrigé
- **Fenêtres noires clignotantes sous Windows** : l'application interroge en continu l'état du
tunnel et la latence du serveur, et chacune de ces vérifications ouvrait brièvement une fenêtre
de commande. Des fenêtres DOS apparaissaient et disparaissaient en permanence pendant toute
l'utilisation du logiciel. Ces appels s'exécutent désormais de façon totalement invisible.
## [0.4.2] — 2026-08-31
### Corrigé
- **Binaire Windows qui ne démarrait pas** : le paquetage PyInstaller sous Wine oubliait
d'embarquer le plugin Qt nécessaire au rendu de l'interface graphique sous Windows, faisant
échouer l'application dès le lancement avec l'erreur « no Qt platform plugin could be
initialized ». Le plugin est désormais inclus systématiquement dans le binaire.
## [0.4.1] — 2026-08-31
### Corrigé
- **Plus d'accès internet après déconnexion du VPN** : `wg-quick down` refusait de s'exécuter
quand l'interface avait disparu sans passage par lui (crash, arrêt brutal, veille) et ne
retirait donc jamais l'entrée DNS posée par `wg-quick up` — la résolution de noms restait
pointée vers un serveur devenu injoignable. Nettoyage DNS désormais garanti à la connexion,
la déconnexion, la fermeture de l'application et au démarrage suivant.
- **Détection de connexion fiabilisée** : `wg show` retourne un code de succès même en cas de
refus de permission pour un utilisateur non administrateur — l'application se croyait
déconnectée en permanence et ne démontait donc jamais le tunnel à la fermeture. Détection
réécrite sans nécessiter de privilèges.
- **Interface figée pendant la connexion/déconnexion** : les commandes réseau (souvent
accompagnées d'une demande de mot de passe) tournaient sur le thread graphique et gelaient
la fenêtre. Déportées en tâche de fond.
- **Dialogues d'authentification répétés à chaque connexion** : la détection « sudo demande un
mot de passe » ne fonctionnait pas en session non anglophone ni pour les comptes disposant
de tous les droits sudo, et l'écriture de la configuration WireGuard n'était couverte par
aucune règle sudo autorisée. Chaîne de privilèges revue de bout en bout.
- Restauration garantie de l'état réseau à la fermeture de l'application, sous Linux comme
sous Windows (fermeture normale, icône système, signal d'arrêt, plantage).
### Ajouté
- Diagnostic des droits d'exécution (`make check-privileges` et bouton dans le panneau Admin)
pour identifier précisément quelle commande déclenche un dialogue d'authentification.
- Avertissement lorsqu'un tunnel WireGuard tourne en dehors de WGSecure (autre nom
d'interface), cause fréquente de coupure DNS non détectée jusqu'ici.
---
## [0.2.0] — 2026-06-01
### Ajouté
- **Onglet "À propos"** dans le panneau admin : logo bouclier, version, branding JT-Tools by Johnny
- **Icône bouclier vectorielle** générée par QPainter (7 résolutions : 16→256 px)
- Vert connecté / Rouge déconnecté / Orange connexion en cours / Bleu app / Violet admin
- **Icône barre des tâches** : installation automatique de `~/.local/share/icons/wgsecure.png`
et `~/.local/share/applications/wgsecure.desktop` au premier démarrage
- **Thème sombre uniforme** sur les 6 onglets du panneau admin (CSS partagé `_TAB_CSS`)
- Fond `#1c2833`, texte blanc, champs semi-transparents
- Bandeau coloré par onglet (bleu/navy/teal/bleu/rouge)
- TabBar cohérente avec onglet actif mis en évidence
- **Makefile** : compilation binaire Linux (`make linux`) et Windows (`make windows` via Wine)
- **README** enrichi avec badges shields.io (version, Python, PyQt6, plateformes) et emojis
### Corrigé
- **Bug MDP vide** : `set_admin_password("")` effaçait incorrectement — hashait la chaîne vide,
forçant une demande de mot de passe vide après suppression
- **Menu systray incomplet** : `QAction` en variables locales GC'd par Python avant affichage →
toutes les actions passent désormais `self` comme parent Qt
- **Section infos invisible** : `QWidget` sans `autoFillBackground` ne peignait pas son fond ;
remplacé par `QFrame` avec `setAutoFillBackground(True)` et couleurs explicites
- **Bouton agrandir persistant** : `setWindowFlag` seul ignoré par Mutter/XWayland →
`setWindowFlags()` complet sans `WindowMaximizeButtonHint`
### Amélioré
- Fenêtre principale agrandie 380×460 → 400×520 pour afficher les 6 lignes d'infos
- Police des labels infos : 11 → 12 px, couleurs explicites `#2c3e50`
- Panneau admin : largeur 620 → 700 px pour éviter le débordement des onglets
- `app.setWindowIcon()` posé sur `QApplication` (multi-tailles) + `setDesktopFileName()`
- Page About : icône 96 → 86 px (10 %), texte en blanc sur fond sombre `#1c2833`
---
## [0.1.0] — 2026-06-01
### Ajouté
- Interface graphique PyQt6 avec icône systray (Linux & Windows)
- **Mode User** (défaut) : connexion / déconnexion WireGuard en un clic, statut en temps réel
- **Mode Admin** (`--admin` ou via le menu) protégé par mot de passe
- Panneau Admin avec 5 onglets :
- **WireGuard** : configuration serveur (adresse, port UDP, clé publique, DNS, IP client)
- **Clés** : génération de paires Curve25519 (clé privée / publique), aperçu config exportable
- **MFA** : génération de secret TOTP, QR Code compatible Google Authenticator / Aegis
- **Test connexion** : vérification UDP du serveur avant tunnel
- **Sécurité** : gestion du mot de passe administrateur (SHA-256 + salt)
- Surcouche MFA : dialogue TOTP avec minuterie de validité (fenêtre glissante ±1)
- Génération de clés WireGuard via `cryptography` (X25519, sans `wg` binaire)
- Écriture automatique du fichier `.conf` WireGuard avec permissions `0600`
- Connexion via `wg-quick` (Linux) ou `wireguard /installtunnel` (Windows)
- Statut temps réel : trafic RX/TX, dernier handshake
- Réduction dans le systray à la fermeture de la fenêtre principale
- Configuration persistante JSON (`~/.wgsecure/config.json`)
---
*Versions planifiées :*
- `0.3.0` — Import/export de profils WireGuard (.conf), support multi-profils
- `0.4.0` — MFA par clé matérielle (FIDO2/YubiKey)
- `0.5.0` — Paquet installable (Windows .exe / Linux .deb)