Port-Guard

Port-Guard는 Debian을 위해 설계된 USB 포트 관리 및 보안 도구입니다. USB 장치에 대한 액세스를 제어하고, 사용자 정의 whitelist를 유지하며, 백그라운드에서 자동 스캔을 실행하여 승인되지 않은 연결을 감지할 수 있습니다.

⚠️ 베타 버전 : 소프트웨어는 작동하지만 예기치 않은 동작이 발생할 수 있습니다. 버그나 이상 징후는 Git 저장소의 이슈를 통해 보고해 주시기 바랍니다.

라이선스 : GNU GPL v3 저자 : k3rnix

🧩 기능

• 🔒 모든 USB 포트 차단/해제.
• 📜 whitelist 관리 (추가, 삭제, 정리).
• 🛰️ 자동 스캔 데몬 (portguard.service).
• 🖥️ 명확하고 안내되는 CLI 인터페이스.
• 🗂️ 상세 로깅 위치 : /opt/port-guard/logs/daemon-scan.log.

🚧 프로젝트 로드맵 및 체크리스트

이 섹션은 프로젝트의 다양한 구성 요소에 대한 진행 상황 표 역할을 합니다. Git 버전에 따라 업데이트될 수 있습니다.

🔹 주요 소프트웨어 (Shell)

🔹 그래픽 인터페이스 (C++ / ImGui)

📦 설치

CLI 버전

1. 모든 외부 USB 장치를 분리하세요 (초기 whitelist에 포함할 장치는 제외).
2. .deb 패키지를 설치합니다 :
   root@kitploit:~

   sudo dpkg -i PortGuard_1.x.x.deb
   

기본 설정

설치 후 :

• WhiteList에는 장치가 없습니다.
• 자동 스캔은 기본적으로 활성화되지 않습니다. 애플리케이션을 실행하고 주 메뉴에서 수동으로 활성화해야 합니다.

WhiteList 관리

• 설정 파일 : /opt/port-guard/conf/usb-whitelist.conf
• 형식 : [USB] SERIAL=123456789 MODEL=USB_DISK_x
• 애플리케이션의 주 메뉴를 통해 장치를 추가, 삭제 또는 비울 수 있습니다.

제거

Port-Guard를 완전히 제거하려면 다음 옵션을 실행하세요 :

sudo portguard -u
# ou
sudo portguard --uninstall

이 절차는 :

• portguard.service 서비스를 중지하고 비활성화합니다.
• /opt/port-guard/에 있는 모든 애플리케이션 파일을 삭제합니다.
• 바이너리 /usr/local/bin/portguard를 삭제합니다.
• /usr/share/에 있는 데스크톱 파일과 아이콘을 삭제합니다.
• /usr/share/doc/port-guard/에 있는 시스템 문서를 삭제합니다.
• /tmp/에 WhiteList와 로그를 백업합니다.
• 실행 후 Port-Guard가 시스템에서 완전히 제거됩니다.