BlackBerryC2 2.0.0-beta

BlackBerryC2 é um framework de administração remota e C2 criptografado projetado exclusivamente para uso educacional, pesquisa de segurança e ambientes laboratoriais controlados.

O projeto demonstra como construir um servidor de comando e controle personalizado com criptografia na camada de aplicação, gerenciamento de sessão e comunicação segura com o cliente sem depender de pilhas TLS externas.

⚠️ Aviso Importante

Este projeto NÃO é malware e NÃO se destina a acesso não autorizado.

BlackBerryC2:

• Não se auto-propaga
• Não explora vulnerabilidades automaticamente
• Não inclui mecanismos de persistência
• Não tenta evadir software antivírus

Use apenas em sistemas e redes que você possui ou tem autorização explícita para testar.

Dependências Python:

pip install cryptography prompt_toolkit zstandard

zstandard é opcional, mas recomendado para transferências maiores que 1 GB.

Principais Recursos

• Servidor C2 criptografado baseado em TCP personalizado (v2.0)
• Troca de chaves ECDHE (secp256r1) — efêmera ou persistente
• Criptografia autenticada AES-256-GCM por sessão
• Autenticação por pacote HMAC-SHA256 + números de sequência anti-replay
• Múltiplas sessões de cliente concorrentes
• Console interativo do operador com preenchimento por tabulação (prompt_toolkit)
• Execução remota de comandos criptografada
• Transferências de arquivos criptografadas com compressão zlib / Zstandard
• Upload/download recursivo de diretórios (get -r, put -r)
• Transferências em segundo plano (flag -b) — não bloqueantes, canceláveis
• Suporte a retomada de transferência (arquivos .partial + .resume)
• Gerador de payload do cliente (generate-payload)
• Bloqueio de IP: lista de bloqueio persistente + banimentos temporários automáticos
• Detecção de varredura/inundação: scan de conexão, captura de banner, falhas de handshake, inundação de heartbeat
• Suporte opcional a proxy HTTP(S)/TLS (BlackBerryHTTPs_TLSProxyGUI)
• Pré-autenticação SPA (Autorização de Pacote Único) e Port-Knocking
• Modo BerryTransfer — servidor dedicado apenas para transferência de arquivos (sem shell)
• Log de sessão criptografado (AES-256-GCM + PBKDF2, 600k iterações)
• Log do servidor criptografado com visualizador dentro do shell (comando log)

Design Criptográfico

BlackBerryC2 v2.0 estabelece comunicação segura da seguinte forma:

1. O cliente se conecta via TCP; o servidor envia o banner de serviço.
2. O cliente envia REQUEST_PUBKEY.
3. O servidor envia sua chave pública ECDHE efêmera (secp256r1).
4. O cliente envia sua chave pública ECDHE + tag de autenticação HMAC-SHA256.
5. O servidor verifica o HMAC em relação ao segredo pré-compartilhado (HMAC_PRE_SHARED_SECRET).
6. Ambos os lados derivam uma chave de sessão AES de 256 bits via HKDF-SHA256 sobre o segredo compartilhado.
7. Toda comunicação futura usa AES-256-GCM com HMAC-SHA256 por pacote e números de sequência anti-replay.

Cada sessão mantém:

• Sua própria chave AES-256 e chave HMAC
• Nonces independentes (12 bytes aleatórios por mensagem)
• Rastreador anti-replay isolado (janela de sequência ±100)
• Limitador de taxa de proteção contra inundação (comandos/segundo configurável)

Todas as chaves criptográficas são geradas em tempo de execução e nunca reutilizadas entre reinicializações (a menos que --persistente seja definido).

Executando o Servidor

python3 BlackBerryC2_server.py

Configuração padrão:

• Host: 0.0.0.0
• Porta: 9949

Argumentos de Linha de Comando

Exemplos:

# Inicialização básica (solicita frase secreta do log)
python3 BlackBerryC2_server.py

# Chaves ECDHE persistentes + verboso
python3 BlackBerryC2_server.py -p -vv

# Porta personalizada, sem verificação HMAC
python3 BlackBerryC2_server.py -P 8080 --no-secure

# Port-knocking em portas personalizadas
python3 BlackBerryC2_server.py --spa --spa-mode knock --knock-seq 9001,9002,9003

# Modo BerryTransfer com confirmação automática
python3 BlackBerryC2_server.py --berrytransfer --auto-confirm

# Visualizar/descriptografar logs sem iniciar o servidor
python3 BlackBerryC2_server.py --logs

Comandos do Console do Operador

Gerenciamento do Servidor

Proxy

Comandos de Sessão (dentro de select <ID>)

Geral

Transferência de Arquivos

Modo BerryTransfer

BerryTransfer é um modo de servidor dedicado apenas para transferência de arquivos inspirado no scp. Quando ativo, o servidor rejeita todo acesso a shell e aceita apenas comandos de protocolo BT:*.

Iniciar:

python3 BlackBerryC2_server.py --berrytransfer
python3 BlackBerryC2_server.py --berrytransfer --auto-confirm  # sem prompt do operador para GETs

Comandos do shell BerryTransfer:

O log de transferência é escrito em logs/bt_transfer.jsonl (opcionalmente criptografado com AES-256-GCM).

SPA / Port-Knocking

Quando --spa está ativo, os clientes devem se autenticar via UDP antes que a conexão TCP seja aceita.

Modo SPA (padrão): O cliente envia um token HMAC-SHA256 de 32 bytes para SPA_UDP_PORT.

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

Modo Knock: O cliente bate em uma sequência de portas UDP em ordem dentro de uma janela de tempo limite.

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

IPs autorizados são válidos por --spa-ttl segundos (padrão 60).

Recursos de Segurança

Logs

Visualize logs com o visualizador integrado:

BlackBerry> log

Ou de forma independente:

python3 BlackBerryC2_server.py --logs

Uso Pretendido

Este projeto é destinado apenas para:

• Demonstrações educacionais
• Pesquisa de segurança
• Ambientes laboratoriais controlados
• Testes de penetração autorizados

O uso não autorizado contra sistemas sem permissão é estritamente proibido.

Licença

Veja o arquivo LICENSE para detalhes completos da licença.

Aviso Legal

Este software é fornecido "como está", sem garantia de qualquer tipo.
Os autores não assumem nenhuma responsabilidade por uso indevido ou danos causados por este software.