
firmware-analysis-toolkit v2.0.0-alpha.1
Plataforma de pesquisa de segurança de firmware que combina análise binária, rastreamento de taint e emulação em IoT, IA de borda, dispositivos móveis e robótica.
FAT — Firmware Analysis Toolkit
Baixe a versão mais recente · Changelog · Instalação
Firmware Analysis Toolkit é um toolkit de pesquisa de segurança para investigar a segurança de firmware em IoT, Physical AI, Dispositivos Móveis e Robótica. Ele foi construído principalmente para o treinamento "Offensive IoT Exploitation" conduzido pela Attify.
Ele foi construído com base na experiência prática real de campo sobre o que realmente importa quando se trata de investigações reais de segurança de firmware que fazem diferença.
O objetivo do FAT não é apenas construir um toolkit excepcional de classe mundial e de ponta para Pesquisa de Segurança de Firmware, mas também formar profissionais e praticantes que atuam em seu auge, onde a ferramenta se torna um superpoder cognitivo se usada de certas maneiras, sendo ao mesmo tempo simples o suficiente para ser usada por aqueles que são novos na área.
Alguns dos recursos incluem classificação de firmware desconhecido, extração de sistemas de arquivos, mapeamento de código relevante para confiança, rastreamento de taint e coordenação da emulação QEMU.
O que o FAT pode analisar
- Blobs e diretórios desconhecidos: containers, membros comprimidos, regiões de alta entropia, sinais de MCU e arquivos candidatos a firmware
- Imagens de firmware: cabeçalhos, envelopes de atualização, partições, bootloaders e diferenças entre imagens
- Imagens de flash BMC: metadados de hash/assinatura FIT, marcadores OpenBMC/MegaRAC, ambientes U-Boot válidos por CRC, recuperação nativa de JFFS2 e perfis explícitos de emulação de flash completo/kernel de fornecedor
- Sistemas de arquivos Linux extraídos: inventário, intenção de inicialização, binários que carregam confiança, material criptográfico e evidências em strings
- Binários ELF: importações, exportações, tabelas de handlers, sinks de código stripped, descompilação e taint de origem a sink
- Imagens bare-metal e de MCU: tabelas de vetores, mapas de memória, indícios de periféricos, autoridade de escrita em flash e evidências de handoff de boot
- Artefatos de Edge AI: arquivos MAGIK/JZDL, TFLite, ONNX e Qualcomm DLC, além de runtimes de inferência visíveis
- Aplicações Android: inventário de APK, pistas de descoberta, localidade, cadeias de capacidade e limites de handoff
- Repositórios de código-fonte: consultas de invariantes, orientação para patches e buscas por variantes próximas
Início rápido
Baixe um pacote binário em Releases, que já contém os dados de runtime correspondentes em share/fat, ou instale o executável a partir do crates.io com o Cargo:
# Fast path: fetch the prebuilt archive for this platform (requires cargo-binstall).
cargo binstall firmware-analysis-toolkit
# From source: compiles the full dependency tree (Rust 1.91 or newer plus a C compiler).
cargo install --locked firmware-analysis-toolkit
O Cargo instala apenas o executável fat. Instale o pacote de dados de runtime para a versão instalada uma vez; --release baixa o fat-data-<version>.zip correspondente, verifica seu SHA-256 e o ativa:
fat data install --release
fat doctor
Compilando este checkout (desenvolvimento, ou para os recursos listados em Unreleased):
git clone --branch v2.1.0 --depth 1 https://github.com/attify/firmware-analysis-toolkit.git
cd firmware-analysis-toolkit
cargo build --release --locked
cargo install --path crates/fat_cli --locked
python3 scripts/build-runtime-data-bundle.py --output ./dist/fat-data.zip
fat data install --archive ./dist/fat-data.zip
fat doctor
No Arch Linux ou Omarchy, comece com os passos de instalação do Arch para pacotes de pré-requisitos e ferramentas opcionais.
Instalador One-Shot para hosts suportados:
./scripts/install.sh --install-system-deps
Consulte INSTALL.md para opções de instalador e ferramentas opcionais.
Para recursos listados em Unreleased, use --branch master no comando de clone acima. A inspeção de BMC e a recuperação nativa de JFFS2 foram adicionadas após v2.0.1.
Referência Rápida de Comandos
- Ajuda :
fat -h - Identificar um firmware:
fat $firmwareoufat identify --file $firmware - Inspecionar flash de BMC:
fat inspect bmc --file $firmware - Novo Projeto :
fat new $firmware - Extrair sistema de arquivos :
fat extract $firmware - Analisar :
fat analyze $firmware - Emulação :
fat emulate --project $firmware
Primeiro contato com um arquivo desconhecido
fat ./firmware.bin
fat inspect update --file ./firmware.bin --rootfs ./rootfs --reference ./older.bin
fat ./firmware.bin é uma forma abreviada de fat identify --file ./firmware.bin.
Ele fornece uma visão geral compacta da identidade e da estrutura do arquivo.
Adicione --details para tabelas de suporte.
Para imagens de MCU brutas, inspecione o mapeamento, a inicialização, as interrupções e o hardware:
fat inspect mcu --file ./firmware.bin
fat inspect mcu --file ./firmware.bin --details
Para imagens de flash BMC, inspecione o layout, os metadados de autenticação FIT e os ambientes armazenados:
fat inspect bmc --file ./flash.mtd
fat inspect bmc --file ./flash.mtd --details
Ambos os fluxos de trabalho de inspeção suportam --json para o relatório completo de análise estruturada.
A inspeção de BMC também suporta --sarif --fail-on-warning para CI. As assinaturas FIT são reportadas como metadados armazenados; a validade criptográfica e a aplicação no arranque de hardware não são testadas.
Execute os serviços BMC suportados com fat emulate --project <project> --pack bmc-romulus ou com o perfil explícito de kernel de fornecedor ASUS. Liste os perfis com fat rehost profiles list; consulte BMC emulation para hashes de entrada, adaptações, verificações Redfish e depuração.
Para contas de laboratório descartáveis, fat debug redfish-session verifica a aplicação da função ReadOnly e a revogação de sessão com um controlo positivo de administrador. fat debug process liga-se a um daemon convidado através de SSH e registra a sua identidade e limpeza. Consulte BMC session and process debugging para configuração e os resultados Romulus/ASUS.
A extração nativa reconstrói ficheiros JFFS2 antes de inspecionar conteúdo comprimido aninhado. Consulte Inspecting BMC firmware para o fluxo de trabalho de extração, requisitos de armazenamento sensível a maiúsculas e minúsculas, saída SARIF e substituições de ambiente.
Imagem para Runtime
O pipeline do Quick start, de ponta a ponta:
fat new ./firmware.bin
fat extract .fat-projects/firmware
fat analyze .fat-projects/firmware
fat preflight .fat-projects/firmware
fat emulate --project .fat-projects/firmware