Manipulador de reverse shell multi-sessão com upgrade de PTY, módulos de pós-exploração, tunelamento de Camada 3, ofuscação de payload para evasão de EDR, registro de sessões e um servidor MCP para controle orientado por LLM.
Descubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.
Este projeto é a minha tentativa de criar um shell handler rápido, fácil de usar (e ainda assim repleto de recursos) com uma interface bonita.
Aviso: observe que este projeto ainda está em desenvolvimento, e ainda estou trabalhando em alguns dos recursos principais, discutidos em esta seção.
✨ Recursos | 🚧 Em desenvolvimento | 🚀 Instalação | 💻 Uso | 🔧 Upgrade para PTY | 🤖 Módulos | 🧠 MCP
A documentação completa está na wiki.
[!TIP] Esta demonstração roda com um sistema operacional dockerizado. Se quiser testar você mesmo, pode usar as imagens Ubuntu ou o dockur para Windows
script/socat, Windows via ConPtyShell ofuscado) para autocompletar com tab, encaminhamento de Ctrl+C e redimensionamento do terminal.connect ssh user@host transforma credenciais que você já possui em uma sessão. O ssh apenas entrega o payload, então o shell continua vivo após o ssh encerrar.tunnel start <id> <cidr> transforma um shell em um pivot de Camada 3: uma pilha TCP em espaço de usuário no alvo (sem root, sem binário implantado, apenas Python) com as rotas do seu lado. (docs)koireview. (docs)Ctrl+Z coloca a sessão em segundo plano, Ctrl+C envia SIGINT ao remoto, nunca mata seu listener por acidente.[!NOTE] Agora é possível usar o Koi remotamente ! Leia mais aqui
# Recommended: stable release from PyPI
pipx install koi-handler
# From source if you want to dev your own modules
git clone https://github.com/b3rt1ng/koi
cd koi
pipx install --editable .
koifuscator é o atalho direto para o módulo de ofuscação.
koireview é a sua forma de ver os logs das suas sessões.
Para atualizar:
pipx upgrade koi-handler
Mais detalhes em Getting Started.
# Default: bind 0.0.0.0:4010
koi
# Custom host/port
koi --host 10.10.14.5 --port 9001
koi -p 9001
Uma vez dentro, help lista todos os comandos. A referência completa está em CLI Reference, e o gerenciamento de sessões (tags, execução em segundo plano, modo screenable) em Session Management.
Envie um reverse shell você mesmo ou digitando payloads *interface* para obter payloads pré-gerados. Observe que ele precisa ser um shell de terminal, pois o Koi manipula shs do Linux, powershells e cmd.
O Koi inclui um ofuscador de payload integrado para ajudar a evadir a detecção do Windows Defender. Você pode encadear várias técnicas, embora a codificação XOR e as transformações de formato geralmente sejam suficientes. Tenha em mente que empilhar camadas demais pode corromper o payload e torná-lo ilegível para o alvo.
O ofuscador também funciona para payloads Linux. Embora a maioria dos ambientes Linux não execute software antivírus, one-liners em bash são comumente sinalizados por soluções EDR, regras de IDS ou monitorados por blue teams atentos a padrões conhecidos de reverse shell. Ofuscar seu payload ajuda a passar despercebido em alguns ambientes reforçados.
Cada técnica e cada tipo de payload suportado está listado em Payloads & Obfuscation.
Shells brutos não têm suporte adequado a terminal: sem preenchimento automático por tab, Ctrl+C quebrado, saída corrompida. O comando upgrade corrige isso:
koi> upgrade 1
Shell #1 upgraded successfully.
koi> go 1
# now a full PTY with proper terminal behaviour
um pty python simples é gerado
python3 -c 'import pty; pty.spawn("/bin/bash")'
com TERM=xterm-256color e algumas informações de redimensionamento
Não me preocupei em criar um para o CMD, mas para o powershell a técnica usa um conptyshell ofuscado para obter um shell totalmente implementado:
1) ConPtyShell is fetched from GitHub and cached locally for offline reuse
2) All IOC identifiers are renamed to random strings (class names, method names, PS function name)
3) Distinctive C# string literals are replaced with runtime char-array constructions (no literal in compiled MSIL)
4) The obfuscated script is served over a temporary HTTP server
5) The invocation command is base64-encoded (-EncodedCommand) with IEX and IWR obfuscated via random split techniques (concat / format string / char-array), so no plaintext cmdlet names appear on the command line
6) The target connects back with a fully interactive PTY shell, registered as a new session