Skip to content

User Documentation

Michael Messner edited this page Aug 22, 2021 · 20 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"}'
Afterwards you should be able to use 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 - NX, Canaries, RELRO, ...
  • Architecture and OS Distribution
  • Top strcpy binaries
  • Server Load Graph

images/aggregated_dashboard_01.png images/aggregated_dashboard_02.png images/aggregated_dashboard_03.png

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

images/firmware_upload_01.png images/firmware_upload_02.png

Service Dashboard

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

  • current progress
  • executing stage
  • current module being processed

images/scan_status.png

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

images/report_overview.png

Embark Individual Report

The individual Report lists relevant details about the tested firmware, as well as some charts for visualization.

images/detail_report_01.png images/detail_report_02.png

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

Clone this wiki locally