Полноценный инструментируемый фреймворк для эмуляции двоичного кода
[](https://docs.qiling.io)
[](https://pepy.tech/project/qiling)
[](https://t.me/qilingframework)
---
<p align="center">
<img width="150" height="150" src="https://assets.kitploit.com/production/public/readmes/3159/adf57fddbda367ffba0fd5d69ca8efee6d89d296269a38dba5d23e4feeda22d8/67a3885438f12bafd77a6df1d19c4a79a6b63eb2d3044f2e1e046e634c1af49a-display-v1.webp">
</p>
[Сценарии использования Qiling, блог и связанные работы](https://github.com/qilingframework/qiling/issues/134)
Qiling — это продвинутый фреймворк для эмуляции бинарных файлов, обладающий следующими возможностями:
- Эмуляция нескольких платформ: Windows, macOS, Linux, Android, BSD, UEFI, DOS, MBR.
- Эмуляция нескольких архитектур: 8086, X86, X86_64, ARM, ARM64, MIPS, RISC-V, PowerPC.
- Поддержка множества форматов файлов: PE, Mach-O, ELF, COM, MBR.
- Поддержка драйверов Windows (.sys), модулей ядра Linux (.ko) и macOS (.kext) через [Demigod](https://groundx.io/demigod/).
- Эмуляция и изоляция кода в изолированной среде.
- Полностью настраиваемая песочница.
- Детализированные API на уровне памяти, регистров, ОС и файловой системы.
- Тонкая инструментация: возможность установки хуков на различных уровнях (инструкция/базовый блок/доступ к памяти/исключение/системный вызов/ввод-вывод и т.д.).
- API уровня виртуальной машины, такие как сохранение и восстановление текущего состояния выполнения.
- Поддержка отладки с перекрёстной архитектурой и платформой.
- Встроенный отладчик с возможностью обратной отладки.
- Динамическое «горячее» патчирование выполняемого кода на лету, включая загруженные библиотеки.
- Полноценный фреймворк на Python, упрощающий создание собственных инструментов анализа безопасности.
Qiling также был представлен на различных международных конференциях.
2022:
- [Black Hat, EU](https://www.blackhat.com/eu-22/arsenal/schedule/#reversing-mcu-with-firmware-emulation-29553)
- [Black Hat, MEA](https://blackhatmea.com/node/724)
2021:
- [Black Hat, USA](https://www.blackhat.com/us-21/arsenal/schedule/index.html#bringing-the-x-complete-re-experience-to-smart-contract-24119)
- [Hack In The Box, Amsterdam](https://conference.hitb.org/hitbsecconf2021ams/sessions/when-qiling-framework-meets-symbolic-execution/)
- [Black Hat, Asia](https://www.blackhat.com/asia-21/arsenal/schedule/index.html#qiling-smart-analysis-for-smart-contract-22643)
2020:
- [Black Hat, Europe](https://www.blackhat.com/eu-20/arsenal/schedule/index.html#qiling-framework-deep-dive-into-obfuscated-binary-analysis-21781)
- [Black Hat, USA](https://www.blackhat.com/us-20/arsenal/schedule/index.html#qiling-framework-from-dark-to-dawn-----enlightening-the-analysis-of-the-most-mysterious-iot-firmware--21062)
- [Black Hat, USA (Demigod)](https://www.blackhat.com/us-20/briefings/schedule/#demigod-the-art-of-emulating-kernel-rootkits-20009)
- [Black Hat, Asia](https://www.blackhat.com/asia-20/arsenal/schedule/index.html#qiling-lightweight-advanced-binary-analyzer-19245)
- [Hack In The Box, Lockdown 001](https://conference.hitb.org/lockdown-livestream/)
- [Hack In The Box, Lockdown 002](https://conference.hitb.org/hitb-lockdown002/virtual-labs/virtual-lab-qiling-framework-learn-how-to-build-a-fuzzer-based-on-a-1day-bug/)
- [Hack In The Box, Cyberweek](https://cyberweek.ae/2020/lab-qiling-framework/)
- [Nullcon](https://nullcon.net/website/goa-2020/speakers/kaijern-lau.php)
2019:
- [DEFCON, USA](https://www.defcon.org/html/defcon-27/dc-27-demolabs.html#QiLing)
- [Hitcon](https://hitcon.org/2019/CMT/agenda)
- [Zeronights](https://zeronights.ru/report-en/qiling-io-advanced-binary-emulation-framework/)
Qiling работает на базе [Unicorn Engine](http://www.unicorn-engine.org).
Посетите наш [веб-сайт](https://www.qiling.io) для получения дополнительной информации.
---
#### Лицензия
Эта программа является свободным программным обеспечением; вы можете распространять и/или изменять её в соответствии с условиями Стандартной общественной лицензии GNU, опубликованной Фондом свободного программного обеспечения; либо версии 2 Лицензии, либо (по вашему выбору) любой более поздней версии.
---
#### Qiling против других эмуляторов
Существует множество эмуляторов с открытым исходным кодом, но два проекта, наиболее близкие к Qiling: [Unicorn](http://www.unicorn-engine.org) и [QEMU user mode](https://qemu.org). В этом разделе объясняются основные различия между Qiling и ними.
##### Qiling против Unicorn engine
Построенный на основе Unicorn, но Qiling и Unicorn — это две разные сущности.
- Unicorn — это просто эмулятор ЦП, поэтому он фокусируется на эмуляции инструкций ЦП, которые могут понимать память эмулятора. Помимо этого, Unicorn не знает о концепциях более высокого уровня, таких как динамические библиотеки, системные вызовы, обработка ввода-вывода или исполняемые форматы, такие как PE, Mach-O или ELF. В результате Unicorn может эмулировать только сырые машинные инструкции без контекста операционной системы (ОС).
- Qiling спроектирован как фреймворк более высокого уровня, использующий Unicorn для эмуляции инструкций ЦП, но понимающий ОС: в нём есть загрузчики исполняемых форматов (для PE, Mach-O и ELF в настоящее время), динамические компоновщики (чтобы мы могли загружать и перемещать общие библиотеки), обработчики системных вызовов и ввода-вывода. По этой причине Qiling может запускать исполняемые двоичные файлы без необходимости в их родной ОС.
##### Qiling против QEMU user mode
Режим пользователя QEMU делает нечто подобное нашему эмулятору, а именно эмулирует целые исполняемые двоичные файлы кроссплатформенным способом. Однако Qiling предлагает несколько важных отличий от QEMU user mode:
- Qiling — это настоящий фреймворк для анализа, который позволяет создавать на его основе собственные инструменты динамического анализа (на Python). В то же время QEMU — это просто инструмент, а не фреймворк.
- Qiling может выполнять динамическую инструментацию и даже «горячее» патчирование кода во время выполнения. QEMU не умеет ни того, ни другого.
- Qiling не только работает с разными архитектурами, но и является кроссплатформенным. Например, вы можете запустить файл ELF для Linux в среде Windows. Напротив, режим пользователя QEMU запускает только двоичные файлы той же ОС, например, Linux ELF на Linux, из-за способа перенаправления системных вызовов из эмулируемого кода в родную ОС.
- Qiling поддерживает больше платформ, включая Windows, macOS, Linux и BSD. Режим пользователя QEMU может обрабатывать только Linux и BSD.
---
#### Установка
Пожалуйста, обратитесь к [руководству по установке](https://github.com/qilingframework/qiling/wiki/Installation) для получения информации о том, как установить Qiling Framework.
---
#### Примеры
Приведённый ниже пример демонстрирует наиболее простой способ использования Qiling framework для эмуляции исполняемого файла Windows.
```python
from qiling import Qiling
if __name__ == "__main__":
# initialize Qiling instance, specifying the executable to emulate and the emulated system root.
# note that the current working directory is assumed to be Qiling home
ql = Qiling([r'examples/rootfs/x86_windows/bin/x86_hello.exe'], r'examples/rootfs/x86_windows')
# start emulation
ql.run()
```
- Следующий пример показывает, как crackme для Windows может быть динамически пропатчен, чтобы всегда отображать диалог «Congratulation».
```python
from qiling import Qiling
def force_call_dialog_func(ql: Qiling):
# get DialogFunc address from current stack frame
lpDialogFunc = ql.stack_read(-8)
# setup stack memory for DialogFunc
ql.stack_push(0)
ql.stack_push(1001) # IDS_APPNAME
ql.stack_push(0x111) # WM_COMMAND
ql.stack_push(0)
# push return address
ql.stack_push(0x0401018)
# resume emulation from DialogFunc address
ql.arch.regs.eip = lpDialogFunc
if __name__ == "__main__":
# initialize Qiling instance
ql = Qiling([r'rootfs/x86_windows/bin/Easy_CrackMe.exe'], r'rootfs/x86_windows')
# NOP out some code
ql.patch(0x004010B5, b'\x90\x90')
ql.patch(0x004010CD, b'\x90\x90')
ql.patch(0x0040110B, b'\x90\x90')
ql.patch(0x00401112, b'\x90\x90')
# hook at an address with a callback
ql.hook_address(force_call_dialog_func, 0x00401016)
ql.run()
```
На видео ниже показано, как работает приведённый выше пример.
#### Эмуляция прошивки маршрутизатора ARM на хосте Ubuntu x64
Qiling Framework «горяче» патчит и эмулирует `/usr/bin/httpd` маршрутизатора ARM на хосте Ubuntu x86_64.
[](https://www.youtube.com/watch?v=e3_T3KLh2NU)
#### Плагин IDA Pro для Qiling: Инструментация и расшифровка секрета Mirai
На этом видео показано, как плагин IDA Pro для Qiling позволяет запускать IDA Pro с движком инструментации Qiling.
[](http://www.youtube.com/watch?v=ZWMWTq2WTXk)
#### Демонстрация GDB sever с IDA Pro
Решение простой задачи CTF с помощью Qiling Framework и IDA Pro.
[Solving a simple CTF challenge with Qiling Framework and IDA Pro](https://www.youtube.com/watch?v=SPjVAt2FkKA)
#### Эмуляция MBR
Qiling Framework эмулирует MBR
[](https://github.com/qilingframework/theme.qiling.io/blob/master/source/img/mbr.png?raw=true)
---
#### Qltool
Qiling также предоставляет удобный инструмент под названием `qltool` для быстрой эмуляции шеллкода и исполняемых двоичных файлов.
С помощью qltool можно легко выполнять:
С шеллкодом:
```
$ ./qltool code --os linux --arch arm --format hex -f examples/shellcodes/linarm32_tcp_reverse_shell.hex
```
С двоичным файлом:
```
$ ./qltool run -f examples/rootfs/x8664_linux/bin/x8664_hello --rootfs examples/rootfs/x8664_linux/
```
С двоичным файлом и включённым отладчиком GDB:
```
$ ./qltool run -f examples/rootfs/x8664_linux/bin/x8664_hello --gdb 127.0.0.1:9999 --rootfs examples/rootfs/x8664_linux
```
Со сбором покрытия кода (только для UEFI на данный момент):
```
$ ./qltool run -f examples/rootfs/x8664_efi/bin/TcgPlatformSetupPolicy --rootfs examples/rootfs/x8664_efi --coverage-format drcov --coverage-file TcgPlatformSetupPolicy.cov
```
С выводом в JSON (в основном для Windows):
```
$ ./qltool run -f examples/rootfs/x86_windows/bin/x86_hello.exe --rootfs examples/rootfs/x86_windows/ --console False --json
```
---
#### Контакты
Получайте последнюю информацию на нашем веб-сайте https://www.qiling.io
Свяжитесь с нами по электронной почте [email protected],
через Twitter [@qiling_io](https://twitter.com/qiling_io).
---
#### Основные разработчики, ключевые участники и прочее
Пожалуйста, обратитесь к [CREDITS.md](https://github.com/qilingframework/qiling/blob/dev/CREDITS.md).