EMBArk - The firmware security scanning environment

О проекте

EMBArk — это инструмент для централизованного анализа прошивок. Сканируй, идентифицируй, отслеживай, сообщай. Создан быть простым, но мощным. Это веб-интерфейс корпоративного уровня для сканера безопасности прошивок EMBA. Он разработан для предоставления анализатора безопасности прошивок EMBA как сервиса с многофункциональным пользовательским интерфейсом и для улучшения доступности бэкенда сканирования прошивок EMBA независимо от системы и операционной системы. Кроме того, EMBArk улучшает предоставление данных, агрегируя различные результаты сканирования в агрегированной панели управления.

Важно

• Новое приложение Tracking в настоящее время не работает в автономном режиме.
• Отслеживание устройств, вендоров и версий ещё не полностью интегрировано во все панели управления.
• Единственная поддерживаемая ОС на данный момент — Ubuntu LTS (24)

Быстрый старт

git clone https://github.com/e-m-b-a/embark.git; cd embark; sudo ./installer.sh -d

sudo ./run-server.sh [-a <IP/HOSTNAME>] [-b <IP/RANGE>] [-i <HOST-IP>] [-h]

Пример:

Чтобы запустить сервер на хосте с ipv4 192.168.126.123 и получить доступ к управлению из любой точки этой подсети

sudo ./run-server.sh -a 192.168.126.123 -b 192.168.126.1/24

Автоматическая установка на Ubuntu 24 LTS

1. Склонируйте репозиторий (например, git clone https://github.com/e-m-b-a/embark.git)
2. Перейдите в корневой каталог репозитория: cd embark
3. Выполните sudo ./installer.sh -d для установки по умолчанию.
4. Дополнительные сведения доступны в вики (см. installation)

EMBArk использует сканер безопасности прошивок EMBA в качестве бэкенда. Вы можете посмотреть репозиторий EMBA и получить больше информации об использовании EMBA в вики. Кроме того, вам стоит ознакомиться с вики EMBArk.

Запуск сервера

Для запуска EMBArk-сервера просто выполните $ sudo ./run-server.sh. Это запустит http-сервер на 0.0.0.0:80

Примечание: имя сервера по умолчанию — "embark.local", и его необходимо разрешать через файлы hosts или DNS-сервер.
Если вы хотите обращаться к серверу по IP-адресу или другому имени хоста, используйте опцию -a (поддерживается несколько значений). Для доступа к страницам администратора извне localhost используйте опцию -b.

Обновление

• Используйте export-DB.sh для резервного копирования вашей базы данных
• Просто выполните pull и перезапустите
• Обычно обновление НЕ требует переустановки (переустановка удалит все файлы и базу данных полностью)

Разработчикам

Для разработчиков мы рекомендуем просто использовать: sudo ./installer.sh -F и скрипт ./dev-tools/debug-server-start.sh.

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

Обратитесь к документации Swagger UI, где представлен REST API.

Участие в проекте

Интернет вещей растёт, разработка продолжается, и есть много новых функций, которые мы хотим добавить. Мы приветствуем pull requests и сообщения об ошибках или запросы функций через issues на GitHub.

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

Этот проект изначально был инициирован компанией Siemens Energy как AMOS project в сотрудничестве с FAU.

Смотрите также оригинальный EMBArk AMOS project и AMOS.