BlackBerryC2 2.0.0-beta

BlackBerryC2 — это зашифрованная платформа для удаленного администрирования и C2, разработанная исключительно для образовательных целей, исследований в области безопасности и контролируемых лабораторных сред.

Проект демонстрирует, как построить пользовательский сервер управления и контроля с криптографией на уровне приложения, управлением сессиями и безопасной связью с клиентом без использования внешних TLS-стеков.

⚠️ Важное уведомление

Этот проект НЕ является вредоносным ПО и НЕ предназначен для несанкционированного доступа.

BlackBerryC2:

• Не самораспространяется
• Не использует уязвимости автоматически
• Не включает механизмы сохранения
• Не пытается обходить антивирусное ПО

Используйте только на системах и сетях, которыми вы владеете или на тестирование которых имеете явное разрешение.

Python-зависимости:

pip install cryptography prompt_toolkit zstandard

zstandard опционален, но рекомендуется для передачи файлов размером более 1 ГБ.

Ключевые возможности

• Пользовательский зашифрованный C2-сервер на основе TCP (v2.0)
• Обмен ключами ECDHE (secp256r1) — эфемерный или постоянный
• Аутентифицированное шифрование AES-256-GCM для каждой сессии
• Аутентификация каждого пакета с помощью HMAC-SHA256 + номера последовательности для защиты от повторного воспроизведения
• Несколько одновременных клиентских сессий
• Интерактивная консоль оператора с автодополнением (prompt_toolkit)
• Зашифрованное удаленное выполнение команд
• Зашифрованная передача файлов со сжатием zlib / Zstandard
• Рекурсивная загрузка/выгрузка директорий (get -r, put -r)
• Фоновые передачи (-b) — неблокирующие, отменяемые
• Поддержка возобновления передачи (файлы .partial + .resume)
• Генератор клиентской полезной нагрузки (generate-payload)
• Блокировка IP: постоянный список блокировки + временные авто-баны
• Обнаружение сканирования / флуда: сканирование подключений, захват баннера, сбои рукопожатия, флуд heartbeat
• Опциональная поддержка HTTP(S)/TLS-прокси (BlackBerryHTTPs_TLSProxyGUI)
• SPA (Single Packet Authorization) и Port-Knocking предварительная аутентификация
• Режим BerryTransfer — выделенный сервер только для передачи файлов (без оболочки)
• Зашифрованный журнал сессии (AES-256-GCM + PBKDF2, 600k итераций)
• Зашифрованный журнал сервера со встроенным просмотрщиком (команда log)

Криптографический дизайн

BlackBerryC2 v2.0 устанавливает безопасную связь следующим образом:

1. Клиент подключается через TCP; сервер отправляет баннер службы.
2. Клиент отправляет REQUEST_PUBKEY.
3. Сервер отправляет свой эфемерный открытый ключ ECDHE (secp256r1).
4. Клиент отправляет свой открытый ключ ECDHE + тег аутентификации HMAC-SHA256.
5. Сервер проверяет HMAC по предварительно общему секрету (HMAC_PRE_SHARED_SECRET).
6. Обе стороны выводят 256-битный ключ сессии AES через HKDF-SHA256 на основе общего секрета.
7. Все дальнейшее общение использует AES-256-GCM с по-пакетным HMAC-SHA256 и номерами последовательности для защиты от повторного воспроизведения.

Каждая сессия поддерживает:

• Собственный ключ AES-256 и ключ HMAC
• Независимые nonce (12-байтовые случайные для каждого сообщения)
• Изолированный трекер защиты от повторного воспроизведения (окно последовательности ±100)
• Ограничитель скорости для защиты от флуда (настраиваемое количество команд/сек)

Все криптографические ключи генерируются во время выполнения и никогда не повторяются между перезапусками (если не установлен --persistente).

Запуск сервера

python3 BlackBerryC2_server.py

Конфигурация по умолчанию:

• Хост: 0.0.0.0
• Порт: 9949

Аргументы командной строки

Примеры:

# Базовый запуск (запрашивает парольную фразу для журнала)
python3 BlackBerryC2_server.py

# Постоянные ключи ECDHE + подробный режим
python3 BlackBerryC2_server.py -p -vv

# Пользовательский порт, без проверки HMAC
python3 BlackBerryC2_server.py -P 8080 --no-secure

# Port-knocking на пользовательских портах
python3 BlackBerryC2_server.py --spa --spa-mode knock --knock-seq 9001,9002,9003

# Режим BerryTransfer с авто-подтверждением
python3 BlackBerryC2_server.py --berrytransfer --auto-confirm

# Просмотр/расшифровка журналов без запуска сервера
python3 BlackBerryC2_server.py --logs

Команды консоли оператора

Управление сервером

Прокси

Команды сессии (внутри select <ID>)

Общие

Передача файлов

Режим BerryTransfer

BerryTransfer — это выделенный режим сервера только для передачи файлов, вдохновленный scp. При активации сервер отклоняет любой доступ к оболочке и принимает только команды протокола BT:*.

Запуск:

python3 BlackBerryC2_server.py --berrytransfer
python3 BlackBerryC2_server.py --berrytransfer --auto-confirm  # без запроса оператора для GET

Команды оболочки BerryTransfer:

Журнал передачи записывается в logs/bt_transfer.jsonl (опционально зашифрован AES-256-GCM).

SPA / Port-Knocking

Когда активен --spa, клиенты должны пройти аутентификацию через UDP до того, как TCP-соединение будет принято.

Режим SPA (по умолчанию): Клиент отправляет 32-байтовый токен HMAC-SHA256 на SPA_UDP_PORT.

token = HMAC-SHA256(HMAC_SECRET, "{ip}:{time_window_30s}")

Режим Knock: Клиент последовательно стучит по UDP-портам в течение временного окна.

python3 BlackBerryC2_server.py --spa --spa-mode knock --knock-seq 7001,7002,7003 --knock-timeout 10

Авторизованные IP-адреса действительны в течение --spa-ttl секунд (по умолчанию 60).

Функции безопасности

Логирование

Просмотр журналов со встроенным просмотрщиком:

BlackBerry> log

Или отдельно (без сервера):

python3 BlackBerryC2_server.py --logs

Предполагаемое использование

Этот проект предназначен только для:

• Образовательных демонстраций
• Исследований в области безопасности
• Контролируемых лабораторных сред
• Авторизованного тестирования на проникновение

Несанкционированное использование против систем без разрешения строго запрещено.

Лицензия

См. файл LICENSE для получения полной информации о лицензии.

Отказ от ответственности

Данное программное обеспечение предоставляется "как есть", без каких-либо гарантий.
Авторы не несут ответственности за неправильное использование или ущерб, причиненный данным программным обеспечением.