# 🛡️ WGSecure (WGS)

![Version](https://img.shields.io/badge/version-0.4.0-blue?style=flat-square)
![Python](https://img.shields.io/badge/Python-3.11+-3776ab?style=flat-square&logo=python&logoColor=white)
![PyQt6](https://img.shields.io/badge/PyQt6-6.4+-41cd52?style=flat-square&logo=qt&logoColor=white)
![Linux](https://img.shields.io/badge/Linux-compatible-fcc624?style=flat-square&logo=linux&logoColor=black)
![Windows](https://img.shields.io/badge/Windows-10%2B-0078d4?style=flat-square&logo=windows&logoColor=white)
![MFA](https://img.shields.io/badge/MFA-TOTP-e74c3c?style=flat-square)
![WireGuard](https://img.shields.io/badge/WireGuard-VPN-88171a?style=flat-square)

**WGSecure** est une interface graphique multiplateforme (Windows & Linux) pour gérer une connexion WireGuard avec une surcouche MFA (authentification à deux facteurs TOTP).

---

## ✨ Fonctionnalités

| # | Fonctionnalité | Détail |
|---|---|---|
| 🖥️ | **Interface systray** | Icône bouclier dans la barre de notification, connexion en un clic |
| 👤 | **Mode User** (défaut) | Connexion / déconnexion WireGuard, statut RX/TX en temps réel |
| ⚙️ | **Mode Admin** | Configuration complète, protégé par mot de passe |
| 🔑 | **Génération de clés** | Paire Curve25519 native (sans dépendance au binaire `wg`) |
| 🛡️ | **Configuration WireGuard** | Serveur, port UDP, DNS, IP client, keepalive |
| 🔐 | **MFA TOTP** | Compatible Google Authenticator / Aegis + QR Code |
| 📡 | **Test de connexion** | Vérification UDP du serveur avant établissement du tunnel |
| 🪟🐧 | **Cross-platform** | Windows 10+ et Linux (wg-quick) |

---

## 📋 Prérequis

### 🐧 Linux
```bash
sudo apt install wireguard-tools   # Debian/Ubuntu
sudo dnf install wireguard-tools   # Fedora
```

### 🪟 Windows
- [WireGuard for Windows](https://www.wireguard.com/install/) installé

### 🐍 Python
```
Python >= 3.11
```

---

## 📦 Installation

```bash
git clone <repo>
cd WGSecure
pip install -r requirements.txt
```

---

## 🚀 Utilisation

### Mode User (par défaut)
```bash
python main.py
```

### ⚙️ Mode Administrateur (configuration)
```bash
python main.py --admin
```

### Sans systray
```bash
python main.py --no-tray
```

---

## 🗺️ Workflow recommandé

1. 🚀 Lancer `python main.py --admin`
2. 🛡️ Onglet **WireGuard** : renseigner l'adresse, le port et la clé publique du serveur
3. 🔑 Onglet **Clés** : générer une paire de clés → copier la clé publique sur le serveur
4. 🔐 Onglet **MFA** : activer le MFA, générer un secret, scanner le QR Code
5. 🔒 Onglet **Sécurité** : définir un mot de passe pour l'accès admin
6. ✅ **Enregistrer** → quitter → lancer `python main.py` en mode user

---

## 🏗️ Architecture

```
WGSecure/
├── main.py                      # 🚀 Point d'entrée
├── requirements.txt
├── app/
│   ├── __init__.py              # Version
│   ├── core/
│   │   ├── config.py            # 💾 Configuration JSON persistante
│   │   ├── wireguard.py         # 🛡️ Clés, tunnel, statut
│   │   └── mfa.py               # 🔐 TOTP / QR Code
│   ├── ui/
│   │   ├── icons.py             # 🎨 Icônes bouclier générées par QPainter
│   │   ├── main_window.py       # 👤 Fenêtre principale (mode user)
│   │   ├── admin_window.py      # ⚙️  Panneau admin (6 onglets, thème sombre)
│   │   ├── mfa_dialog.py        # 🔐 Dialog de vérification MFA
│   │   └── systray.py           # 🖥️ Icône systray + menu contextuel
│   └── utils/
│       └── platform_utils.py    # 🔧 Détection OS, élévation de privilèges
```

---

## 🔒 Sécurité

| Élément | Protection |
|---|---|
| 🔑 Mot de passe admin | Hash SHA-256 + salt aléatoire 16 octets |
| 🗝️ Clé privée WireGuard | `~/.wgsecure/config.json` (Linux) / `%APPDATA%\WGSecure\` (Windows) |
| 🔐 Secret MFA TOTP | Stocké dans le fichier de configuration local |
| 📄 Fichier `.conf` WireGuard | Permissions `0600` (lecture propriétaire uniquement) |

> ⚠️ **Recommandation** : chiffrez votre disque pour protéger le fichier de configuration.

---

## 🖼️ Interface

| Fenêtre principale | Panneau Admin |
|---|---|
| Statut connexion en temps réel | 6 onglets thème sombre |
| Bouton connexion / déconnexion | WireGuard · Clés · MFA · Test · Sécurité · À propos |
| Icône systray bouclier colorée | Bandeau coloré par onglet |

---

## 👤 Auteur

Développé par **Johnny** — [JT-Tools](https://github.com/JT-Tools)
Version : ![v0.4.0](https://img.shields.io/badge/v0.4.0-juin%202026-2980b9?style=flat-square) — Juin 2026