NullSec-RedTeam-AI

Исполнение безопасности на основе авторизации, управляемое через MCP, для явно одобренных сред.

NullSec-RedTeam-AI — это управляющая плоскость для одного хоста, обеспечивающая регламентированные рабочие процессы с инструментами безопасности. Она фиксирует утвержденную область действия кампании, контекст субъекта, политическое решение, полный жизненный цикл задания, аудиторский след и ссылку на доказательства до того, как исполнителю будет разрешено выполнить задание. Его поведение по умолчанию — обязательная изоляция и отказ по умолчанию: обязательная изоляция никогда не упрощается до выполнения на хосте.

Используйте только с явным письменным разрешением. Этот проект представляет собой программное обеспечение безопасности на ранней стадии разработки, а не автономную систему red-команды, замену соглашению об участии в проекте или мультитенантный сервис. Запускайте его в изолированных тестовых средах или на ресурсах, которые вы имеете явное разрешение оценивать.

Почему NullSec?

Related MCP server: Nervora

Архитектура в двух словах

Пользователь или MCP-клиент достигает транспортного уровня только после аутентификации и построения контекста вызывающего. Движок политик кампании решает, находится ли типизированный запрос в рамках области действия. Постоянное хранилище заданий координирует блокировки и события аудита; исполнитель, учитывающий блокировки, может затем запросить запуск в изолированной среде с минимальными привилегиями. AURA остается над границей выполнения, с отдельным этапом проверки доказательств.

Диаграмма Mermaid в системе контроля версий доступна по адресу docs/assets/control-plane-architecture.mmd. Ознакомьтесь с обоснованием архитектуры в ADR-001.

Быстрый старт для безопасной локальной разработки

Рабочий процесс разработки использует моки и симулированные фикстуры; он не устанавливает, не загружает и не выполняет инструменты безопасности.

git clone https://github.com/Panda1847/NullSec-RedTeam-AI.git
cd NullSec-RedTeam-AI
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e '.[dev]'

pytest
ruff check .

Для локальной работы по разработке API используйте состояние, локальное для проекта, непродуктовый токен и привязку только к loopback.

mkdir -p .nullsec/logs .nullsec/jobs
export NULLSEC_LOG_DIR="$PWD/.nullsec/logs"
export NULLSEC_JOB_DIR="$PWD/.nullsec/jobs"
export API_TOKEN="local-development-token"
export NULLSEC_LOCAL_ACTOR_ID="local-operator"
export NULLSEC_LOCAL_ACTOR_ROLES="operator"

hexstrike-server --host 127.0.0.1 --port 8888

Сервис отклоняет привязку не к loopback, если явно не установлен NULLSEC_ALLOW_NON_LOOPBACK=true. Относитесь к этой настройке как к изменению развертывания, требующему аутентифицированного обратного прокси и одобренной сетевой политики.

Безопасный поток кампании

Кампания фиксирует авторизацию и область действия. Следующий пример, работающий только через loopback, создает запись кампании; он не запускает инструмент.

curl --request POST http://127.0.0.1:8888/api/campaigns \
  --header "Authorization: Bearer $API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "campaign_id": "local-demo-001",
    "allowed_targets": ["127.0.0.0/8"],
    "allowed_capabilities": ["passive"],
    "starts_at": "2026-08-18T09:00:00+00:00",
    "ends_at": "2026-08-18T17:00:00+00:00"
  }'

Для отправки задания требуются эта кампания, поддерживаемый уровень возможностей и ключ идемпотентности. В режиме по умолчанию sandbox_required задание остается безопасным для постановки в очередь, но завершается отказом на этапе выполнения, если оператор не предоставил проверенный неизменяемый образ и конфигурацию runner без прав root.

curl --request POST http://127.0.0.1:8888/api/tools/execute \
  --header "Authorization: Bearer $API_TOKEN" \
  --header 'Content-Type: application/json' \
  --header 'X-Trace-Id: local-demo-trace-001' \
  --data '{
    "tool": "nmap",
    "target": "127.0.0.1",
    "options": "-sV",
    "campaign_id": "local-demo-001",
    "capability": "passive",
    "idempotency_key": "local-demo-request-001"
  }'

Не помещайте токены bearer в историю команд оболочки, систему контроля версий, скриншоты или журналы CI.

Лаборатория ИИ безопасности

Лаборатория ИИ безопасности отличает симуляцию от реальной оценки поставщика. Ее вывод по умолчанию имеет параметры mode: simulation и status: not_evaluated; она не утверждает, что модель уязвима, устойчива или оценена. Оценка поставщика остается недоступной до тех пор, пока организация не предоставит согласованный адаптер, версионированный набор данных, защищенные учетные данные, хранилище доказательств и метод оценки.

ai-lab --list
ai-lab --model consented-test-model --technique PROMPT_INJECTION --mode simulation

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

Шлюзы качества

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

Публичный рабочий процесс охватывает тесты с целенаправленным покрытием, проверку Ruff, целенаправленную проверку типов, статический анализ безопасности, аудит зависимостей и сборку пакетов PEP 517. Исходный код диаграммы шлюзов качества — docs/assets/quality-gates.mmd.

Статус проекта и дорожная карта

Смотрите ROADMAP.md для поддерживаемой последовательности реализации и IMPLEMENTATION_SUMMARY.md для записи модернизации до версии 7.1.

Документация

Участие в разработке

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

Откройте вопрос по дизайну или предложите запись архитектурного решения перед масштабными изменениями. Сначала ознакомьтесь с CONTRIBUTING.md и используйте SECURITY.md вместо публичных вопросов для сообщений об уязвимостях.

Лицензия

Этот проект лицензирован в соответствии с лицензией MIT. Лицензия не предоставляет разрешения на оценку какой-либо системы. Операторы несут ответственность за соблюдение применимого законодательства, договоров, политики организации, письменных разрешений и ограничений участия.