Home

Awesome

EMBArk - The firmware security scanning environment <br>

<p align="center" style="margin:25px;"> <img src="./embark/static/content/images/header.png" alt="" width="100%"/> </p> <p align="center"> <a href="https://github.com/e-m-b-a/embark/blob/master/LICENSE"><img src="https://img.shields.io/github/license/e-m-b-a/embark?label=License"></a> <img src="https://img.shields.io/badge/python-3.7+-blue.svg"> <a href="https://github.com/e-m-b-a/embark/stargazers"><img src="https://img.shields.io/github/stars/e-m-b-a/embark?label=Stars"></a> <a href="https://github.com/e-m-b-a/embark/network/members"><img src="https://img.shields.io/github/forks/e-m-b-a/embark?label=Forks"></a> <a href="https://github.com/e-m-b-a/embark/graphs/contributors"><img src="https://img.shields.io/github/contributors/e-m-b-a/embark?color=9ea"></a> <a href="https://twitter.com/intent/tweet?text=Check%20out%20EMBArk%20-%20The%20Firmware%20security%20scanning%20environment!%20https://github.com/e-m-b-a/embark"><img src="https://img.shields.io/twitter/url.svg?style=social&url=https%3A%2F%2Fgithub.com%2Fe-m-b-a%2Fembark"></a> </p>

About

EMBArk is a tool for centralized firmware analyzing. Scan, Identify, Track, Report. Built to be simple but powerful. It's the web-based enterprise interface for the firmware security scanner EMBA. It is developed to provide the firmware security analyzer EMBA as a service with feature-packed UI and to improve accessibility to the firmware scanning backend EMBA regardless of the system and operating system. Furthermore, EMBArk improves the data provision by aggregating the various scanning results in an aggregated management dashboard.

Watch EMBArk

Important

Quick-Start

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>] [-h]

Example:

To start the server on the host with the ipv4 192.168.126.123 and get management access from anywhere in that subnet

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

Automated setup on Ubuntu 22.04 LTS

  1. Checkout the repository (e.g. git clone https://github.com/e-m-b-a/embark.git)
  2. Change directory to root of the repository i.e cd embark
  3. Run sudo ./installer.sh -d to run the default installation.
  4. Further details are available in the wiki (See installation)

EMBArk is using the firmware security scanner EMBA as backend. You can take a look at the EMBA repository and get more information about usage of EMBA in the wiki. Additionally you should check the EMBArk wiki.

Start Server

To start the EMBArk-Server simply run $ sudo ./run-server.sh. This starts the http-Server on 0.0.0.0:80

Note: The default server name is "embark.local" and has to be resolved via host files or a DNS-server.
If you want to query the server using an IP or other hostname please use the -a option. (multiple inputs supported) To access the admin pages from outside localhost use the -b option.

Upgrading

Developer

For developers, we recommend simply using: sudo ./installer.sh -F and the ./dev-tools/debug-server-start.sh script.

Get involved

The IoT is growing, the development is ongoing, and there are many new features that we want to add. We welcome pull requests and bug reports or feature requests via issues on GitHub.

Acknowledgement

This project was originally initiated by Siemens Energy as AMOS project in cooperation with the FAU.

See also the original EMBArk AMOS project and AMOS.