Port-Guard

Port-Guard é uma ferramenta de gestão e segurança das portas USB projetada para Debian. Ela permite controlar o acesso aos dispositivos USB, manter uma whitelist personalizada e executar uma verificação automática em segundo plano para detectar qualquer conexão não autorizada.

⚠️ Versão beta: O software é funcional, mas comportamentos inesperados podem persistir. Agradecemos que reporte qualquer bug ou anomalia através das issues do repositório Git.

Licença: GNU GPL v3 Autor: k3rnix

🧩 Funcionalidades

• 🔒 Bloqueio / desbloqueio de todas as portas USB.
• 📜 Gestão de uma whitelist (adição, remoção, limpeza).
• 🛰️ Daemon de verificação automática (portguard.service).
• 🖥️ Interface CLI clara e guiada.
• 🗂️ Registro de logs detalhado em: /opt/port-guard/logs/daemon-scan.log.

🚧 Roadmap & Checklist do Projeto

Esta seção serve como quadro de progresso para os diferentes componentes do projeto. Ela pode ser atualizada ao longo das versões Git.

🔹 Software principal (Shell)

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

📦 Instalação

Versão CLI

1. Desconecte qualquer dispositivo USB externo (exceto aqueles a incluir na whitelist inicial).
2. Instale o pacote .deb:
   root@kitploit:~

   sudo dpkg -i PortGuard_1.x.x.deb
   

Configuração padrão

Após a instalação:

• A WhiteList não contém nenhum dispositivo.
• A verificação automática não é ativada por padrão. É necessário abrir o aplicativo e ativá-la manualmente pelo menu principal.

Gestão da WhiteList

• Arquivo de configuração: /opt/port-guard/conf/usb-whitelist.conf
• Formato: [USB] SERIAL=123456789 MODEL=USB_DISK_x
• Você pode adicionar, remover ou limpar dispositivos pelo menu principal do aplicativo.

Desinstalação

Para desinstalar o Port-Guard corretamente, basta executar a opção:

sudo portguard -u
# ou
sudo portguard --uninstall

Este procedimento:

• Para e desativa o serviço portguard.service.

• Remove todos os arquivos do aplicativo em /opt/port-guard/.

• Remove o binário /usr/local/bin/portguard.

• Remove o arquivo desktop e o ícone em /usr/share/.

• Remove a documentação do sistema em /usr/share/doc/port-guard/.

• Salva a WhiteList e os logs em /tmp/

• Após a execução, o Port-Guard será completamente removido da máquina.