Skip to content

User_Documentation

Maximilian Wagner edited this page Jul 13, 2021 · 12 revisions

User Documentation

Authentication

Before accessing EMBArk register yourself with username and password:
curl -XPOST 'http://0.0.0.0:8000/signup' -d '{"email": "[email protected]", "password": "test", "confirm_password": "test"}' Then you can enter your credentials to login on the Authentication page.

Screenshot-2021-07-13-at-17-45-05-Screenshot

Navigation

The navigation is done via left sidebar, featuring logout at the bottom. The following sites are accessable:

Main Dashboard

Compressed and aggregated data for overview and performance done by emba. This includes (but not limited to):

  • Common Vulnerabilities and Exposures - CVEs
  • Binary Protections - CVEs
  • Architecture and OS Distribution
  • Top strcpy binaries
  • Server Load Graph

Screenshot-2021-07-13-at-17-44-25-EMBArk

Uploading / Analyzing Dashboard

Uploading and Deleting on the left side.

  • Upload via drag and drop or via explicitly selecting the file from system
  • Delete Firmware by selecting the firmware and accepting dialogs Starting and adapting the analysis on the right side.
  • User can select from the previouse uploaded firmwares to start the detached emba analyze process
  • Have a look at the expert flags, activated by slider to fit your means
  • Have a look at the description, activated by slider, for clarification on options

Screenshot-2021-07-13-at-17-45-18-EMBArk

Service Dashboard

The analyze step is completely detached from other User interactions.
Nevertheless users can observe the current status of each emba application:

  • current progress
  • executing stage
  • current module being processed

Screenshot-2021-07-13-at-17-56-10-EMBArk

Report Dashboard

Summary of all firmwares ever analyzed by emba.
Search and Sortable Table to easily find wanted reports. Actions on completed firmware analysis:

  • Ability to open Individual Report for each analysis
  • Ability to open html report generated by emba
  • Ability to download report generated by emba

Screenshot-2021-07-13-at-17-45-37-EMBArk

Embark Individual Report

The individual Report lists all relevant information about each firmware, as well as some charts for visualization.

Emba HTML Report

Emba generates a html reports, which can either be downloaded or inspected directed in the browser from the Report Dashboard. There you can dive deep into analysis.

Screenshot-2021-07-13-at-18-08-18-Emba-firmware-report