
firmware-analysis-toolkit v2.0.0-alpha.1
펌웨어 보안 연구 플랫폼으로, IoT, 엣지 AI, 모바일 기기 및 로봇 분야에서 바이너리 분석, 오염 추적(taint tracing), 에뮬레이션을 결합합니다.
FAT — 펌웨어 분석 툴킷
최신 릴리스 다운로드 · 변경 로그 · 설치
Firmware Analysis Toolkit은 IoT, Physical AI, 모바일 기기 및 로보틱스의 펌웨어 보안을 조사하기 위한 보안 연구 툴킷입니다. 주로 Attify에서 진행하는 "Offensive IoT Exploitation" 교육을 위해 만들어졌습니다.
실제 펌웨어 보안 조사에서 정말로 중요한 것이 무엇인지에 대한 현장 실무 경험을 바탕으로 구축되었습니다.
FAT의 목표는 펌웨어 보안 연구를 위한 세계 최고 수준의 뛰어난 최첨단 툴킷을 만드는 것뿐만 아니라, 특정 방식으로 사용할 경우 도구가 인지적 초능력이 되는 최고의 역량을 발휘하는 전문가와 실무자를 양성하는 것이며, 동시에 이 분야에 처음 입문한 사람들도 쉽게 사용할 수 있도록 하는 것입니다.
주요 기능으로는 알 수 없는 펌웨어 분류, 파일시스템 추출, 신뢰 관련 코드 매핑, 오염(taint) 추적, QEMU 에뮬레이션 조정 등이 있습니다.
FAT가 분석할 수 있는 대상
- 알 수 없는 블롭 및 디렉터리: 컨테이너, 압축된 멤버, 고엔트로피 영역, MCU 신호, 후보 펌웨어 파일
- 펌웨어 이미지: 헤더, 업데이트 봉투, 파티션, 부트로더, 이미지 간 차이
- BMC 플래시 이미지: FIT 해시/서명 메타데이터, OpenBMC/MegaRAC 마커, CRC 검증된 U-Boot 환경, 네이티브 JFFS2 복구, 명시적 전체 플래시/벤더 커널 에뮬레이션 프로필
- 추출된 Linux 파일시스템: 인벤토리, 시작 의도, 신뢰 관련 바이너리, 암호화 자료, 문자열 증거
- ELF 바이너리: 임포트, 익스포트, 핸들러 테이블, 스트립된 코드 싱크, 디컴파일, 소스-투-싱크 오염 분석
- 베어메탈 및 MCU 이미지: 벡터 테이블, 메모리 맵, 주변장치 힌트, 플래시 쓰기 권한, 부트 핸드오프 증거
- 엣지 AI 아티팩트: MAGIK/JZDL, TFLite, ONNX, Qualcomm DLC 파일 및 가시적인 추론 런타임
- Android 애플리케이션: APK 인벤토리, 발견 단서, 로컬리티, 기능 체인, 핸드오프 경계
- 소스 저장소: 불변식 쿼리, 패치 가이드, 인접 변형 검색
빠른 시작
일치하는 share/fat 런타임 데이터가 이미 포함된 바이너리 번들을 Releases에서 다운로드하거나, Cargo를 사용하여 crates.io에서 실행 파일을 설치하세요:
# 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
Cargo는 fat 실행 파일만 설치합니다. 설치된 버전에 맞는 런타임 데이터 번들을 한 번 설치하세요. --release는 일치하는 fat-data-<version>.zip을 다운로드하고, 해당 파일의 SHA-256을 검증한 뒤 활성화합니다:
fat data install --release
fat doctor
이 체크아웃을 빌드하기 (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
Arch Linux 또는 Omarchy에서는 필수 패키지와 선택적 도구를 위해 Arch 설치 단계부터 시작하십시오.
지원되는 호스트를 위한 원샷 설치 프로그램:
./scripts/install.sh --install-system-deps
설치 프로그램 옵션과 선택적 도구에 대해서는 INSTALL.md를 참조하십시오.
Unreleased에 나열된 기능을 사용하려면 위의 클론 명령에서 --branch master를 사용하십시오. BMC 검사와 네이티브 JFFS2 복구는 v2.0.1 이후에 추가되었습니다.
빠른 명령 참조
- 도움말 :
fat -h - 펌웨어 식별:
fat $firmware또는fat identify --file $firmware - BMC 플래시 검사:
fat inspect bmc --file $firmware - 새 프로젝트 :
fat new $firmware - 파일 시스템 추출 :
fat extract $firmware - 분석 :
fat analyze $firmware - 에뮬레이션 :
fat emulate --project $firmware
알 수 없는 파일과의 첫 접촉
fat ./firmware.bin
fat inspect update --file ./firmware.bin --rootfs ./rootfs --reference ./older.bin
fat ./firmware.bin은 fat identify --file ./firmware.bin의 축약형입니다.
파일의 정체성과 구조에 대한 간결한 개요를 제공합니다.
지원 테이블을 보려면 --details를 추가하세요.
원시 MCU 이미지의 경우 매핑, 시작, 인터럽트 및 하드웨어를 검사하세요:
fat inspect mcu --file ./firmware.bin
fat inspect mcu --file ./firmware.bin --details
BMC 플래시 이미지의 경우 레이아웃, FIT 인증 메타데이터 및 저장된 환경을 검사합니다:
fat inspect bmc --file ./flash.mtd
fat inspect bmc --file ./flash.mtd --details
두 검사 워크플로 모두 전체 구조화 분석 보고서를 위해 --json을 지원합니다.
BMC 검사는 또한 CI를 위해 --sarif --fail-on-warning을 지원합니다. FIT 서명은 저장된 메타데이터로 보고되며, 암호학적 유효성과 하드웨어 부팅 적용 여부는 테스트되지 않습니다.
지원되는 BMC 서비스를 fat emulate --project <project> --pack bmc-romulus 또는 명시적 ASUS 벤더 커널 프로필로 실행하십시오. 프로필 목록은 fat rehost profiles list로 확인할 수 있으며, 입력 해시, 적응, Redfish 검사 및 디버깅에 대해서는 BMC 에뮬레이션을 참조하십시오.
일회용 랩 계정의 경우, fat debug redfish-session은 관리자 양성 대조를 통해 ReadOnly 역할 적용 및 세션 폐기를 검사합니다. fat debug process는 SSH를 통해 게스트 데몬에 연결하여 해당 데몬의 신원과 정리 작업을 기록합니다. 설정 및 Romulus/ASUS 결과에 대해서는 BMC 세션 및 프로세스 디버깅을 참조하십시오.
네이티브 추출은 중첩된 압축 콘텐츠를 검사하기 전에 JFFS2 파일을 재구성합니다. 추출 워크플로, 대소문자 구분 저장소 요구 사항, SARIF 출력 및 환경 재정의에 대해서는 BMC 펌웨어 검사를 참조하십시오.
이미지에서 런타임까지
빠른 시작의 파이프라인을 처음부터 끝까지 살펴보면 다음과 같습니다:
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
바이너리 트리아지 및 데이터 흐름
fat r2-triage --file ./usr/sbin/httpd --json
fat taint --file ./www/cgi-bin/diag.cgi --summary
fat taint-query --file ./www/cgi-bin/diag.cgi
fat taint-cross --rootfs ./rootfs
fat taint-cross --rootfs ./rootfs --source-profile ./my-target-models.yaml --state-profile ./my-target-state.yaml
셸 스크립트 데이터 흐름
fat taint --lang shell --file ./app/init/wifi.sh --summary
fat taint --lang shell --rootfs ./extracted-rootfs --json
fat taint --lang shell --rootfs ./extracted-rootfs --source-profile ./my-target-shell.yaml --severity high
스트립된 바이너리
정적으로 싱크를 찾은 다음, 동일한 주소에 대한 런타임 훅을 준비합니다:
fat r2-triage --file ./usr/sbin/httpd --json
fat sink-discovery --file ./usr/sbin/httpd --json > sinks.json
fat handler-table --file ./usr/sbin/httpd --json > handlers.json
fat taint --file ./usr/sbin/httpd --sink-candidates sinks.json --json > taint.json
fat instrument-hooks --from-sinks sinks.json --output hooks.yaml
fat emulate --project .fat-projects/firmware --instrument hooks.yaml
파일시스템 전체 증거 수집
fat tree --rootfs ./rootfs --profile inventory --summary --json
fat search --rootfs ./rootfs --profile credentials -I --context 2
fat startup-map --rootfs ./rootfs --profile cloud-tls
fat crypto-census --rootfs ./rootfs
fat trust-map --rootfs ./rootfs
소스 기반 불변식 쿼리
fat invariant query \
--fixture tests/fixtures/query/source/invariant-permission \
--rule 'Every privileged override method must call enforcePermission()'
fat patch check --help
fat verify --help
보안
- 에뮬레이션은 신뢰할 수 없는 벤더 코드를 실행합니다.
- 신뢰할 수 없는 이미지를 처리하거나 에뮬레이션된 서비스를 네트워크에 노출하기 전에 SECURITY.md를 검토하십시오.
- 작업 대상에 대한 권한을 확보하는 것은 사용자의 책임입니다.