#### 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

Две зависимости SunsetScan (в частности, `pysnmp` v6) требуют более новых версий, чем те, что поставляются в репозиториях apt, поэтому чистая установка через apt невозможна. Решение установщика стандартное: установить системные инструменты (nmap, masscan, libpcap, avahi-utils) через apt, а зависимости Python для SunsetScan поместить в локальную для проекта директорию `./venv`. Никакие системные компоненты не затрагиваются, поэтому PEP 668 не применяется, а удаление SunsetScan сводится к `rm -rf ~/sunsetscan`.

### Опционально: оставить SunsetScan работающим в фоновом режиме

Полная оценка подсети /24 на Raspberry Pi может занять 10–30 минут. Используйте `tmux` или `screen`, чтобы сканирование не прервалось при отключении SSH:```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 |
| **ОС** | Linux (нативный или WSL2) | См. [Поддержка платформ](#platform-support) |
| **masscan** | Любая | Опционально — более быстрое обнаружение портов |
| **avahi-utils** | Любая | Опционально — предоставляет `avahi-browse`, используется для надежного обнаружения устройств Apple / Bonjour / Sleep-Proxy через mDNS. При отсутствии использует python `zeroconf` вместо этого. |
| **git** | Любая | Опционально — используется для `--setup` и `--update` |
| **Привилегии** | Обычный пользователь | Root/sudo необходимы для профилей FULL, STEALTH, SMB, ARP-обнаружения и пассивного захвата |

---

## Быстрый старт```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

### Обнаружение неавторизованных устройств
- Сохраните снимок вашей сети как доверенный базовый профиль
- Будущие сканирования автоматически помечают неизвестные MAC-адреса, отсутствующие в базовом профиле
- Обнаруживает известные устройства на неожиданных IP-адресах

### Оценка риска
Каждое устройство получает оценку риска (0–100) на основе серьёзности и количества обнаруженных проблем:

| Оценка | Уровень |
|---|---|
| 0–10 | Минимальный риск |
| 11–30 | Низкий риск |
| 31–60 | Средний риск |
| 61–80 | Высокий риск |
| 81–100 | Критический риск |

### Отчёты
- **Профессиональный HTML-отчёт** — панель серьёзности, секции по каждому хосту, карточки с проблемами с пояснениями на простом английском, расставленные по приоритетам рекомендации
- **Экспорт в JSON** — машиночитаемый структурированный вывод
- Отчёты полностью самодостаточны — один HTML-файл, без внешних зависимостей
- Узкие профили, такие как SMB, сохраняют найденные хосты в отчёте, даже если соответствующие порты служб не открыты
- Проверки сетевого уровня, такие как DNS, UPnP и примечания о времени выполнения сканирования, отделены от обнаружений по каждому устройству; оценки риска устройств отображаются только для реальных хостов
- Все обнаружения имеют цветовую маркировку: Критический, Высокий, Средний, Низкий, Информационный

### История сканирования и сравнение
- Каждое сканирование автоматически сохраняется как gzip-сжатый JSON-снимок
- Просмотр прошлых сканирований с помощью `--history`
- Сравнение любых двух сканирований с помощью `--diff` для выявления новых хостов, закрытых портов, новых/решённых проблем
- Сравнение со сканированием N дней назад с помощью `--diff --since N`
- История хранится 90 дней по умолчанию

### Пользовательский интерфейс
- **Интерактивный режим с подсказками** (`-i`) — многоуровневые меню для сканирования, анализа, экспорта, модулей
- **Меню старого стиля** — запускается при вызове без аргументов
- Прямой режим CLI — пригодный для скриптов и автоматизации
- Богатый цветной терминальный вывод с индикаторами прогресса, спиннерами и сводными панелями

---

## Все флаги CLI

| Флаг | Описание | Root |
|---|---|---|
| `--target TARGET` | IP-адрес, диапазон CIDR, имя хоста или диапазон для сканирования | Нет |
| `--profile PROFILE` | Профиль сканирования: QUICK, FULL, STEALTH, PING, IOT, SMB (по умолч.: QUICK) | Зависит |
| `-i`, `--interactive` | Запустить интерактивный режим с подсказками | Нет |
| `--full-assessment` | Полная оценка + автоэкспорт HTML; проверка учётных данных остаётся добровольной | Нет |
| `--identify` | Запустить только идентификацию устройств (пропустить проверки безопасности) | Нет |
| `--nse` | Включить скриптовый движок Nmap для улучшенного обнаружения | Нет |
| `--check-defaults` | Добровольное участие в безопасной проверке заводских учётных данных (только собственные устройства) | Нет |
| `--save-baseline` | Сохранить сканирование как доверенный базовый профиль устройств для обнаружения неавторизованных | Нет |
| `--setup` | Мастер первоначальной настройки (зависимости + загрузка кэша) | Нет |
| `--update-cache` | Вручную обновить кэши данных CVE и EOL | Нет |
| `--cache-status` | Показать возраст кэша и количество записей, затем выйти | Нет |
| `--modules` | Показать статус всех загружаемых модулей данных | Нет |
| `--download MODULE` | Загрузить модуль данных (или «all») | Нет |
| `--db SIZE` | Размер базы данных EOL для `--setup`: mini, normal, large (по умолч.: normal) | Нет |
| `--history` | Показать таблицу истории сканирований и выйти | Нет |
| `--diff` | Сравнить два последних сохранённых сканирования и выйти | Нет |
| `--since DAYS` | С `--diff`: сравнить со сканированием возрастом не менее N дней | Нет |
| `--check-version` | Проверить наличие новой версии SunsetScan на GitHub | Нет |
| `--update` | Загрузить последний код с GitHub и переустановить зависимости | Нет |
| `--verbose` | Включить отладку логирования | Нет |
| `--no-color` | Отключить цветной вывод (полезно для файлов журнала) | Нет |
| `--quiet` | Подавить индикаторы прогресса (обнаружения по-прежнему отображаются) | Нет |
| `--safe-mode` | Принудительно включить щадящее сканирование: ограниченный nmap, сниженное использование masscan, меньше рабочих процессов, пропуск тяжёлых зондов | Нет |
| `--no-safe-mode` | Отключить автоматический безопасный режим | Нет |
| `--version` | Показать номер версии и выйти | Нет |

