BlackBerryC2 2.0.0-beta

BlackBerryC2 es un framework de administración remota y C2 encriptado diseñado exclusivamente para uso educativo, investigación de seguridad y entornos de laboratorio controlados.

El proyecto demuestra cómo construir un servidor de comando y control personalizado con criptografía a nivel de aplicación, gestión de sesiones y comunicación segura con el cliente sin depender de pilas TLS externas.

⚠️ Aviso Importante

Este proyecto NO es malware y NO está destinado para acceso no autorizado.

BlackBerryC2:

• No se autopropaga
• No explota vulnerabilidades automáticamente
• No incluye mecanismos de persistencia
• No intenta evadir software antivirus

Úselo solo en sistemas y redes de su propiedad o para los que tenga autorización explícita para probar.

Dependencias de Python:

pip install cryptography prompt_toolkit zstandard

zstandard es opcional pero recomendado para transferencias mayores de 1 GB.

Características Principales

• Servidor C2 encriptado personalizado basado en TCP (v2.0)
• Intercambio de claves ECDHE (secp256r1) — efímero o persistente
• Cifrado autenticado AES-256-GCM por sesión
• Autenticación HMAC-SHA256 por paquete + números de secuencia antirrepetición
• Múltiples sesiones de cliente concurrentes
• Consola de operador interactiva con autocompletado (prompt_toolkit)
• Ejecución remota de comandos encriptada
• Transferencias de archivos encriptadas con compresión zlib / Zstandard
• Subida/bajada recursiva de directorios (get -r, put -r)
• Transferencias en segundo plano (flag -b) — no bloqueantes, cancelables
• Soporte de reanudación de transferencias (archivos .partial + .resume)
• Generador de payload para cliente (generate-payload)
• Bloqueo de IP: lista de bloqueo persistente + baneos temporales automáticos
• Detección de escaneo/inundación: escaneo de conexión, captura de banner, fallos de handshake, inundación de heartbeat
• Soporte opcional de proxy HTTP(S)/TLS (BlackBerryHTTPs_TLSProxyGUI)
• Pre-autenticación SPA (Autorización de un Solo Paquete) y Port-Knocking
• Modo BerryTransfer — servidor dedicado solo para transferencia de archivos (sin shell)
• Registro de sesión encriptado (AES-256-GCM + PBKDF2, 600k iteraciones)
• Registro del servidor encriptado con visor integrado en la shell (comando log)

Diseño Criptográfico

BlackBerryC2 v2.0 establece comunicación segura de la siguiente manera:

1. El cliente se conecta vía TCP; el servidor envía el banner de servicio.
2. El cliente envía REQUEST_PUBKEY.
3. El servidor envía su clave pública ECDHE efímera (secp256r1).
4. El cliente envía su clave pública ECDHE + etiqueta de autenticación HMAC-SHA256.
5. El servidor verifica el HMAC contra el secreto precompartido (HMAC_PRE_SHARED_SECRET).
6. Ambos lados derivan una clave de sesión AES de 256 bits mediante HKDF-SHA256 sobre el secreto compartido.
7. Toda comunicación posterior utiliza AES-256-GCM con HMAC-SHA256 por paquete y números de secuencia antirrepetición.

Cada sesión mantiene:

• Su propia clave AES-256 y clave HMAC
• Nonces independientes (12 bytes aleatorios por mensaje)
• Rastreador antirrepetición aislado (ventana de secuencia ±100)
• Limitador de velocidad contra inundaciones (comandos/segundo configurables)

Todas las claves criptográficas se generan en tiempo de ejecución y nunca se reutilizan entre reinicios (a menos que se establezca --persistente).

Ejecución del Servidor

python3 BlackBerryC2_server.py

Configuración por defecto:

• Host: 0.0.0.0
• Puerto: 9949

Argumentos de Línea de Comandos

Ejemplos:

# Inicio básico (solicita frase de paso para el registro)
python3 BlackBerryC2_server.py

# Claves ECDHE persistentes + verbose
python3 BlackBerryC2_server.py -p -vv

# Puerto personalizado, sin verificación HMAC
python3 BlackBerryC2_server.py -P 8080 --no-secure

# Port-knocking en puertos personalizados
python3 BlackBerryC2_server.py --spa --spa-mode knock --knock-seq 9001,9002,9003

# Modo BerryTransfer con auto-confirmación
python3 BlackBerryC2_server.py --berrytransfer --auto-confirm

# Ver/descifrar registros sin iniciar el servidor
python3 BlackBerryC2_server.py --logs

Comandos de la Consola del Operador

Gestión del Servidor

Proxy

Comandos de Sesión (dentro de select <ID>)

Generales

Transferencia de Archivos

Modo BerryTransfer

BerryTransfer es un modo de servidor dedicado solo a la transferencia de archivos inspirado en scp. Cuando está activo, el servidor rechaza todo acceso a la shell y solo acepta comandos de protocolo BT:*.

Inicio:

python3 BlackBerryC2_server.py --berrytransfer
python3 BlackBerryC2_server.py --berrytransfer --auto-confirm  # sin aviso al operador para GETs

Comandos del shell BerryTransfer:

El registro de transferencias se escribe en logs/bt_transfer.jsonl (opcionalmente cifrado con AES-256-GCM).

SPA / Port-Knocking

Cuando --spa está activo, los clientes deben autenticarse vía UDP antes de que se acepte la conexión TCP.

Modo SPA (por defecto): El cliente envía un token HMAC-SHA256 de 32 bytes a SPA_UDP_PORT.

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

Modo Knock: El cliente toca una secuencia de puertos UDP en orden dentro de una ventana de tiempo.

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

Las IPs autorizadas son válidas durante --spa-ttl segundos (por defecto 60).

Características de Seguridad

Registro (Logging)

Vea los registros con el visor integrado:

BlackBerry> log

O de forma independiente (sin servidor):

python3 BlackBerryC2_server.py --logs

Uso Previsto

Este proyecto está destinado solamente para:

• Demostraciones educativas
• Investigación de seguridad
• Entornos de laboratorio controlados
• Pruebas de penetración autorizadas

El uso no autorizado contra sistemas sin permiso está estrictamente prohibido.

Licencia

Consulte el archivo LICENSE para obtener detalles completos de la licencia.

Aviso Legal

Este software se proporciona "tal cual", sin garantía de ningún tipo.
Los autores no asumen ninguna responsabilidad por el uso indebido o los daños causados por este software.