Если вы хотите изменить/разрабатывать Artemis, сначала прочитайте раздел Разработка.

Artemis — экспериментальное программное обеспечение, находящееся в активной разработке; используйте на свой страх и риск.

Чтобы пообщаться об Artemis, присоединяйтесь к серверу Discord!

Сотрудничество и конференции

Artemis был представлен на BlackHat USA 2024 в Лас-Вегасе и BlackHat Europe 2025 в Лондоне. Для получения дополнительной информации об Artemis на BlackHat нажмите здесь и здесь.

Проект также был представлен на 71-й встрече TF-CSIRT в Копенгагене, 69-й встрече TF-CSIRT в Бухаресте и на конференции CONFidence, а также на других мероприятиях.

Сотрудничество

Разработка Artemis была поддержана программой Google Summer of Code 2024 и 2025.

Возможности

Актуальный список возможностей см. в документации. Самая важная из них — возможность легко экспортировать отчёты, такие как:

Следующие адреса содержат данные системы контроля версий:

• https://subdomain1.example.com:443/.git/

Публикация репозитория кода может позволить злоумышленнику узнать внутреннее устройство системы, а если в нём содержатся пароли или ключи API — также получить несанкционированный доступ. Такие данные не должны быть общедоступны.

Следующие адреса содержат старые версии Joomla:

• https://subdomain2.example.com:443 - Joomla 2.5.4

Если сайт больше не используется, мы рекомендуем его отключить, чтобы исключить риск эксплуатации известных уязвимостей в старых версиях Joomla. В противном случае мы рекомендуем регулярно обновлять ядро Joomla и плагины.

Возможность автоматически готовить такие отчёты позволила нам уведомить организации в нашем регионе ответственности о сотнях тысяч уязвимостей.

Скриншоты

Разработка

Чтобы запустить локально изменённую версию Artemis, выполните:

Этот скрипт автоматически копирует пример файла окружения (env.example) в .env, если он не существует. Затем вы можете настроить параметры в файле .env в соответствии с вашими потребностями. Это включает настройку User-Agent путём установки переменной CUSTOM_USER_AGENT, а также других соответствующих параметров. Полный список переменных конфигурации и их описания см. в разделе «Конфигурация» документации.

Затем образ Artemis собирается локально (из разрабатываемого вами кода), а не загружается из Docker Hub. Для контейнера web вы также сможете видеть результаты изменений кода на странице без перезагрузки всего контейнера.

Тесты

Чтобы запустить тесты, используйте:

[!WARNING] Избегайте прямого вызова python -m unittest, так как command: в docker-compose.test.yaml работает иначе. Когда Python запускается как PID 1, подпроцессы, особенно бинарники Go, такие как Nuclei, страдают от медленного или ухудшенного ввода-вывода, поскольку PID 1 обрабатывает сигналы и stdout/stderr по-другому. Вместо этого используйте unittest-parallel, так как его рабочие процессы избегают проблемы PID 1.

Форматирование кода

Artemis использует pre-commit для запуска линтеров и форматирования кода. pre-commit выполняется в CI, чтобы убедиться, что код отформатирован правильно.

Чтобы запустить его локально, используйте:

Чтобы настроить pre-commit так, чтобы он запускался перед каждым коммитом, используйте:

Изменение зависимостей

Мы используем pip-tools для управления зависимостями. Чтобы добавить или обновить зависимость:

1. Измените requirements.in (или docs/requirements.in для зависимостей документации),
2. Запустите ./scripts/compile-requirements, чтобы сгенерировать замороженные файлы requirements.txt,
3. Закоммитьте оба файла — .in и .txt.

Сборка документации

Чтобы собрать документацию, используйте:

Как написать собственный модуль?

Обратитесь к документации.

Участие в разработке

Вклад приветствуется! Мы будем признательны как за идеи новых модулей Artemis (добавленные как GitHub issues), так и за пул-реквесты с новыми модулями или улучшениями кода.

Как бы это ни было очевидно, мы любезно напоминаем, что, внося вклад в Artemis, вы соглашаетесь с тем, что лицензия BSD 3-Clause автоматически применяется к вашему вкладу без необходимости каких-либо дополнительных заявлений.

Разработка

Перед открытием PR, пожалуйста, убедитесь, что вы установили pre-commit:

• pre-commit install

И запустили его для своих изменений.

Участники

Огромное спасибо следующим людям, которые внесли вклад в разработку Artemis, особенно научному кружку KN Cyber Варшавского политехнического университета, который инициировал проект!