선호 네트워크 목록 스니퍼 - PNLS

선호 네트워크 목록 스니퍼(PNLS)는 간단한 웹 인터페이스를 갖춘 레드팀 Wi-Fi 감사 도구로, 장치의 선호 네트워크 목록(PNL)[^2]에서 SSID[^1]를 가로챌 수 있습니다. 이는 주변의 프로브 요청을 스니핑하여 SSID 및 기타 정보를 파싱한 후 최종적으로 웹 UI에 전파함으로써 이루어집니다. 이 프로젝트의 주요 동기는 802.11 프로브 요청과 이들이 전송하는 데이터와 관련된 개인정보 위험을 조사하는 것이었습니다.

PNLS system overview

그림 1: PNLS 시스템 개요

[!WARNING] 이 프로젝트의 모든 내용은 보안 연구 목적으로만 제공됩니다.

[!NOTE]

이 프로젝트는 Wi-Fi 네트워크에서의 개인정보 보호에 대한 진행 중인 연구의 일부입니다.

작업 범위 발표

PNLS의 진행 상황을 확인하려면 프로젝트 보드를 참조하세요.

PNLS 구축 방법

이 프로젝트를 복제하고 배포하는 데 필요한 하드웨어 및 소프트웨어 구성 요소는 다음과 같습니다. 작업 환경이 준비되면 설정 섹션으로 이동하세요.

요구 사항

라즈베리 파이 (RPi)
적합한 RPi 전원 공급 장치 (자세한 내용은 전원 공급 장치 문서 참조)
마이크로 SD 카드 (자세한 내용은 SD 카드 문서 참조)
USB Wi-Fi 어댑터 (선택 사항)
- 패킷 캡처 시 더 넓은 범위를 확보하는 데 사용됩니다.
HDMI 케이블 (선택 사항)
- 컴퓨터로 원격 연결하는 대신 RPi에서 웹 UI를 표시하는 데 사용됩니다.

사전 준비 사항

Kali Linux OS
- 모니터링 모드와 aircrack-ng 도구를 사용하는 데 필요합니다. Kali Linux ARM 이미지는 여기에서 다운로드할 수 있습니다.
  - 또는 다른 OS를 사용할 수도 있지만, nexmon[^4]을 사용하여 커널을 패치[^3]하거나 모니터링 모드를 지원하는 무선 어댑터를 사용해야 합니다. 라즈베리 파이에서 지원되는 USB 어댑터 목록은 이 링크를 참조하세요.
  - 또한 aircrack-ng 도구를 설치해야 합니다. 이 도구는 Kali Linux에만 사전 설치되어 있습니다.
네트워크 인터페이스를 모니터링 모드로 시작하세요: sudo airmon-ng start wlan0 [2].

[!NOTE]

Kali 이미지는 Re4son의 커널을 사용하며, 여기에는 외부 Wi-Fi 카드용 드라이버와 RPi 3 및 4의 내장 무선 카드용 Nexmon 펌웨어가 포함되어 있습니다 [3].

PNLS RPi 4 device

그림 2: 외부 안테나와 보조 배터리를 사용하는 RPi 4에서 실행 중인 PNLS

PNLS RPi 4 device AWUS036ACS

그림 3: AWUS036ACS 안테나가 있는 케이스를 사용하는 RPi 4에서 실행 중인 PNLS

PNLS RPi 4 device AWUS036ACM

그림 4: AWUS036ACM 안테나를 사용하는 RPi 4에서 실행 중인 PNLS

설정

Docker를 사용하지 않으려면 Docker 없이 설정하기로 이동하세요.

Docker 사용

개발 인스턴스를 빠르게 설정하세요:

# First clone this repo.
git clone https://github.com/AleksaMCode/Preferred-Network-List-Sniffer.git
# Move to the project root folder.
cd Preferred-Network-List-Sniffer
# Build backend and frontend image.
docker compose build
# Bring up both the backend and the frontend server.
docker compose up
# Move into the sniffer folder.
cd sniffer
# Run the Sniffer service.
sudo python3 sniffer.py

