The Firmware Analysis and Comparison Tool (FACT)
The Firmware Analysis and Comparison Tool (formerly known as Fraunhofer's Firmware Analysis Framework (FAF)) is intended to automate most of the firmware analysis process.
It unpacks arbitrary firmware files and processes several analyses.
Additionally, it can compare several images or single files.
Furthermore, Unpacking, analysis and compares are based on plug-ins guaranteeing maximal flexibility and expandability.
More details and some screenshots can be found on our project page.
FACT is designed as a multiprocess application, the more Cores and RAM, the better.
10 GB disk space
10* GB disk space
python 3.6 - 3.9
OS see below
~ 10 GB required to set up FACT code, container and binaries. Additional space is necessary for result storage. That can be on a separate partition or drive.
It is possible to install FACT on any Linux distribution, but the installer is limited to
- Ubuntu 18.04, 20.04 (stable)
- Ubuntu 19.04 (experimental)
- Debian 9, 10 (experimental)
- Kali (tested on 2019.3 and 2019.4) (experimental)
- Fedora (tested on 31 and 33) (experimental)
FACT can be installed and run via docker. See the FACT_docker repo for more.
The traditional installation is generally wrapped in a single script. Some features can be selected specifically though. See INSTALL.md for details.
You can start FACT by executing the start_all_installed_fact_components scripts. The script detects all installed components automatically.
You can shut down the system by pressing Ctrl + c or by sending a SIGTERM to the start_all_installed_fact_components script.
FACT provides a REST API. More information can be found here.
FACT provides an optional basic authentication, role and user management. More information can be found here.
List of available community plug-ins and REST scripts
Thanks to @botlabsDev for providing a Vagrantfile to test and evaluate FACT.
The easiest way to contribute is writing your own plug-in. Our Developers Manual can be found here.
This project is partly financed by German Federal Office for Information Security (BSI) and others.
Publications / Presentations
We've been happy to show FACT in a number of BlackHat Arsenal sessions.
Firmware Analysis and Comparison Tool (FACT) Copyright (C) 2015-2020 Fraunhofer FKIE This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>. Some plug-ins may have different licenses. If so, a license file is provided in the plug-in's folder.