Naze

• 🇯🇵 Закон о запрете несанкционированного доступа к компьютерам (Закон о запрете незаконного доступа к компьютерам)

Три механизма точности

Традиционная автоматизация работает по принципу «отправить все шаблоны → утонуть в ложных срабатываниях → разбирать вручную». Naze использует трёхуровневый подход. Эти механизмы единообразно применяются ко всем областям тестирования: веб, AD, инфраструктура, облака и LLM.

Механизм 1 — Пошаговый цикл «гипотеза — проверка» (pt-verify)

На каждом этапе (разведка / обнаружение / гипотеза / тест) выполняется подцикл наблюдение → вывод → дешёвая проверка → вердикт. Строгое разделение наблюдения и вывода не позволяет ошибочным выводам проникнуть на последующие этапы.

observation (alive_hosts.json, endpoints.json, ad_enum.json, …)
    ↓
inference   ("this is a multi-tenant SaaS", "this endpoint is an IDOR candidate",
             "this DC is Kerberoastable")
    ↓
cheap-verify (grep existing artefacts + at most a lightweight HEAD)
    ↓
verdict = confirmed / refuted / unknown

Если не обнаруживать ошибочные выводы на ранней стадии, последующие тесты тратят циклы на ложные срабатывания. Дешёвая проверка использует только регулярные выражения по уже собранным данным и максимум 1–2 HEAD-запроса, поэтому стоимость стремится к нулю, но точность заметно возрастает.

Механизм 2 — Оракул крахов в стиле Mythos (pt-oracle)

Субъективность LLM исключена; каждый вердикт о наличие уязвимости определяется машинно-решаемыми булевыми критериями. Это главная причина, по которой Mythos достиг 100% на Cybench и самостоятельно обнаружил CVE-2026-4747 (RCE в FreeBSD возрастом 17 лет) — «используй Address Sanitizer как идеальный оракул крахов». Naze переносит этот принцип в тестирование веба, инфраструктуры, AD и облаков.

Каждый тип уязвимости определяет три группы сигналов:

required_signals:     # all true → confirmed
  - evaluator: timing_delta
    criterion: (timing_probe - baseline) in [4000, 7000] ms
  - evaluator: body_grep
    criterion: matches /You have an error in your SQL syntax/

refutation_signals:   # any true → refuted
  - evaluator: http_status
    criterion: status in [403, 406] and body contains "WAF"

inconclusive_signals: # neither refuted nor confirmed → refine
  - evaluator: http_status
    criterion: status in [500] and body unclear

Встроенные оракулы — Веб

Встроенные оракулы — Инфраструктура / AD / Облака

Механизм 3 — Итеративный цикл уточнения (pt-refine)

Когда оракул возвращает inconclusive, Naze эволюционирует полезную нагрузку до 4 раз в рамках одной гипотезы. Именно поэтому Mythos достиг 83% успешности PoC с первой попытки.

iter 1 (Tier 1: Canonical)
    <svg/onload=alert(nz7a)>
    → oracle: inconclusive (HTML-entity escape)
        ↓
iter 2 (Tier 2: Encoding)
    %3Csvg%2Fonload%3Dalert(nz7a)%3E
    → oracle: inconclusive (WAF block)
        ↓
