theZoo README

The project's README from github.com/ytisf/theZoo. As one markdown file: README.md.

theZoo - A Live Malware Repository

Contributions Welcome HitCount GitHub stars made-with-python

Logo

theZoo is a project created to make the possibility of malware analysis open and available to the public. Since we have found out that almost all versions of malware are very hard to come by in a way which will allow analysis, we have decided to gather all of them for you in an accessible and safe way. theZoo was born by Yuval tisf Nativ and is now maintained by Shahak Shalev.

theZoo is open and welcoming visitors!

If you are about to interact with our community please make sure to read our CODE-OF-CONDUCT.md prior to doing so. If you plan to contribute, first - thank you. However, do make sure to follow the standards on CONTRIBUTING.md.

Disclaimer

theZoo's purpose is to allow the study of malware and enable people who are interested in malware analysis (or maybe even as a part of their job) to have access to live malware, analyse the ways they operate, and maybe even enable advanced and savvy people to block specific malware within their own environment.

Please remember that these are live and dangerous malware! They come encrypted and locked for a reason! Do NOT run them unless you are absolutely sure of what you are doing! They are to be used only for educational purposes (and we mean that!) !!!

We recommend running them in a VM which has no internet connection (or an internal virtual network if you must) and without guest additions or any equivalents. Some of them are worms and will automatically try to spread out. Running them unconstrained means that you will infect yourself or others with vicious and dangerous malware!!!

Getting Started

Clone the repository with git clone https://www.github.com/ytisf/theZoo. Go to the directory and run pip install --user -r requirements.txt. This should install all latest requirements needed. In total can be "scripted" like so:

git clone https://www.github.com/ytisf/theZoo
cd theZoo
pip install --user -r requirements.txt

Start by running the console:

python theZoo.py

License

theZoo - the most awesome free malware database on the air Copyright (C) 2015-2021, Yuval Nativ, Lahad Ludar, 5fingers

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

You can also find more information in LICENSE.md.

License section does not apply to any of malicious samples in theZoo's repository which includes samples and source code, reversed or otherwise.

Documentation and Notes

Background

theZoo's objective is to offer a fast and easy way of retrieving malware samples and source code in an organized fashion in hopes of promoting malware research.

Root Files

Since version 0.42 theZoo has been undergoing dramatic changes. It now runs in both CLI and ARGVS modes. You can call the program with the same command line arguments as before. The current default state of theZoo runtime is the CLI. The following files and directories are responsible for the application's behaviour.

/conf - The conf folder holds files relevant to the particular running of the program but are not part of the application. You can find the EULA file in the conf and more.

/imports - Contains .py import files used by the rest of the application

/malware/Binaries - The actual malwares samples - be careful! These are very live.

/malware/Source - Malware source code.

Malware under the folder Original is supposed to be (NO PROMISES!) the original source of the malware that leaked. Malware under the folder Reversed is either reversed, decompiled or partially reconstructed.

Directory Structure:

Each directory is composed of 4 files:

Bugs and Reports

The repository holding all files is currently https://github.com/ytisf/theZoo

Submit Malware

Get the file you want to submit and just run python prep_file.py file_tosubmit.exe. It will create a directory for you. Then just submit that along with the changes to the conf/maldb.db so that we know which malware it is.

Change Log for v0.60:

Change Log for v0.50:

Change Log for v0.42:

Change Log for v0.43:

Change Log for v0.50:

Predicted Change Log for v1.0

Hopeful

If you have any suggestions or malware that you have indexed (in the manner laid out in the documentation) please send it to us to - thezoo-submissions [a-t] morirt [.d0t.] com - so we can add it for everyone's enjoyment.

Shout outs

theZoo (ytisf/theZoo)

Searching Database…

13.5K ·GitHub
Что это такое?theZoo — это публичный репозиторий с живыми образцами вредоносного ПО и их исходным кодом. Он собран для того, чтобы любой, кто интересуется анализом малвари, мог изучать настоящие образцы в упорядоченном и удобном виде.
Это просто свалка заражённых файлов или вокруг них есть полноценный инструмент?Инструмент есть: это консольное приложение на Python с базой данных, в которой можно искать, и оно обёрнуто вокруг упорядоченной коллекции зашифрованных бинарников вредоносного ПО и их исходников.
Как его запустить?Склонируйте репозиторий через git, выполните в папке pip install --user -r requirements.txt, затем запустите интерактивную консоль командой python theZoo.py.
Нужно ли что-то ещё, кроме Python?Нет — достаточно Python с pip; requirements.txt подтянет все библиотеки, которые нужны консоли.
Насколько опасно реально запускать эти образцы?Очень опасно. Образцы поставляются зашифрованными и заблокированными не просто так; в README настоятельно советуют запускать их только на виртуальной машине без доступа в интернет и без guest additions, потому что некоторые из них — черви, которые сами попытаются распространиться.
Это для профессиональных аналитиков или любопытному энтузиасту тоже подойдёт?И тем, и другим — проект рассчитан на всех, кто интересуется анализом вредоносного ПО: и на тех, кто делает это по работе, и на тех, кто хочет понять, как малварь устроена, или даже заблокировать конкретную угрозу в своей инфраструктуре. Только в образовательных целях.
Код распространяется под обычной open source лицензией?Сам фреймворк распространяется под GNU GPL v3, но эта лицензия явно не распространяется на вредоносные образцы — ни сами образцы, ни их исходный код под неё не подпадают.
Там только бинарники или можно почитать и исходный код малвари?И то, и другое. В /malware/Binaries лежат живые образцы, а в /malware/Source — код двух типов: Original (предположительно утёкший оригинальный исходник, но без гарантий) и Reversed (реверснутый, декомпилированный или частично восстановленный код).
Почему образцы зашифрованы, а пароль лежит отдельным файлом?Каждая запись — это зашифрованный ZIP-архив, рядом с которым хранятся его сумма SHA256, сумма MD5 и файл с паролем — так ничего не сможет сработать, пока вы сами осознанно его не распакуете.
Как искать по коллекции, когда консоль уже запущена?Начиная с версии v0.60 консоль ищет по базе данных SQLite3 в свободном стиле, а записи индексируются по платформе и архитектуре; те же опции работают и как обычные аргументы командной строки в режиме argv.
Creator
ytisf
Size
1.1 GB
Stars
13.5K
Age
12y
Commits · 90 Days