k3rnix/portguardStrumento di controllo dell'accesso alle porte USB per Debian con gestione di whitelist, demone di scansione automatica in background e interfaccia CLI per bloccare o consentire dispositivi USB.
Port-Guard è uno strumento di gestione e sicurezza delle porte USB progettato per Debian. Consente di controllare l'accesso ai dispositivi USB, di mantenere una whitelist personalizzata e di eseguire una scansione automatica in background per rilevare qualsiasi connessione non autorizzata.
⚠️ Versione beta: Il software è funzionante, ma potrebbero verificarsi comportamenti imprevisti. Si prega di segnalare eventuali bug o anomalie tramite le issue del repository Git.
Licenza: GNU GPL v3 Autore: k3rnix
portguard.service)./opt/port-guard/logs/daemon-scan.log.Questa sezione funge da tabella di avanzamento per le diverse componenti del progetto. Può essere aggiornata nel corso delle versioni Git.
| Modulo | Stato | Descrizione |
|---|---|---|
| Gestione USB (blocco/sblocco) | ✔️ Completato | Funzione principale operativa |
| Gestione della whitelist | ✔️ Completato | Aggiunta / rimozione / svuotamento / parsing usb-whitelist.conf |
| Demone di scansione automatica | ✔️ Completato | Attivazione manuale, inclusi i log |
Pacchetto .deb | ✔️ Completato | Installazione pulita + disinstallazione |
| Modulo | Stato | Descrizione |
|---|---|---|
| Setup CMake + struttura progetto | ⬜ Da fare | Base del progetto |
| Integrazione ImGui | ⬜ Da fare | Finestra, pulsanti, tabella USB |
| Interazione con script Shell | ⬜ Da fare | Chiamate di sistema, ritorni di stato |
| Rilascio AppImage / binario | ⬜ Da fare | Pacchettizzazione multipiattaforma |
.deb:
sudo dpkg -i PortGuard_1.x.x.deb
Dopo l'installazione:
/opt/port-guard/conf/usb-whitelist.confPer disinstallare correttamente Port-Guard, è sufficiente eseguire l'opzione:
sudo portguard -u
# oppure
sudo portguard --uninstall
Ferma e disabilita il servizio portguard.service.
Rimuove tutti i file dell'applicazione in /opt/port-guard/.
Rimuove il binario /usr/local/bin/portguard.
Rimuove il file desktop e l'icona in /usr/share/.
Rimuove la documentazione di sistema in /usr/share/doc/port-guard/.
Salva la WhiteList e i log in /tmp/.
Dopo l'esecuzione, Port-Guard sarà completamente rimosso dalla macchina.