Port-Guard

Port-Guard est un outil de gestion et de sécurisation des ports USB conçu pour Debian. Il permet de contrôler l’accès aux périphériques USB, de maintenir une whitelist personnalisée, et d’exécuter un scan automatique en arrière-plan pour détecter toute connexion non autorisée.

⚠️ Version bêta : Le logiciel est fonctionnel, mais des comportements inattendus peuvent subsister. Merci de remonter tout bug ou anomalie via les issues du dépôt Git.

Licence : GNU GPL v3 Auteur : k3rnix

🧩 Fonctionnalités

• 🔒 Blocage / déblocage de tous les ports USB.
• 📜 Gestion d’une whitelist (ajout, suppression, nettoyage).
• 🛰️ Daemon de scan automatique (portguard.service).
• 🖥️ Interface CLI claire et guidée.
• 🗂️ Journalisation détaillée dans : /opt/port-guard/logs/daemon-scan.log.

🚧 Roadmap & Checklist du Projet

Cette section sert de tableau d’avancement pour les différentes composantes du projet. Elle peut être mise à jour au fil des versions Git.

🔹 Logiciel principal (Shell)

🔹 Interface Graphique (C++ / ImGui)

📦 Installation

CLI version

1. Débranchez tout périphérique USB externe (sauf ceux à inclure dans la whitelist initiale).
2. Installez le paquet .deb :
   root@kitploit:~

   sudo dpkg -i PortGuard_1.x.x.deb
   

Configuration par défaut

Après l'installation :

• La WhiteList ne contient aucun périphérique.
• Le scan automatique n'est pas activé par défaut. Il faut lancer l'application et l'activer manuellement via le menu principal.

Gestion de la WhiteList

• Fichier de configuration : /opt/port-guard/conf/usb-whitelist.conf
• Format : [USB] SERIAL=123456789 MODEL=USB_DISK_x
• Tu peux ajouter, supprimer ou vider des périphériques via le menu principal de l’application.

Désinstallation

Pour désinstaller Port-Guard proprement, il suffit de lancer l'option :

sudo portguard -u
# ou
sudo portguard --uninstall

Cette procédure :

• Arrête et désactive le service portguard.service.

• Supprime tous les fichiers de l’application dans /opt/port-guard/.

• Supprime le binaire /usr/local/bin/portguard.

• Supprime le desktop file et l’icône dans /usr/share/.

• Supprime la documentation système dans /usr/share/doc/port-guard/.

• Sauvegarde la WhiteList et les logs dans le /tmp/

• Après exécution, Port-Guard sera complètement retiré de la machine.