Идентификация и извлечение прошивок IoT
Идентификация и извлечение прошивок IoT
moria идентифицирует файлы и структуры, встроенные в прошивки и образы IoT (файловые системы, ядра, загрузчики, архивы, ключи), и распаковывает большую часть найденного — без root. Каждая находка сопровождается байтовым смещением, типом и оценкой уверенности, а вывод в чистом JSON позволяет скриптам и LLM-агентам управлять инструментом так же легко, как и людям.
upx -d.openat + O_NOFOLLOW (без обхода путей и выхода через символические ссылки), а распаковка ограничена против бомб.-j) для инструментов, со смещениями и уверенностью для каждой находки.cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j
cmake --install build --prefix ~/.local # or /usr/local (needs sudo)
Для сборки нужны cmake, компилятор C++20 и библиотеки разработки zlib, liblzma, lz4 и zstd (декомпрессоры, используемые --extract). В Debian/Ubuntu: sudo apt install cmake g++ zlib1g-dev liblzma-dev liblz4-dev libzstd-dev. Чтобы собрать без одной из них (минимальная сборка или сборка только для идентификации), настройте с -DMORIA_OPTIONAL_CODECS=ON, и отсутствующий кодек просто будет отключён.
Бинарный файл moria самодостаточен: все наборы сигнатур встраиваются во время сборки, поэтому бинарный файл работает где угодно без чего-либо установленного рядом (cp build/moria ~/.local/bin достаточно, а скачанный релизный бинарный файл просто запускается). Чтобы использовать внешние сигнатуры вместо встроенных (например, чтобы протестировать новый .toml без пересборки), передайте --sigs DIR или задайте $MORIA_SIGDIR.
По умолчанию вывод удобочитаем. Передайте -j для JSON.
moria <file> # identify: a findings tree with offsets, types, and confidence
moria <dir> # scan a tree: a type summary plus the notable files
moria -j <file> # JSON, for tools and agents
moria -e <file> # extract to <file>.extracted/ (-C DIR to choose the output dir)
moria -c <file> # carve raw byte ranges to <file>.carved/ (no parsing)
moria -E <file> # entropy pass: flag unidentified / possibly-encrypted regions
moria --list <archive> # list tar/cpio/zip/cab/CE-ROM members without extracting
moria --broad <path> # also load the ~2.5k general file-type signatures
moria --unpack-executables # unpack executables inside other extracted output (cfbf/msi files)
moria --help
-e распаковывает распознанные форматы в <file>.extracted/, по одному каталогу на регион (0x<offset>-<type>/), плюс manifest.json, сопоставляющий смещения путям. Он автоматически рекурсивно обрабатывает вложенные контейнеры и пересобирает образы UBI том за томом. Ограничители (--depth, --max-files, --max-bytes и лимит коэффициента распаковки) сдерживают враждебный ввод; сработавший ограничитель останавливает эту ветку и всё равно возвращает всё восстановленное.
Распаковка выполняется в процессе, без внешних инструментов и без sudo:
.msi, ISO 9660, Android sparse, Android boot.hv)signatures/ — написанное вручную ядро: файловые системы прошивок, контейнеры, ядра и распространённые форматы, каждый со структурной валидацией.signatures-firmware/ содержит магические числа контейнеров прошивок производителей и загружается по умолчанию.signatures-generated/ содержит ~2,5 тыс. магических чисел общих типов файлов, полученных из базы магических чисел file(1), и загружается только с --broad.Чтобы добавить формат, поместите .toml в signatures/. Небольшой валидатор на C++ нужен только для проверок, которые не выразить декларативным слоем, например CRC или указатели между блоками. Семантика полей (magic_offset, порядок байтов магического числа, короткие сигнатуры, мягкие ограничения, контракт валидатора) описана в SIGAUTHORING.md.
moria выполняет структурную идентификацию, извлечение и карвинг. Сканирование секретов/учётных данных, SBOM, анализ CVE и лицензий — это отдельный инструмент (mithril).
MIT, см. LICENSE.
Часть обработки дисковых форматов представляет собой чистую перереализацию алгоритмов из других open-source проектов, написанную независимо поверх собственного слоя ввода-вывода moria (исходный код не копировался): декомпрессор UCL/NRV2B и CTO-фильтры из UPX/UCL (GPL-2.0, только алгоритмы), а также раскладка metadata-commit и CTZ skip-list из littlefs (BSD-3-Clause) и раскладка страниц/объектов SPIFFS (MIT).