사전 빌드 Docker 이미지 사용

현재 다중 플랫폼 이미지는 제공되지 않으며, 프로젝트는 ARM64v8 아키텍처만 지원합니다. GitHub Container Registry에서 최신 사전 빌드 이미지를 다운로드하여 로컬에서 실행하세요.

# First clone this repo.
git clone https://github.com/AleksaMCode/Preferred-Network-List-Sniffer.git
# Move to the project root folder.
cd Preferred-Network-List-Sniffer
# Download the prebuild images.
docker pull ghcr.io/aleksamcode/pnls-backend-ghcr:latest
docker pull ghcr.io/aleksamcode/pnls-frontend-ghcr:latest
# Bring up both the backend and the frontend server.
docker compose up
# Move into the sniffer folder.
cd sniffer
# Run the Sniffer service.
sudo python3 sniffer.py

Docker 없이

백엔드: ASGI 및 Redis 서버를 시작하고 필요한 서비스를 실행하려면 이 지침을 참조하세요.
프론트엔드: React 서버를 실행하려면 이 지침을 참조하세요.

다음은 모든 것을 '수동으로' 실행했을 때의 스크린샷입니다:

왼쪽 상단: Redis 서버
오른쪽 상단: ASGI 서버
왼쪽 하단: Sniffer 서비스
오른쪽 하단: React 서버

PNLS Kali screenshot

그림 5: PNLS 스크린샷

프로브 요청

프로브 요청은 장치를 이전에 연결했던 무선 액세스 포인트(AP)에 연결하는 데 사용되는 관리 802.11 프레임입니다. 장치에서 Wi-Fi가 활성화되어 있지만 네트워크에 연결되어 있지 않을 때마다 PNL의 SSID가 포함된 프로브 요청 버스트를 주기적으로 전송합니다. 이러한 프레임은 암호화되지 않은 상태로 전송되며, 무선 주파수(RF)를 모니터링하는 사람이라면 누구나 캡처하여 읽을 수 있습니다. 프로브는 브로드캐스트 DA 주소(ff:ff:ff:ff:ff:ff)로 전송됩니다. 전송 후 장치는 프로브 타이머를 시작합니다. 타이머가 끝나면 장치는 수신된 응답을 처리합니다. 응답을 받지 못하면 다음 채널로 이동하여 과정을 반복합니다. 프로브 요청에는 두 가지 유형이 있습니다:

지정 프로브 요청: 장치 PNL의 특정 SSID 사용
널 프로브 요청: 와일드카드 SSID (빈 SSID) 사용

빈 요청은 범위 내에 있는 모든 사용 가능한 AP로부터 응답을 받기 위해 전송됩니다.
캡처된 모든 패킷에서 802.11 프로브 요청 프레임을 필터링하는 것 외에도 Sniffer는 와일드카드 SSID도 필터링합니다.

SSID 필터링

많은 Wi-Fi 클라이언트가 있는 대규모 로컬 네트워크가 있는 장소에서 프로브 요청을 캡처할 때 PNLS는 필연적으로 해당 네트워크의 SSID를 포함하는 많은 프로브 요청을 캡처하게 됩니다. 이러한 SSID는 우리에게 가치가 없으며 소켓 부하를 증가시킬 수 있으므로 필터링하는 것이 유리할 수 있습니다. 이러한 SSID를 필터링하면 소켓 연결 부하를 줄일 뿐만 아니라 웹 UI에서 해당 SSID가 스팸되는 것을 방지할 수 있습니다.

이 기능을 사용할 때는 소스 코드를 약간 수정해야 합니다. 정확히는 settings.py 파일의 SSID_FILTER 목록을 Sniffer가 무시하려는 값으로 업데이트해야 합니다. 업데이트 후 프로젝트를 다시 빌드하고 PNLS를 시작하세요.

Preferred-Network-List-Sniffer

인기