koi 🎏

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

Отказ от ответственности: обратите внимание, что проект всё ещё находится в разработке, и я всё ещё работаю над некоторыми ключевыми функциями, о которых говорится в этом разделе.

📑 Содержание

Полная документация находится в wiki.

Демонстрация

[!TIP] Эта демонстрация запускается с докеризованной ОС. Если вы хотите попробовать сами, можете использовать образы Ubuntu или dockur для Windows

✨ Возможности

Мультисессионность: работа с несколькими обратными шеллами одновременно. Просмотр списка, переключение и перевод сессий в фон без их потери.
Обновление до PTY: преобразование сырого шелла в полноценный PTY (в Linux через script/socat, в Windows через обфусцированный ConPtyShell) для автодополнения по Tab, пересылки Ctrl+C и изменения размера терминала.
Модули: автоматизация задач постэксплуатации, передачи файлов, перечисления, пивотинга, сбора данных AD и многого другого. Легко расширяются вашими собственными модулями.
Обфускатор: встроенный обфускатор полезной нагрузки с цепочками техник (XOR, hex, строки формата, массивы символов) для обхода Defender и EDR-решений.
Исходящее подключение: connect ssh user@host превращает уже имеющиеся у вас учётные данные в сессию. ssh лишь доставляет полезную нагрузку, поэтому шелл продолжает жить после завершения ssh.
Туннелирование: tunnel start <id> <cidr> превращает шелл в пивот уровня L3: пользовательский TCP-стек на цели (без root, без загружаемого бинарника, только Python) с маршрутами на вашей стороне. (документация)
Журналирование сессий: каждая сессия логируется автоматически. Воспроизведите любую сессию с помощью koireview. (документация)
MCP-сервер: предоставление ваших сессий и модулей LLM-клиенту, по умолчанию только для чтения, поставляется в составе ядра. (документация)
Режим для демонстрации экрана: маскирует IP- и MAC-адреса в выводе для безопасного показа экрана во время CTF или живых демонстраций.
Корректная обработка сигналов: Ctrl+Z переводит сессию в фон, Ctrl+C отправляет SIGINT на удалённую сторону и никогда не убивает ваш слушатель случайно.

[!NOTE] Теперь можно использовать Koi удалённо! Подробнее здесь

🚧 В разработке

Обход EDR: Koi обходит простые и средние EDR-решения, но более агрессивные среды (дорогие коммерческие EDR, сети с усиленным мониторингом) всё ещё могут обнаруживать активность. Рассматриваются дальнейшие улучшения (TLS-транспорт, HTTP C2).

🚀 Установка

# 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 — это прямой ярлык к модулю обфускатора.

koireview — это ваш способ просмотра журналов ваших сессий.

Для обновления:

pipx upgrade koi-handler

Подробнее см. в разделе Начало работы.

💻 Использование

Запуск слушателя

# Default: bind 0.0.0.0:4010
koi

# Custom host/port
koi --host 10.10.14.5 --port 9001
koi -p 9001

Попав внутрь, команда help выводит список всех команд. Полный справочник находится в CLI Reference, а работа с сессиями (теги, фоновый режим, режим screenable) — в Session Management.

Перехват шелла

Отправьте reverse shell самостоятельно или введите payloads *interface*, чтобы получить готовые payload'ы. Учтите, что это должен быть шелл терминального типа, поскольку Koi управляет linux sh, powershell и cmd.

Обход Windows Defender

Koi включает встроенный обфускатор payload'ов, помогающий обойти обнаружение Windows Defender. Можно объединять несколько техник, хотя XOR-кодирования и преобразований формата обычно достаточно. Имейте в виду, что наложение слишком большого числа слоёв может повредить payload и сделать его нечитаемым для целевой системы.

Обфускатор также работает для Linux payload'ов. Хотя в большинстве Linux-сред не запускается антивирусное ПО, однострочники на bash часто помечаются EDR-решениями, правилами IDS или отслеживаются blue team, следящими за известными паттернами reverse shell. Обфускация payload'а помогает оставаться незамеченным в некоторых усиленно защищённых средах.

Каждая техника и каждый поддерживаемый тип payload'а перечислены в Payloads & Obfuscation.

🔧 Обновление PTY

Сырые шеллы не имеют полноценной поддержки терминала: нет автодополнения по Tab, сломан Ctrl+C, искажённый вывод. Команда upgrade исправляет это:

koi> upgrade 1
  Shell #1 upgraded successfully.
koi> go 1
  # now a full PTY with proper terminal behaviour

Под капотом

Для Linux:

запускается простой python pty

python3 -c 'import pty; pty.spawn("/bin/bash")'

с TERM=xterm-256color и некоторой информацией о размере окна

Для Windows:

Я не стал делать вариант для CMD, но для powershell техника использует обфусцированный conptyshell для получения полноценной оболочки:

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

Цепочка резервных вариантов и детали для каждой ОС описаны в разделе Upgrading Sessions.

🧠 MCP

Koi может предоставлять свои сессии и модули через MCP, чтобы клиент LLM мог читать вашу таблицу сессий и управлять модулями без необходимости копировать и вставлять что-либо вручную.

# read-only: sessions, modules and logs
koi --mcp

# lets the model run commands and modules on targets
koi --mcp --mcp-allow-exec

Koi

Популярное