BlackBerryC2 2.0.0-beta

BlackBerryC2 è un framework di amministrazione remota e C2 crittografato progettato esclusivamente per uso educativo, ricerca sulla sicurezza e ambienti di laboratorio controllati.

Il progetto dimostra come costruire un server di comando e controllo personalizzato con crittografia a livello applicativo, gestione delle sessioni e comunicazione sicura con il client senza fare affidamento su stack TLS esterni.

⚠️ Avviso Importante

Questo progetto NON è malware e NON è destinato ad accessi non autorizzati.

BlackBerryC2:

• Non si autopropaga
• Non sfrutta vulnerabilità automaticamente
• Non include meccanismi di persistenza
• Non tenta di eludere software antivirus

Utilizzare solo su sistemi e reti di tua proprietà o per cui hai esplicita autorizzazione al test.

Dipendenze Python:

pip install cryptography prompt_toolkit zstandard

zstandard è opzionale ma consigliato per trasferimenti superiori a 1 GB.

Caratteristiche principali

• Server C2 crittografato basato su TCP personalizzato (v2.0)
• Scambio di chiavi ECDHE (secp256r1) — effimero o persistente
• Crittografia autenticata AES-256-GCM per sessione
• Autenticazione per pacchetto HMAC-SHA256 + numeri di sequenza anti-replay
• Sessioni client multiple concorrenti
• Console interattiva per operatore con completamento tramite tab (prompt_toolkit)
• Esecuzione remota di comandi crittografata
• Trasferimenti file crittografati con compressione zlib / Zstandard
• Caricamento/scaricamento ricorsivo di directory (get -r, put -r)
• Trasferimenti in background (flag -b) — non bloccanti, annullabili
• Supporto per ripresa trasferimenti (file .partial + .resume)
• Generatore di payload client (generate-payload)
• Blocco IP: blocklist persistente + ban automatici temporanei
• Rilevamento scan/flood: connect scan, banner grab, fallimenti handshake, heartbeat flood
• Supporto proxy HTTP(S)/TLS opzionale (BlackBerryHTTPs_TLSProxyGUI)
• Pre-autenticazione SPA (Single Packet Authorization) e Port-Knocking
• Modalità BerryTransfer — server dedicato solo trasferimento file (nessuna shell)
• Log di sessione crittografato (AES-256-GCM + PBKDF2, 600k iterazioni)
• Log server crittografato con visualizzatore in-shell (comando log)

Progettazione Crittografica

BlackBerryC2 v2.0 stabilisce una comunicazione sicura come segue:

1. Il client si connette tramite TCP; il server invia il banner di servizio.
2. Il client invia REQUEST_PUBKEY.
3. Il server invia la sua chiave pubblica ECDHE effimera (secp256r1).
4. Il client invia la sua chiave pubblica ECDHE + il tag di autenticazione HMAC-SHA256.
5. Il server verifica l'HMAC rispetto al segreto pre-condiviso (HMAC_PRE_SHARED_SECRET).
6. Entrambe le parti derivano una chiave di sessione AES a 256 bit tramite HKDF-SHA256 dal segreto condiviso.
7. Tutte le comunicazioni successive utilizzano AES-256-GCM con HMAC-SHA256 per pacchetto e numeri di sequenza anti-replay.

Ogni sessione mantiene:

• La propria chiave AES-256 e chiave HMAC
• Nonce indipendenti (12 byte casuali per messaggio)
• Tracker anti-replay isolato (finestra di sequenza ±100)
• Limitatore di velocità per protezione flood (comandi/secondo configurabile)

Tutte le chiavi crittografiche sono generate in esecuzione e mai riutilizzate tra riavvii (a meno che non sia impostato --persistente).

Esecuzione del Server

python3 BlackBerryC2_server.py

Configurazione predefinita:

• Host: 0.0.0.0
• Porta: 9949

Argomenti della Riga di Comando

Esempi:

# Avvio base (richiede passphrase per log)
python3 BlackBerryC2_server.py

# Chiavi ECDHE persistenti + verbose
python3 BlackBerryC2_server.py -p -vv

# Porta personalizzata, nessun controllo HMAC
python3 BlackBerryC2_server.py -P 8080 --no-secure

# Port-knocking su porte personalizzate
python3 BlackBerryC2_server.py --spa --spa-mode knock --knock-seq 9001,9002,9003

# Modalità BerryTransfer con conferma automatica
python3 BlackBerryC2_server.py --berrytransfer --auto-confirm

# Visualizza/decifra log senza avviare server
python3 BlackBerryC2_server.py --logs

Comandi della Console Operatore

Gestione Server

Proxy

Comandi di Sessione (all'interno di select <ID>)

Generali

Trasferimento File

Modalità BerryTransfer

BerryTransfer è una modalità server dedicata solo trasferimento file ispirata a scp. Quando attiva, il server rifiuta qualsiasi accesso shell e accetta solo comandi di protocollo BT:*.

Avvio:

python3 BlackBerryC2_server.py --berrytransfer
python3 BlackBerryC2_server.py --berrytransfer --auto-confirm  # nessun prompt operatore per GET

Comandi shell BerryTransfer:

Il log di trasferimento è scritto in logs/bt_transfer.jsonl (opzionalmente crittografato con AES-256-GCM).

SPA / Port-Knocking

Quando --spa è attivo, i client devono autenticarsi tramite UDP prima che la connessione TCP venga accettata.

Modalità SPA (predefinita): Il client invia un token HMAC-SHA256 di 32 byte a SPA_UDP_PORT.

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

Modalità Knock: Il client esegue il knock su una sequenza di porte UDP in ordine entro una finestra di timeout.

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

Gli IP autorizzati sono validi per --spa-ttl secondi (default 60).

Caratteristiche di Sicurezza

Registrazione (Logging)

Visualizza i log con il visualizzatore integrato:

BlackBerry> log

O in modo autonomo (nessun server):

python3 BlackBerryC2_server.py --logs

Utilizzo Previsto

Questo progetto è destinato solo a:

• Dimostrazioni educative
• Ricerca sulla sicurezza
• Ambienti di laboratorio controllati
• Test di penetrazione autorizzati

L'uso non autorizzato contro sistemi senza permesso è severamente vietato.

Licenza

Vedere il file LICENSE per i dettagli completi della licenza.

Disclaimer

Questo software è fornito "così com'è", senza alcuna garanzia.
Gli autori non si assumono alcuna responsabilità per un uso improprio o danni causati da questo software.