#### 2. 한 줄 부트스트랩

리포지토리를 `~/sunsetscan`에 클론하고 설치 프로그램을 실행합니다:```bash
curl -fsSL https://raw.githubusercontent.com/NoCoderRandom/sunsetscan/main/bootstrap.sh | bash

> **`curl | bash`에 대한 참고사항**: 편리하긴 하지만 읽어보지 않은 스크립트를 실행한다는 뜻입니다. 먼저 확인하고 싶다면 옵션 3 또는 4를 사용하세요.

#### 3. 클론 및 설치```bash
git clone https://github.com/NoCoderRandom/sunsetscan.git
cd sunsetscan
./install.sh

(`apt` 대신 자신의 배포판 패키지 관리자를 사용하세요 — `dnf`, `pacman`, `zypper`, 또는 `brew`. avahi 패키지는 Fedora/RHEL에서는 `avahi-tools`이고, Arch에서는 `avahi`, openSUSE에서는 `avahi-utils`이며, macOS에서는 필요하지 않습니다.)

### 설치 후 — 첫 실행```bash
./sunsetscan --setup                 # download EOL/CVE/credential databases (once)
sudo ./sunsetscan --instant          # ARP-only inventory of your local subnet
sudo ./sunsetscan --full-assessment --target 192.168.1.0/24

Two of SunsetScan's dependencies (`pysnmp` v6 in particular) need newer versions than the apt repositories ship, so a pure-apt install isn't possible. The installer's solution is the standard one: install system tools (nmap, masscan, libpcap, avahi-utils) via apt, and put SunsetScan's Python dependencies in a project-local `./venv` directory. Nothing system-wide is touched, so PEP 668 doesn't apply, and uninstalling SunsetScan is just `rm -rf ~/sunsetscan`.

### 선택 사항: SunsetScan을 백그라운드에서 계속 실행하기

Raspberry Pi에서 /24 서브넷에 대한 전체 평가는 10–30분이 걸릴 수 있습니다. SSH 연결이 끊겨도 스캔이 유지되도록 `tmux` 또는 `screen`을 사용하세요:```bash
sudo apt install -y tmux
tmux new -s sunsetscan
sudo ./sunsetscan --full-assessment --target 192.168.1.0/24
# Ctrl+B then D to detach. "tmux attach -t sunsetscan" to come back later.

### 제거```bash
rm -rf ~/sunsetscan
sudo rm -f /usr/local/bin/sunsetscan    # only if you used --symlink

다시 시작하고, 시작 메뉴에서 **Ubuntu**를 연 다음 위의 표준 설치 절차를 따르세요. WSL2는 가상 네트워크 어댑터를 사용합니다. 자동 감지가 잘못된 네트워크를 선택하면 `--target`으로 실제 서브넷을 전달하세요.

---

## 요구 사항

