FACT extractor

概述

FACT extractor 是一个独立工具，封装了 FACT 解包插件，能够提取大多数常见容器格式。

命令行使用

如果已运行 Docker，最快的使用方法：

sh
docker pull fkiecad/fact_extractor
wget [***]
chmod +x extract.py
./extract.py ./relative/or/absolute/path/to/your/file

查看更多选项：

sh
./extract.py --help

本地安装（非Docker方式）

安装命令：

bash
fact_extractor/install/pre_install.sh
fact_extractor/install.py

⚠️ 我们不再支持 Ubuntu 16.04 和 Python 3.5（不过稍作调整可能仍能运行）

安装后可通过以下命令运行工具：

bash
fact_extractor/fact_extract.py [OPTIONS] PATH_TO_FIRMWARE

该工具设计时考虑了 Docker 使用。因此，它会将所有文件提取到配置中指定的目录，该目录还包含元数据报告。安装过程中会创建所需目录，若修改配置，请确保重新创建文件夹结构。结构如下：

text
<数据文件夹路径>
├── files
└── reports

直接使用Docker容器

构建镜像：

bash
docker build -t fact_extractor .

（可将 fact_extractor 替换为自定义镜像ID）

Docker 执行设计为可使用单个共享目录作为容器的输入和输出。在主机系统上准备如下结构的共享文件夹：

text
<共享文件夹路径>
├── files
├── input
│   └── firmware_file
└── reports

其中 firmware_file 是您要解包的文件。

运行提取命令：

bash
docker run -v <共享文件夹路径>:/tmp/extractor -v /dev:/dev --privileged --rm fact_extractor

⚠️ 注意：容器以特权模式运行，并共享 /dev 文件夹。因此，该容器可能会对您的系统造成潜在危害。

贡献

最简单的贡献方式是编写自己的插件。开发者手册可在 此处 找到。

致谢

本项目部分由 德国联邦信息安全办公室（BSI） 等资助。

许可证

    固件分析与比较工具（FACT）提取器
    版权所有 (C) 2015-2019 弗劳恩霍夫研究所 FKIE

    本程序是自由软件：您可以根据自由软件基金会发布的 GNU 通用公共许可证（版本 3 或更高版本）重新分发和/或修改它。

    本程序的发布旨在希望它能有用，但不提供任何明示或暗示的担保，包括但不限于适销性和特定用途适用性的担保。有关更多详情，请参见 GNU 通用公共许可证。

    您应该已收到本程序随附的 GNU 通用公共许可证副本。如果没有，请参见 <[***]>。

    某些插件可能有不同的许可证。如有，插件文件夹中会提供许可证文件。