iter 3 (Tier 3: Filter bypass / polyglot)
    jaVasCript:/*-/*`/*...(polyglot payload)
    → oracle: CONFIRMED ✓
        ↓
pt-poc auto-generates a PoC → finding recorded

Правила каждого уровня находятся в references/refinement_strategies/<vuln_type>_refinement.md. Сигнал опровержения предыдущей итерации используется для выбора следующего уровня — например, вердикт waf_blocks_payload пропускает Уровень 2 и переход к Уровню 3.

Бонус — Автогенерация PoC (pt-poc)

Каждая подтверждённая гипотеза генерирует четыре файла в findings/<FIND-ID>/poc/:

Данные жертвы хранятся как плейсхолдеры ({VICTIM_USER_ID} и т.д.), чтобы PoC можно было безопасно отправлять в отчёте об ответственном раскрытии.

Применение

1. Веб-багбаунти

/scope my-h1-program          # engagement_type=external, scope=example.com
/engage example.com

Разведка → Обнаружение → Гипотеза → Тест (Оракул-Уточнение-PoC) → Отчёт.

2. Внутренний пентест AD

/scope internal-2026q2        # engagement_type=internal, CIDR specified
/engage 192.168.10.0/24 --engagement-type internal

nmap + перечисление SMB/LDAP/Kerberos → загрузка графа BloodHound → Kerberoasting, векторы атак ADCS, принудительная аутентификация, аудит парольной политики → консолидированный findings.json.

3. Обзор облачной конфигурации (AWS)

/scope aws-review-2026
/engage my-aws-account --engagement-type cloud

scripts/recon/cloud/aws_enum.sh перечисляет IAM-политики, доступность S3, группы безопасности, поверхность Lambda — затем генерирует и проверяет гипотезы в отношении уязвимых конфигураций.

4. Пост-эксплуатация (демонстрация влияния)

/post-exploit internal-2026q2 FIND-001

В отношении подтверждённой находки RCE, без разрушения, перечисляется доступная внутренняя сеть, инвентаризируются доступные серверы БД и оценивается объём доступных PII. scripts/post-exploit/pivot_mapper.sh документирует горизонтальные пути (без их выполнения).

5. Аудит соответствия (PCI-DSS)

/compliance internal-2026q2 --framework pci-dss

Сопоставляет существующие находки с каждым требованием PCI-DSS v4.0 и генерирует отчёт об анализе пробелов. Используйте --framework all для охвата OWASP + PCI + NIST + SOC 2 за один проход.

6. Тестирование безопасности LLM-приложений

/engage chatbot.example.com --engagement-type external
# discovery-agent identifies /chat, /complete as AI endpoints
# → llm-tester runs → verdict via prompt_injection_oracle

Утечка системного промпта, косвенная инъекция, злоупотребление инструментами. Поскольку LLM являются вероятностными, подтверждённый вердикт требует ≥ 2 / 3 воспроизведений.

Быстрый старт

0. Клонируйте проект и установите переменную окружения корневого каталога

git clone https://github.com/nano-ctf/bb-hunter.git naze
cd naze
export NAZE_ROOT=$(pwd)
# Open this directory in Claude Code.
# Persist the export in ~/.bashrc or ~/.zshrc.

Критически важно: NAZE_ROOT используется каждой командой, навыком и агентом. Скрипты не будут работать, если она не установлена.

1. Установите инструменты

/install-tools

Устанавливает 25+ инструментов за один раз (Веб / AD / Инфра / Облака / Пост-эксплуатация). См. Перечень инструментов.

2. Настройте область и взаимодействие

/scope <engagement_id>

Интерактивно записывает активы, engagement_type, rules_of_engagement.prohibited_actions, лимиты запросов и учётные данные тестовых аккаунтов. hooks/scope-guard.sh автоматически блокирует трафик за пределами области.

3. Запустите полный конвейер

/engage <target>

Результаты записываются в workspace/programs/<target>/ или workspace/engagements/<engagement_id>/.

4. Отдельные фазы (отладка / возобновление)

/recon <target>              # recon only
/hypothesis <target>         # hypothesis generation only (expects recon artefacts)
/test HYP-001                # test a single hypothesis (Oracle-Refine-PoC loop)
/report <target>             # generate report
/post-exploit <id> FIND-xxx  # post-exploit a confirmed finding
/compliance <id>             # compliance mapping

Справочник команд

Всё включено по умолчанию. Эти флаги отключают опции:

Инвентарь инструментов

Устанавливаются через /install-tools:

Структура каталогов

naze/
├── CLAUDE.md                    # Global Claude Code operating rules
├── README.md / README_JP.md
├── commands/                    # /xxx command definitions (12)
├── skills/                      # pt-xxx skills (14)
├── agents/                      # specialist agents (12)
├── references/
│   ├── attack_patterns/
│   ├── app_archetypes/
│   ├── chain_templates/
│   ├── ai_llm_patterns/
│   ├── oracles/                 # ★ crash-oracle definitions (Web 14, Infra/AD/Cloud 5)
│   ├── refinement_strategies/   # ★ payload-evolution tiers
│   ├── poc_templates/           # ★ PoC generation templates
│   ├── verify/                  # ★ cheap_check dictionary
│   ├── infra_patterns/
│   ├── compliance_mappings/
│   └── report_templates/
├── scripts/
│   ├── recon/ ad/ infra/ cloud/ scanner/ auth/
│   ├── post-exploit/ compliance/
│   ├── oracles/                 # apply_oracle.sh, oracle_runner.py
│   ├── refinement/              # refine_loop.sh
│   ├── poc/                     # generate_poc.sh
│   ├── verify/                  # recon_verify, discovery_verify, preflight_request
│   ├── tracker/                 # accuracy_report, bounty_analytics
│   └── pt-common/
├── hooks/                       # scope-guard, rate-limiter, checkpoint, …
├── examples/                    # sample_program/, sample_engagement/ — runnable fixtures
└── workspace/                   # execution results (gitignored)

★ = конвейер в стиле Mythos.

Метрики и калибровка

workspace/metrics/hypothesis_accuracy.json — центральное хранилище метрик.

• Базовые счётчики — total_hypotheses, total_confirmed, total_rejected, overall_accuracy.
• Точность по типам уязвимостей (by_type) — предсказанный vs. наблюдаемый коэффициент уверенности по каждому типу; calibration_gap выявляет переуверенность.
• Точность по архетипам (by_app_type) — SaaS / Ecommerce / Fintech / AI-Integrated и т.д.
• На этапах / по классам выводов (by_stage, by_inference_class) — точно определяет, где происходит потеря: на этапе разведывательного вывода, генерации гипотез или проектирования тестов.
• Метрики оракулов (oracle_metrics) — распределение вердиктов по типам уязвимостей.
• Метрики уточнения — KPI-эквивалент Mythos: confirmed_at_iter_1 / total_hypotheses_refined — это метрика Naze-а, соответствующая показателю «83% с первой попытки».
• Экономия на предварительной проверке — гипотезы, отсечённые до начала тестирования, + экономия оценочного бюджета запросов.

# Full report
bash scripts/verify/accuracy_tracker_granular.sh report

# Per-type detail
bash scripts/tracker/accuracy_report.sh

Дорожная карта

Конкретные следующие шаги, отслеживаемые в кодовой базе (см. naze-automation-design-v4-delta.md §Phase 6 и FAQ Q5):

• [ ] Анализ исходного кода — в настоящее время только чёрный ящик. План: интеграция анализа зависимостей из ОПО (Q3 2026).
• [ ] Выполнение PoC в Docker-песочнице — в настоящее время проверка только по HTTP. План: воспроизведение эксплойтов в контейнерах (Q4 2026).
• [ ] LDAP signing / SSL / дефолтные учётные данные — инфраструктурные оракулы — миграция ad-hoc проверок из scripts/infra/ в references/oracles/.
• [ ] AS-REP roasting / ESC2-ESC11 — AD-оракулы — расширение семейства Kerberoast/ADCS.
• [ ] Ежегодный импорт PortSwigger Top 10 — автоматическое превращение топ-техник каждого года в оракулы + уровни уточнения.
• [ ] Непрерывный мониторинг OWASP LLM Top 10 — отслеживание upstream и генерация отчётов о пробелах для новых категорий.
• [ ] Агенты-тестировщики GraphQL / gRPC — тестировщики для конкретных интерфейсов, использующие существующие оракулы.

PR-ы с любыми из этих улучшений приветствуются — см. Участие в проекте.

Участие в проекте

Naze распространяется под лицензией MIT и построен на Anthropic Claude Code. Быстрее всего внести вклад, добавив новый тип уязвимости — это рецепт из 4 файлов:

1. references/oracles/<type>_oracle.md — определение Crash Oracle
2. references/refinement_strategies/<type>_refinement.md — полезные нагрузки Tier 1–4
3. references/poc_templates/<type>_poc.md — шаблон PoC в 4 форматах
4. Добавьте eval_<type> в словарь EVALUATORS в scripts/oracles/oracle_runner.py

Ориентируйтесь на oracles/idor_oracle.md и oracles/smb_signing_oracle.md — всё остальное подключится автоматически. Полное руководство: CONTRIBUTING.md. Issues и PR-ы рассматриваются человеком; безопасные вклады следуют SECURITY.md.

История звёзд

Избранные проекты / вдохновители

• Anthropic Claude Mythos preview — принцип crash-oracle, на котором построен Naze.
• Project Glasswing — контекст распространения Mythos.
• "Address Sanitizer as a perfect crash oracle" — оригинальный проект ASan, вдохновивший Mythos.

Часто задаваемые вопросы

Q1. Можно ли использовать его не только для веба? AD / Облачные сервисы / внутренние сети?

Да — всё это доступно.

• AD-пентест: /scope internal-xxx с engagement_type=internal → /engage <cidr> автоматически запускает nmap + BloodHound + Kerberoasting + проверку векторов атак ADCS.
• Облачный аудит: engagement_type=cloud перечисляет AWS / Azure / GCP + публичные бакеты + ревизию IAM.
• Аудит внутренней сети: infra-tester-agent проверяет подписание SMB, подписание LDAP, SSL/TLS, учётные данные по умолчанию и уровень исправлений.
• Тестирование LLM-приложений: как только обнаруживается ИИ-эндпоинт, активируется llm-tester.

См. Варианты использования.

Q2. Как выбрать engagement_type?

/scope <id> запрашивает параметры интерактивно.

Q3. Почему «гипотезно-ориентированный»?

Обычные сканеры (nuclei, Burp Scanner и т.д.) запускают каждый шаблон, поэтому разные охотники постоянно находят одни и те же проблемы («риск дублирования»). Гипотезно-ориентированный подход задаёт вопрос: «учитывая контекст этого приложения, какие уязвимости наиболее вероятны?» — и затем целенаправленно атакует их — вы с большей вероятностью найдёте то, что упустили другие охотники. Naze напрямую включает duplication_risk в priority_score.

Q4. Когда использовать --no-verify / --no-refine / --no-poc?

• A/B-сравнение: запуск старого и нового режимов на одной цели и измерение разницы точности.
• Быстрая отладка: если вам нужен только вывод гипотез, отключение refine / poc ускоряет работу.
• Ответственное тестирование: чтобы избежать автогенерации PoC на боевой цели, используйте --no-poc.

Q5. Насколько это близко к Mythos?

Дополнительные инфраструктурные оракулы (подписание LDAP, SSL/TLS, учётные данные по умолчанию) и AD-оракулы (AS-REP roasting, ESC2-ESC11) всё ещё находятся на дорожной карте; соответствующие скрипты scripts/infra/*.sh и scripts/ad/*.sh продолжают обеспечивать собственные булевы проверки до их миграции.

Q6. Какой оракул наиболее зрелый?

1. IDOR (oracles/idor_oracle.md) — двухаккаунтный дизайн хорошо обобщается
2. SSRF (oracles/ssrf_oracle.md) — Interactsh OOB имеет практически нулевой процент ложных срабатываний
3. SQLi (oracles/sqli_oracle.md) — комбинация дельты по времени 4–7 сек и сигнатуры БД

Поскольку LLM вероятностны, prompt_injection_oracle.md использует порог воспроизводимости 3/5.

Q7. Как восстановиться после сбоя фазы?

Каждая фаза записывает checkpoint.log, поэтому /engage <target> --resume возобновляет с точки сбоя. Для отдельных скриптов проверьте workspace/<engagements|programs>/<id>/<phase>/checkpoint.log и перезапустите с соответствующего шага.

Q8. Как добавить новый тип уязвимости?

Четыре файла — и готово — см. Участие.

Q9. Что с непреднамеренным попаданием на хосты вне скоупа?

Каждый HTTP / SMB / LDAP-запрос проходит через hooks/scope-guard.sh. Трафик вне скоупа блокируется и логируется. engagement.json rules_of_engagement.prohibited_actions (например, «без DoS», «без выгрузки продакшн-данных») также строго соблюдается каждым агентом.

Q10. Что с ограничением скорости?

По умолчанию 10 запросов/с с адаптивным режимом (автозамедление при 429). Между гипотезами вставляется пауза 3–5 сек. Переопределите для каждого задания в engagement.json.

Лицензия и отказ от ответственности

• Используйте этот инструмент только в пределах скоупа, на который у вас есть явное письменное разрешение на тестирование.
• Требуемое разрешение для каждого типа задания:
  • Веб-багбаунти: соблюдайте правила и скоуп программы

Ответственность

• Не используйте этот инструмент для атак на системы без разрешения владельца.
• Не изменяйте и не удаляйте данные в системах, не принадлежащих вам.
• Все результаты тестирования должны передаваться только авторизованным лицам через защищённые каналы.
• Авторы не несут ответственности за любые повреждения или последствия, вызванные использованием этого инструмента.

Лицензия

MIT License

Copyright (c) 2025 Naze Contributors

Данная лицензия разрешает лицам, получившим копию данного программного обеспечения и связанных с ним файлов документации (далее «Программное обеспечение»), свободно использовать Программное обеспечение без ограничений, включая неограниченное право на использование, копирование, изменение, слияние, публикацию, распространение, сублицензирование и/или продажу копий Программного обеспечения, а также лицам, которым Программное обеспечение предоставлено, при условии соблюдения следующих условий:

Указанное уведомление об авторском праве и данное уведомление о лицензии должны быть включены во все копии или существенные части Программного обеспечения.

ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ, ЯВНО ВЫРАЖЕННЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ, ГАРАНТИИ ТОВАРНОЙ ПРИГОДНОСТИ, СООТВЕТСТВИЯ КОНКРЕТНОМУ НАЗНАЧЕНИЮ И НЕНАРУШЕНИЯ ПРАВ. НИ В КАКОМ СЛУЧАЕ АВТОРЫ ИЛИ ПРАВООБЛАДАТЕЛИ НЕ НЕСУТ ОТВЕТСТВЕННОСТИ ЗА КАКИЕ-ЛИБО ПРЕТЕНЗИИ, УЩЕРБ ИЛИ ИНУЮ ОТВЕТСТВЕННОСТЬ, ВОЗНИКАЮЩУЮ В РЕЗУЛЬТАТЕ ИЛИ СВЯЗАННУЮ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ ИЛИ ИСПОЛЬЗОВАНИЕМ ИЛИ ДРУГИМИ ДЕЙСТВИЯМИ В ПРОГРАММНОМ ОБЕСПЕЧЕНИИ.

- Внутренняя / AD пентест: подписанный контракт + письменные Правила ведения (RoE) - Облачный аудит: письменное согласие владельца аккаунта и соблюдение соответствующей политики пентеста AWS / Azure / GCP - engagement.json rules_of_engagement.prohibited_actions (например, DoS, уничтожение продакшн-данных, реальный exfil) строго соблюдаются каждым агентом. - Раскрывать любые находки через Согласованное раскрытие. - Лицензия MIT. Авторы не несут ответственности за вред, причинённый использованием этого программного обеспечения.

Ссылки

• CLAUDE.md — Глобальные правила работы Claude Code
• naze-automation-design-v3.md — 3-этапная архитектура чанкинга
• naze-automation-design-v4-delta.md — дельта v4 (+11 типов атак + AI/LLM)
• naze-implementation-blueprint.md — Дизайн подагентов + Хуков + Навыков
• naze-agent-teams-guide.md — Паттерны команд агентов