| 요구 사항 | 최소 | 참고 |
|---|---|---|
| **Python** | 3.9+ | 3.12 권장 |
| **nmap** | 최신 버전 | 시스템 PATH에 있어야 함 |
| **OS** | Linux (네이티브 또는 WSL2) | [플랫폼 지원](#platform-support) 참조 |
| **masscan** | 모든 버전 | 선택 사항 — 더 빠른 포트 검색 |
| **avahi-utils** | 모든 버전 | 선택 사항 — `avahi-browse`를 제공하며 Apple / Bonjour / Sleep-Proxy 장치의 안정적인 mDNS 검색에 사용됩니다. 없으면 python `zeroconf`로 대체됩니다. |
| **git** | 모든 버전 | 선택 사항 — `--setup` 및 `--update`에 사용됨 |
| **권한** | 일반 사용자 | FULL, STEALTH, SMB 프로파일, ARP 감지 및 수동 캡처에는 root/sudo 필요 |

---

## 빠른 시작```bash
# Interactive mode (recommended for first-time users)
sudo python3 sunsetscan.py -i

# Full security assessment with HTML report
sudo python3 sunsetscan.py --full-assessment --target 192.168.1.0/24

# Quick scan of your network
python3 sunsetscan.py --target 192.168.1.0/24

# IoT device scan (cameras, routers, smart devices)
python3 sunsetscan.py --target 192.168.1.0/24 --profile IOT

# Quick device inventory (no security checks)
python3 sunsetscan.py --identify --target 192.168.1.0/24

# Download all data modules for extended detection
python3 sunsetscan.py --download all

### 불량 장치 탐지
- 신뢰할 수 있는 기준선(baseline)으로 네트워크 스냅샷 저장
- 이후 스캔에서 기준선에 없는 알 수 없는 MAC 주소를 자동으로 플래그 지정
- 예상치 못한 IP 주소에서 감지된 알려진 장치 탐지

### 위험 점수 산정
모든 장치는 발견 항목의 심각도와 개수를 기준으로 위험 점수(0-100)를 받습니다:

| 점수 | 등급 |
|---|---|
| 0-10 | 최소 위험 |
| 11-30 | 낮은 위험 |
| 31-60 | 중간 위험 |
| 61-80 | 높은 위험 |
| 81-100 | 심각한 위험 |

### 보고
- **전문 HTML 보고서** — 심각도 대시보드, 호스트별 섹션, 평이한 영어 설명이 포함된 발견 카드, 우선순위별 권장 사항
- **JSON 내보내기** — 기계가 읽을 수 있는 구조화된 출력
- 보고서는 완전히 자체 포함됨 — HTML 파일 하나, 외부 의존성 없음
- SMB와 같은 좁은 프로필도 일치하는 서비스 포트가 열려 있지 않아도 발견된 호스트를 보고서에 계속 표시
- DNS, UPnP, 스캔 실행 시간 메모와 같은 네트워크 수준 검사는 장치별 발견 항목과 분리됨. 장치 위험 점수는 실제 호스트에 대해서만 표시됨
- 모든 발견 항목은 색상으로 구분됨: 심각, 높음, 중간, 낮음, 정보

### 스캔 기록 및 비교
- 모든 스캔은 gzip 압축 JSON 스냅샷으로 자동 저장됨
- `--history`로 과거 스캔 보기
- `--diff`로 두 스캔을 비교하여 새 호스트, 닫힌 포트, 신규/해결된 발견 항목 확인
- `--diff --since N`으로 N일 전의 스캔과 비교
- 기록은 기본적으로 90일간 보관됨

### 사용자 인터페이스
- 안내형 **대화형 모드** (`-i`) — 스캔, 분석, 내보내기, 모듈을 위한 다단계 메뉴
- **구식 메뉴** — 인수 없이 실행할 때 시작됨
- 직접 CLI 모드 — 스크립팅 및 자동화에 적합
- 진행률 표시줄, 스피너, 요약 패널이 포함된 풍부한 컬러 터미널 출력

---

## 모든 CLI 플래그

| 플래그 | 설명 | 루트 |
|---|---|---|
| `--target TARGET` | 스캔할 IP, CIDR 범위, 호스트명 또는 범위 | 아니요 |
| `--profile PROFILE` | 스캔 프로필: QUICK, FULL, STEALTH, PING, IOT, SMB (기본값: QUICK) | 다양함 |
| `-i`, `--interactive` | 안내형 대화형 모드 시작 | 아니요 |
| `--full-assessment` | 전체 평가 + 자동 HTML 내보내기. 자격 증명 감사는 옵트인 유지 | 아니요 |
| `--identify` | 장치 식별만 실행 (보안 검사 건너뜀) | 아니요 |
| `--nse` | 향상된 탐지를 위해 Nmap Scripting Engine 활성화 | 아니요 |
| `--check-defaults` | 잠금 방지 공장 기본 자격 증명 감사 옵트인 (소유 장치만) | 아니요 |
| `--save-baseline` | 불량 장치 탐지를 위해 스캔을 신뢰 장치 기준선으로 저장 | 아니요 |
| `--setup` | 최초 설정 마법사 (의존성 + 캐시 다운로드) | 아니요 |
| `--update-cache` | CVE 및 EOL 데이터 캐시 수동 새로 고침 | 아니요 |
| `--cache-status` | 캐시 수명과 항목 수를 표시한 후 종료 | 아니요 |
| `--modules` | 다운로드 가능한 모든 데이터 모듈의 상태 표시 | 아니요 |
| `--download MODULE` | 데이터 모듈 다운로드 (또는 "all") | 아니요 |
| `--db SIZE` | `--setup`용 EOL 데이터베이스 크기: mini, normal, large (기본값: normal) | 아니요 |
| `--history` | 스캔 기록 표를 표시하고 종료 | 아니요 |
| `--diff` | 마지막 두 저장 스캔을 비교하고 종료 | 아니요 |
| `--since DAYS` | `--diff`와 함께: 최소 N일 된 스캔과 비교 | 아니요 |
| `--check-version` | GitHub에서 최신 SunsetScan 릴리스 확인 | 아니요 |
| `--update` | GitHub에서 최신 코드를 가져와 요구 사항 재설치 | 아니요 |
| `--verbose` | 디버그 로깅 활성화 | 아니요 |
| `--no-color` | 색상 출력 비활성화 (로그 파일에 유용) | 아니요 |
| `--quiet` | 진행률 표시줄 숨기기 (발견 항목은 계속 표시) | 아니요 |
| `--safe-mode` | 보다 온화한 스캔 강제: 제한된 nmap, 낮은 masscan 사용, 더 적은 워커, 무거운 프로브 건너뜀 | 아니요 |
| `--no-safe-mode` | 자동 안전 모드 비활성화 | 아니요 |
| `--version` | 버전 번호를 표시하고 종료 | 아니요 |

---

## 스캔 프로필

| 프로필 | nmap 플래그 | 속도 | 루트 | 최적 용도 |
|---|---|---|---|---|
| **PING** | `-sn` | ~30초 | 아니요 | 활성 장치 빠르게 찾기 |
| **QUICK** | `-T4 -F -sV --version-intensity 2` | 1-3분 | 아니요 | 네트워크 첫 확인 (가벼운 버전 탐지 포함) |
| **FULL** | `-T4 -A -sV -O --osscan-guess` | 5-15분 | 예 | 특정 호스트 심층 분석 |
| **STEALTH** | `-sS -T2 -sV` | 10-30분 | 예 | 저소음 스캐닝 |
| **IOT** | `-T4 -sV -p 23,80,443,8080,8443,554,1900,5000,5001,7547,49152 --open` | 1-3분 | 아니요 | 카메라, 라우터, 스마트 기기 |
| **SMB** | `-T4 -sV -p 135,139,445,137,138 --script smb-security-mode,smb2-security-mode,smb-vuln-ms17-010 --open` | 1-3분 | 예 | Windows 공유, EternalBlue 확인 |

> **팁:** FULL 및 STEALTH는 sudo 없이 실행하면 자동으로 비루트 플래그로 대체됩니다. OS 탐지는 사용할 수 없지만 포트 스캐닝과 서비스 탐지는 계속 작동합니다.

### 기본 비밀번호 감사 안전

기본 비밀번호 테스트는 자동으로 활성화되지 않습니다. CLI 모드에서는
`--check-defaults`를 추가하고, 안내형 `-i` 모드에서는 프롬프트가 표시될 때
기본 비밀번호 감사를 선택하십시오. 그러면 SunsetScan은 보수적인 정책을 적용합니다:

- 기본적으로 일반적인 사용자 이름/비밀번호 스프레이를 수행하지 않음
- 감지된 공급업체 및 모델/계열과 일치하는 자격 증명만 테스트
- 많은 HP 프린터와 같이 고유 라벨/PIN 기본값을 가진 장치는 건너뜀
- 기본적으로 호스트당 2회, 서비스당 1회로 시도 제한
- 자격 증명이 포함된 시도 사이에 2초 대기
- 장치가 잠금 또는 속도 제한 신호를 반환하면 즉시 중지

내장 데이터베이스는 의도적으로 작고 출처 기반입니다. 다운로드한
대용량 자격 증명 모듈은 참조 데이터로 유지되지만, 개발자가
`Settings.auth_allow_module_credentials`를 명시적으로 활성화하지 않는 한
안전 감사에서는 이를 사용하지 않습니다.

### 안전 모드 및 검증 실행

안전 모드는 저전력 호스트, Pi-hole/게이트웨이 어플라이언스로 보이는 호스트,
Wi-Fi 이그레스(egress)에서 자동으로 권장됩니다. 다음으로 강제할 수도 있습니다:```bash
python3 sunsetscan.py --full-assessment --target 192.168.1.0/24 --safe-mode

기본적으로 PING, QUICK, SMB, STEALTH, FULL에 걸쳐 `192.168.1.0/24`를 테스트하고,
생성된 HTML 보고서를 validation 디렉터리로 복사한 다음, `reports/` 아래에 압축
아카이브를 작성합니다. 보고서, 로그, pcap, 아카이브는 git에서 무시되며,
커밋되어서는 안 됩니다.

유용한 오버라이드:```bash
sudo SUNSETSCAN_TARGETS="192.168.1.0/24" bash scripts/sudo_network_validation.sh
sudo SUNSETSCAN_PROFILES="PING QUICK FULL" bash scripts/sudo_network_validation.sh
sudo SUNSETSCAN_COMMAND_TIMEOUT=1200 bash scripts/sudo_network_validation.sh

스캔은 오래되었거나 누락된 캐시에서도 정상적으로 작동합니다 — 단지 CVE 데이터가 오래되었을 수 있습니다.

---

## 불량 장치 탐지```bash
# Step 1: Save baseline when all known devices are present
sudo python3 sunsetscan.py --target 192.168.1.0/24 --save-baseline

# Step 2: Future scans automatically compare against baseline
sudo python3 sunsetscan.py --target 192.168.1.0/24

이것은 배너 그래빙을 포함한 포트 스캔을 실행하고 장치 식별 테이블을
출력합니다. 보안 분석도, 보고서도 아닌 — 빠른
인벤토리일 뿐입니다.

### 증거 출처

| 소스 | 읽는 항목 | 신뢰도 |
|--------|--------------|------------|
| MAC OUI | MAC 주소의 IEEE 제조업체 접두사 | 0.40-0.45 |
| nmap OS | OS 핑거프린트 추측 | 다양함 |
| HTTP fingerprint | 웹 UI에서 얻은 장치 유형, 모델, 펌웨어 | 0.50+ |
| HTTP headers | Server, X-Powered-By 응답 헤더 | 0.20-0.50 |
| TLS certificate | CN, 발급자, 조직 필드 | 0.35 |
| SSH banner | SSH 데몬 식별 문자열 | 0.10-0.70 |
| UPnP | SSDP 제조업체, 모델, 장치 유형 | 0.75 |
| SNMP sysDescr | SNMP MIB의 시스템 설명 | 0.85 |
| Wappalyzer | CPE 문자열 및 기술 범주 | 0.30-0.45 |
| mDNS/Zeroconf | 서비스 유형 광고 | 0.55 |
| JA3S | TLS 핸드셰이크 핑거프린트 데이터베이스 | 0.50 |
| FTP banner | FTP 서버 소프트웨어 식별 | 0.25-0.35 |
| Port heuristics | 열린 포트 조합 패턴 | 0.10-0.70 |
| nmap services | 서비스 제품 및 버전 필드 | 0.45 |

식별 결과는 다음에 표시됩니다:
- 터미널 장치 인벤토리 테이블(스캔 중 및 `--identify` 사용 시)
- HTML 보고서 토폴로지 카드 및 장치 인벤토리 섹션
- JSON 내보내기 `device_identities` 섹션
- 대화형 모드 메뉴 옵션 [8] Device Inventory

---

## 심각도 수준

| 수준 | 색상 | CVSS 범위 | 의미 | 조치 시점 |
|---|---|---|---|---|
| **CRITICAL** | 빨강 | >= 9.0 | 기본 자격 증명, 악용 가능한 CVE, SSL 2.0 | 오늘 |
| **HIGH** | 주황 | 7.0-8.9 | Telnet/FTP 열림, 만료된 인증서, TLS 1.0, EOL 소프트웨어 | 이번 주 |
| **MEDIUM** | 노랑 | 4.0-6.9 | 자체 서명 인증서, UPnP 노출, 불량 장치, HSTS 누락 | 수정 일정 수립 |
| **LOW** | 파랑 | < 4.0 | EOL 임박, X-Frame-Options 누락, 장치 IP 변경됨 | 추적 및 계획 |
| **INFO** | 회색 | - | 장치 식별됨, 인증서 세부 정보, DNS 검사 통과 | 조치 없음 |

---

## 프로젝트 구조```
sunsetscan/
├── sunsetscan.py                    # Entry point — CLI, scan pipeline, setup wizard
├── requirements.txt               # Python dependencies
├── install.sh                     # Automated installer for Linux/macOS
├── install.bat                    # Automated installer for Windows (basic)
├── README.md                      # This file
│
├── config/
│   └── settings.py                # All constants, timeouts, scan profiles, menu options
│
├── core/
│   ├── scanner.py                 # nmap wrapper (ScanResult, HostInfo, PortInfo)
│   ├── port_scanner.py            # Masscan pipeline + PortScanOrchestrator
│   ├── banner_grabber.py          # Concurrent raw socket banner grabbing
│   ├── http_fingerprinter.py      # HTTP device/firmware fingerprinting
│   ├── nse_scanner.py             # Nmap Scripting Engine integration
│   ├── auth_tester.py             # Default credential testing (HTTP, device-specific)
│   ├── input_parser.py            # Flexible target format parsing
│   ├── network_utils.py           # Subnet detection, IP helpers, WSL detection
│   ├── findings.py                # Finding dataclass, Severity enum, FindingRegistry
│   ├── risk_scorer.py             # Per-device risk scoring (0-100)
│   ├── cache_manager.py           # Unified CVE + EOL cache (data/cache/)
│   ├── cve_checker.py             # CVE lookup + CVECacheBuilder (OSV.dev)
│   ├── ssl_checker.py             # TLS certificate, cipher suite, JA3S fingerprinting
│   ├── ssh_checker.py             # SSH version, algorithms, KEXINIT analysis
│   ├── smb_checker.py             # SMBv1, EternalBlue, shares, NTLM disclosure
│   ├── ftp_checker.py             # Anonymous FTP, STARTTLS
│   ├── snmp_checker.py            # SNMP community strings, sysDescr (pysnmp v4+v7)
│   ├── web_checker.py             # HTTP headers, admin panels, Wappalyzer
│   ├── dns_checker.py             # DNS hijack and rebinding detection
│   ├── upnp_checker.py            # SSDP discovery, UPnP risk assessment
│   ├── mdns_checker.py            # mDNS/Zeroconf device discovery
│   ├── arp_checker.py             # ARP spoofing detection
│   ├── device_identifier.py       # 14-source device identification engine
│   ├── identity_fusion.py         # Multi-source identity fusion and scoring
│   ├── oui_lookup.py              # IEEE OUI MAC vendor resolution
│   ├── device_map.py              # Persistent MAC→identity mapping
│   ├── passive_sniffer.py         # Background mDNS/SSDP/DHCP packet capture
│   ├── packet_parsers.py          # Protocol-specific packet parsing
│   ├── instant_scan.py            # ARP sweep + passive capture quick scan
│   ├── hybrid_scanner.py          # Passive+active scan orchestrator
│   ├── baseline.py                # Rogue device baseline comparison
│   ├── hardware_eol.py            # Downloaded hardware lifecycle database lookup
│   ├── scan_history.py            # Scan snapshot persistence and diffing
│   ├── module_manager.py          # Downloadable data module system
│   └── update_manager.py          # Version check and self-update
│
├── eol/
│   ├── checker.py                 # EOL API queries and version comparison
│   ├── cache.py                   # Per-product JSON cache
│   └── product_map.py             # 150+ software name -> lifecycle cache slug mappings
│
├── ui/
│   ├── menu.py                    # Old-style numbered menu (no-args mode)
│   ├── display.py                 # Rich terminal tables, progress bars, banners
│   ├── export.py                  # JSON and HTML report generation
│   ├── interactive_controller.py  # Interactive mode (-i) with multi-level menus
│   └── templates/
│       └── report.html.j2         # Jinja2 HTML report template
│
└── data/
    ├── default_credentials.json   # Factory-default credentials database
    ├── device_map.json            # Persistent MAC→identity map
    ├── baseline.json              # Saved device baseline (--save-baseline)
    ├── cache/
    │   ├── cve_cache.json         # CVE data keyed by product:version
    │   ├── <product>.json         # EOL data keyed by product slug
    │   ├── hardware_eol/          # Downloaded hardware lifecycle database
    │   └── cache_meta.json        # Cache update timestamps
    ├── history/                   # Gzip scan snapshots (auto-saved)
    └── modules/                   # Downloaded data modules

**권한 거부 / OS 탐지가 작동하지 않음**

FULL, STEALTH, SMB 프로파일에는 상승된 권한이 필요합니다. root 권한이 없으면 이러한 프로파일은 자동으로 비-root 플래그로 대체됩니다(OS 탐지 및 SYN 스캔이 비활성화되지만 포트/버전 스캐닝은 여전히 작동합니다).```bash
# For full capabilities:
sudo python3 sunsetscan.py --target 192.168.1.0/24 --profile FULL

**스캔 시작 시 캐시 경고**```
WARNING: CVE data is 12 days old — run: python sunsetscan.py --update-cache

**SNMP 검사가 작동하지 않음**

SunsetScan은 pysnmp v4(동기식)와 v7(비동기식)을 모두 지원합니다. import 오류가 표시되면 pysnmp를 업데이트하세요:```bash
pip install --upgrade pysnmp