Port-Guard

Port-Guard es una herramienta de gestión y aseguramiento de puertos USB diseñada para Debian. Permite controlar el acceso a los dispositivos USB, mantener una lista blanca personalizada y ejecutar un escaneo automático en segundo plano para detectar cualquier conexión no autorizada.

⚠️ Versión beta: El software es funcional, pero pueden persistir comportamientos inesperados. Por favor, reporte cualquier error o anomalía mediante los issues del repositorio Git.

Licencia: GNU GPL v3 Autor: k3rnix

🧩 Funcionalidades

• 🔒 Bloqueo / desbloqueo de todos los puertos USB.
• 📜 Gestión de una lista blanca (añadir, eliminar, limpiar).
• 🛰️ Demonio de escaneo automático (portguard.service).
• 🖥️ Interfaz CLI clara y guiada.
• 🗂️ Registro detallado en: /opt/port-guard/logs/daemon-scan.log.

🚧 Hoja de Ruta y Checklist del Proyecto

Esta sección sirve como tablero de avance para los distintos componentes del proyecto. Puede actualizarse a lo largo de las versiones Git.

🔹 Software principal (Shell)

🔹 Interfaz Gráfica (C++ / ImGui)

📦 Instalación

Versión CLI

1. Desconecte todo dispositivo USB externo (excepto aquellos que desee incluir en la lista blanca inicial).
2. Instale el paquete .deb:
   root@kitploit:~

   sudo dpkg -i PortGuard_1.x.x.deb
   

Configuración por defecto

Después de la instalación:

• La lista blanca no contiene ningún dispositivo.
• El escaneo automático no está activado por defecto. Debe ejecutar la aplicación y activarlo manualmente desde el menú principal.

Gestión de la lista blanca

• Archivo de configuración: /opt/port-guard/conf/usb-whitelist.conf
• Formato:

[USB]
SERIAL=123456789
MODEL=USB_DISK_x

• Puede añadir, eliminar o vaciar dispositivos desde el menú principal de la aplicación.

Desinstalación

Para desinstalar Port-Guard correctamente, basta con ejecutar la opción:

sudo portguard -u
# o
sudo portguard --uninstall

Este procedimiento:

• Detiene y desactiva el servicio portguard.service.

• Elimina todos los archivos de la aplicación en /opt/port-guard/.

• Elimina el binario /usr/local/bin/portguard.

• Elimina el archivo .desktop y el icono en /usr/share/.

• Elimina la documentación del sistema en /usr/share/doc/port-guard/.

• Guarda la lista blanca y los registros en /tmp/.

• Tras la ejecución, Port-Guard quedará completamente eliminado del sistema.