diff --git a/LICENSE b/LICENSE
@@ -1,4 +1,4 @@
-AP Scanner - WiFi Access Point Scanner
+UAF (Ultimate AP Finder) - WiFi Access Point Scanner
Copyright (C) 2026
This program is free software; you can redistribute it and/or modify
diff --git a/README.md b/README.md
@@ -1,48 +1,58 @@
-# AP Scanner
+# UAF — Ultimate AP Finder
-Real-time wireless access point scanner with active reconnaissance for Linux.
+PCI-DSS 무선 보안 감사 대응을 위한 Linux 기반 AP 탐지 및 분석 도구.
+
+## Why UAF?
+
+기업 환경에서 PCI-DSS(Payment Card Industry Data Security Standard) 인증을 대응하다 보면 **무선 AP 취약점 점검** 항목을 마주하게 됩니다. 인가된 AP와 비인가(Rogue) AP를 식별하고, 오픈 네트워크나 취약한 암호화를 사용하는 AP를 탐지해야 합니다.
+
+기존 도구들은 단순 스캔에 그치거나, 능동적 정찰이 불가능하거나, 기업 감사 보고서에 바로 활용할 수 있는 출력 포맷을 제공하지 않았습니다.
+
+**UAF**는 이 문제를 해결하기 위해 만들어졌습니다:
+
+- 주변 전체 AP를 실시간으로 수집하고, 보안 설정(암호화/인증/WPS)을 자동 분류
+- 오픈(OPN) AP를 시각적으로 강조하여 즉시 식별
+- 의심스러운 AP에 직접 접속해 네트워크 구조(DHCP, 게이트웨이, 클라이언트)까지 파악
+- 결과를 CSV/JSON으로 내보내 감사 보고서에 바로 활용
+
+---
## Features
### Passive Scanning
-- Real-time AP discovery with terminal display
-- Automatic channel hopping (2.4GHz / 5GHz / 6GHz)
-- Security detection: WEP, WPA, WPA2, WPA3
-- WiFi standard detection: 802.11 a/b/g/n/ac/ax
-- Channel width detection (20/40/80/160 MHz)
-- Hidden SSID detection and resolution
-- MAC vendor lookup
-- Band filtering and sort modes
-
-### Active Scanning (New!)
-- Interactive AP selection with arrow keys
-- Connect to open (OPN) networks for reconnaissance
-- DHCP lease acquisition and network info extraction
-- ARP scan to discover connected clients
-- Gateway port scanning (22, 53, 80, 443, 8080, 8443)
-- Client device enumeration with MAC vendor lookup
-- Results displayed in overlay panel
-
-### Export & Configuration
-- CSV / JSON export with active scan results
-- Configuration file support
+- 2.4GHz / 5GHz / 6GHz 전 대역 실시간 AP 탐지
+- 보안 분류: WEP, WPA, WPA2, WPA3, OPN
+- 802.11 a/b/g/n/ac/ax 표준 탐지
+- 채널 폭 탐지 (20/40/80/160 MHz)
+- Hidden SSID 탐지 및 복원
+- MAC 벤더 조회
+- 대역/정렬 필터링
+
+### Active Scanning
+- 화살표 키로 AP 선택하는 인터랙티브 UI
+- 오픈(OPN) AP 접속 후 능동 정찰
+- DHCP 정보 수집, ARP 스캔으로 연결 클라이언트 탐지
+- 게이트웨이 포트 스캔 (22, 53, 80, 443, 8080, 8443)
+- 결과 오버레이 패널로 즉시 확인
+
+### Export
+- CSV / JSON 내보내기 (능동 스캔 결과 포함)
+- 설정 파일 지원
+
+---
## Requirements
- Python 3.10+
-- Linux with `iw` and `ip` commands
-- Root privileges
-- WiFi adapter that supports monitor mode
+- Linux (`iw`, `ip` 명령어)
+- Root 권한
+- Monitor 모드 지원 WiFi 어댑터
## Installation
-### From PyPI (recommended)
+### From PyPI
```bash
-# Using pipx (isolated environment)
-pipx install uaf
-
-# Or using pip
pip install uaf
```
@@ -54,37 +64,28 @@ cd uaf
pip install -e .
```
-### Ubuntu/Debian (.deb package)
-
-```bash
-# Download from releases
-wget https://github.com/devastator-x/uaf/releases/download/v1.0.0/uaf_1.0.0_all.deb
-sudo dpkg -i uaf_1.0.0_all.deb
-sudo apt-get install -f # Install dependencies
-```
-
## Usage
```bash
-# Basic scan (auto-detect interface)
+# 기본 스캔 (인터페이스 자동 탐지)
sudo uaf
-# Specify interface
+# 인터페이스 지정
sudo uaf -i wlan0
-# Scan specific channels
+# 특정 채널만 스캔
sudo uaf -c 1,6,11
-# Band filter
+# 대역 필터
sudo uaf -b 2.4
-# Sort by channel
+# 정렬 기준 변경
sudo uaf --sort channel
-# Save to specific file
+# CSV로 저장
sudo uaf -w output.csv
-# Use config file
+# 설정 파일 사용
sudo uaf --config /path/to/config.ini
```
diff --git a/ap_scanner/__init__.py b/ap_scanner/__init__.py
@@ -1,3 +1,3 @@
-"""AP Scanner - airodump-ng style wireless AP scanner."""
+"""UAF (Ultimate AP Finder) - wireless AP scanner for PCI-DSS auditing."""
__version__ = "1.0.1"
diff --git a/ap_scanner/cli.py b/ap_scanner/cli.py
@@ -8,8 +8,8 @@ from ap_scanner import __version__
def parse_args(argv: list[str] | None = None) -> argparse.Namespace:
"""Parse command-line arguments."""
parser = argparse.ArgumentParser(
- prog="ap-scanner",
- description="Real-time wireless AP scanner for Linux",
+ prog="uaf",
+ description="UAF (Ultimate AP Finder) - wireless AP scanner for PCI-DSS auditing",
)
parser.add_argument(
"-V", "--version",
diff --git a/ap_scanner/display.py b/ap_scanner/display.py
@@ -5,6 +5,7 @@ import sys
import unicodedata
from datetime import datetime, timedelta
+from ap_scanner import __version__
from ap_scanner.models import AccessPoint
@@ -187,7 +188,7 @@ class Display:
band_str = f"Band: {self.band_filter or 'all'}"
sort_str = f"Sort: {self.sort_field}"
header_text = (
- f" AP Scanner v1.0 | {interface} | Monitor | "
+ f" UAF v{__version__} | {interface} | Monitor | "
f"CH: {current_channel:<3} | {elapsed_str} | "
f"{band_str} | {sort_str}"
)
diff --git a/pyproject.toml b/pyproject.toml
@@ -1,7 +1,7 @@
[project]
name = "uaf"
version = "1.0.1"
-description = "Real-time wireless AP scanner with active reconnaissance for Linux"
+description = "UAF (Ultimate AP Finder) - wireless AP scanner for PCI-DSS auditing"
requires-python = ">=3.10"
license = {text = "GPL-2.0-or-later"}
readme = "README.md"
|