---

## Профили сканирования

| Профиль | Флаги nmap | Скорость | Root | Лучше всего подходит для |
|---|---|---|---|---|
| **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 автоматически переходят на флаги, не требующие прав root, при запуске без sudo. Определение ОС будет недоступно, но сканирование портов и обнаружение служб всё ещё работают.

### Безопасность проверки заводских паролей

Проверка заводских паролей никогда не включается автоматически. В режиме CLI добавьте `--check-defaults`; в интерактивном режиме `-i` выберите проверку заводских паролей при запросе. SunsetScan затем применяет консервативную политику:

- нет массовой проверки общих имён пользователей/паролей по умолчанию
- тестируются только учётные данные, соответствующие обнаруженному производителю и модели/семейству
- пропускаются устройства с уникальными метками/PIN по умолчанию, например, многие принтеры HP
- количество попыток ограничено: не более 2 на хост и 1 на службу по умолчанию
- между попытками с учётными данными выдерживается пауза в 2 секунды
- немедленно останавливается, если устройство возвращает сигналы блокировки или ограничения скорости

Встроенная база данных намеренно мала и основана на источниках. Загруженные крупные модули учётных данных сохраняются как справочные, но безопасная проверка не использует их, если `Settings.auth_allow_module_credentials` явно не включён разработчиком.

### Безопасный режим и проверочные запуски

Автоматический безопасный режим рекомендуется на маломощных хостах, хостах, напоминающих Pi-hole/шлюзы, а также при выходе через Wi-Fi. Также может быть принудительно включён с помощью:```bash
python3 sunsetscan.py --full-assessment --target 192.168.1.0/24 --safe-mode

По умолчанию он тестирует `192.168.1.0/24` через PING, QUICK, SMB, STEALTH и FULL, копирует сгенерированные HTML-отчеты в каталог проверки и записывает сжатый архив в `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 | Префикс вендора IEEE из MAC-адреса | 0.40-0.45 |
| nmap OS | Предположение отпечатка ОС | varies |
| HTTP fingerprint | Тип устройства, модель, прошивка из веб-интерфейса | 0.50+ |
| HTTP заголовки | Заголовки ответов Server, X-Powered-By | 0.20-0.50 |
| TLS сертификат | Поля CN, issuer, organization | 0.35 |
| SSH баннер | Строка идентификации демона SSH | 0.10-0.70 |
| UPnP | Производитель SSDP, модель, тип устройства | 0.75 |
| SNMP sysDescr | Системное описание из MIB SNMP | 0.85 |
| Wappalyzer | CPE-строки и категории технологий | 0.30-0.45 |
| mDNS/Zeroconf | Объявления типов служб | 0.55 |
| JA3S | База данных отпечатков рукопожатия TLS | 0.50 |
| FTP баннер | Идентификация программного обеспечения FTP-сервера | 0.25-0.35 |
| Портовая эвристика | Шаблоны комбинаций открытых портов | 0.10-0.70 |
| nmap services | Поля продукта и версии службы | 0.45 |

Результаты идентификации отображаются в:
- Таблица инвентаризации устройств в терминале (во время сканирования и через `--identify`)
- Карточки топологии в HTML-отчете и раздел инвентаризации устройств
- Раздел `device_identities` в JSON-экспорте
- Пункт меню интерактивного режима [8] Инвентаризация устройств

---

## Уровни серьезности

| Уровень | Цвет | Диапазон CVSS | Значение | Когда действовать |
|---|---|---|---|---|
| **КРИТИЧЕСКИЙ** | Красный | >= 9.0 | Учетные данные по умолчанию, эксплуатируемая CVE, SSL 2.0 | Сегодня |
| **ВЫСОКИЙ** | Оранжевый | 7.0-8.9 | Открыты Telnet/FTP, просрочен сертификат, TLS 1.0, устаревшее ПО | На этой неделе |
| **СРЕДНИЙ** | Жёлтый | 4.0-6.9 | Самоподписанный сертификат, открыт UPnP, подозрительное устройство, отсутствует HSTS | Запланировать исправление |
| **НИЗКИЙ** | Синий | < 4.0 | Приближение окончания поддержки, отсутствует X-Frame-Options, изменён IP устройства | Отслеживать и планировать |
| **ИНФОРМАЦИОННЫЙ** | Серый | - | Устройство идентифицировано, детали сертификата, проверка 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 detection не работает**

FULL, STEALTH и SMB профили требуют повышенных привилегий. Без root эти профили автоматически переходят на non-root флаги (OS detection и SYN scan отключены, но сканирование портов/версий все еще работает).```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 (асинхронный). Если вы видите ошибки импорта, обновите pysnmp:```bash
pip install --upgrade pysnmp