Fortinet 펌웨어 복호화 및 분석 도구
Fortinet 펌웨어(FortiGate/FortiWiFi FortiOS 이미지 및 테스트된 FortiAnalyzer/FortiManager KVM 설치 패키지)를 복호화하고 압축 해제하기 위한 단일 정적 Go 바이너리이자 라이브러리입니다. 지원되는 컨테이너, 파일시스템 및 암호화 방식은 제품, 버전 또는 CPU 아키텍처 플래그 없이 콘텐츠로부터 감지됩니다. 테스트된 제품, 패키지 유형 및 단계는 지원되는 펌웨어를 참조하십시오.
형식 및 암호화 리더는 Go로 구현되어 있습니다. 런타임에 openssl, xz, tar, cpio, mount/debugfs, 7z, binwalk, vmlinux-to-elf 또는 Python이 필요하지 않습니다. FortiOS config-secret 복호화와 FortiGuard PKCS#7 서명 검사도 포함되어 있습니다.
과거에는 하나의 펌웨어 이미지를 복호화하려면 여러 버전별 도구(forticrack, fgx, forticrack_v8, decrypt-fortigate-rootfs, ...) 중에서 올바른 것을 골라 OS 바이너리를 수동으로 연결해야 했습니다. fortitool은 이 모든 것을 하나의 명령으로 통합합니다.
GitHub releases에서 사용 중인 플랫폼용 아카이브를 다운로드하십시오. 각 릴리스에는 모든 사전 빌드된 바이너리 아카이브를 포함하는 SHA-256 체크섬 파일이 포함되어 있습니다. 아카이브의 압축을 풀고 fortitool(또는 fortitool.exe)을 PATH에 추가한 다음, fortitool version을 실행하여 설치된 태그를 확인하십시오.
또는 Go로 설치할 수 있습니다:
go install github.com/mosajjal/fortitool/cmd/fortitool@latest
소스에서 빌드:
git clone https://github.com/mosajjal/fortitool
cd fortitool
CGO_ENABLED=0 go build -o fortitool ./cmd/fortitool
CGO_ENABLED=0는 이 프로젝트가 약속하는 완전 정적 바이너리를 원할 경우 중요합니다. 이 옵션이 없으면 Go는 (사용되지 않는) net 리졸버를 위해 glibc에 링크합니다. file fortitool(「statically linked」라고 표시되어야 함) 또는 ldd fortitool(「not a dynamic executable」이라고 표시되어야 함)로 확인하세요.
fortitool decrypt -o outdir image.out # full pipeline, one command
fortitool inspect image.out # read-only format/support report
fortitool decrypt -o fmg image.out.kvm.zip # FAZ/FMG single-QCOW2 package
fortitool decrypt --boot-only -o boot faz.qcow2 # original boot files only
fortitool l1 -o out.img image.out # outer XOR layer only
fortitool rootfs -o out.gz kernel rootfs.gz # kernel is flatkc or vmlinuz
fortitool unpack -o outdir archive.tar.xz # generic gzip+tar / xz+tar
fortitool pkg inspect --content payload sig.x # verify a PKCS#7 signature
fortitool pkg scan datafs/ # classify files, find sigs
fortitool config decrypt --stdin < secret.txt # config-backup ENC secret
fortitool config decrypt --file secret.txt # file input without argv exposure
모든 명령에는 fortitool <command> -h를 통해 전체 설명, 플래그, 예제가 제공됩니다(또는 명령 목록을 보려면 fortitool -h를 실행하세요). 플래그는 위치 인자보다 앞에 와야 합니다 — Go의 flag 패키지는 getopt처럼 argv를 재배열하지 않습니다.
inspect는 하나의 이미지를 안정적이고 사람이 읽을 수 있는 field: value 줄로 보고합니다. decrypt와 동일한 L1, 디스크 레이아웃, 필수 멤버, rootfs 암호화 및 페이로드 분류 결정을 사용하지만, 아무것도 추출하거나 쓰지 않으며 복구된 키 자료를 절대 표시하지 않습니다. 읽을 수 있지만 일부만 인식된 이미지는 status: partial, last-successful-stage, unsupported-stage를 보고하고, 그 경계를 설명하는 것이 성공적인 검사이므로 종료 코드 0으로 종료합니다. 입력이 없거나 접근할 수 없으면 종료 코드 1로, 잘못된 플래그나 인자 개수는 종료 코드 2로 종료합니다.
decrypt와 unpack은 요청된 출력 디렉터리가 아직 존재하지 않을 때만 완성된 트리를 게시합니다. Linux는 원자적 무교체(no-replace) 이름 변경을 사용하고, 다른 플랫폼은 이름 변경 전에 최선의 존재 여부 확인을 수행합니다. 스테이징된 트리와 독립 실행형 복호화 파일은 호출하는 주체에게만 비공개입니다: Unix에서는 모드 0700 또는 0600, Windows에서는 보호된 사용자별 DACL입니다. 절대 경로 대상을 가진 아카이브 및 파일시스템 심볼릭 링크는 제한된 상대 링크로 재작성되므로, 추출된 링크는 호스트의 경로를 참조하는 대신 출력 트리 내부에 머무릅니다.
config 시크릿의 경우, 암호문이 프로세스 목록이나 셸 기록에 나타나지 않도록 --stdin 또는 --file을 사용하는 것이 좋습니다. 직접적인 fortitool config decrypt <base64-blob> 형식은 호환성을 위해서만 유지되며, 세 가지 입력 소스 중 정확히 하나만 허용됩니다. 입력은 1 MiB로 제한되며, 주변 공백은 잘리고, 남은 값은 비어 있지 않아야 하며 공백을 포함해서는 안 됩니다.
pkg inspect --content를 사용하면 래퍼에 최소 하나의 서명자가 포함되고 모든 SignerInfo가 페이로드에 대해 검증될 때만 검증이 성공합니다. 이는 PKCS#7 래퍼에 내장된 인증서를 사용하여 암호학적 무결성을 증명하지만, 신뢰할 수 있는 루트 CA에 대한 신뢰 체인을 검증하지는 않습니다.
지원 범위는 제품, 패키지 유형 및 처리 단계에 따라 다릅니다. FAZ/FMG 펌웨어 지원이 해당 제품의 구성 백업 시크릿이나 다른 Fortinet 제품에 대한 지원을 의미하지는 않습니다.
버전 3.0부터 8.0에 걸친 167개의 고유한 FortiOS 이미지를 테스트한 결과, 모든 이미지에서 L1/헤더 복구가 성공했으며 독립적인 디코더와 바이트 단위로 일치했습니다. 이는 해당 단계와 테스트된 집합에만 적용되며, 이후의 복호화 및 추출은 아래에 자세히 설명된 대로 형식에 따라 달라집니다.
| 계층 | 범위 | 상태 |
|---|---|---|
L1 .out 외부 암호 | 지원되는 FortiOS .out 레이아웃 | 위에서 설명한 167개 이미지 코퍼스 전반에서 검증됨; 실제 FWF-60E 7.4.7/7.4.10/7.4.11 출력은 독립 디코더와 바이트 단위로 동일함 |
| rootfs.gz — ChaCha20+RSA+AES-CTR 계열 | 7.4.1–7.4.11 (ARM + x86_64 분할) | ARM 경로는 실제 펌웨어와 바이트 단위로 동일함이 검증됨; x86_64 분할은 공개 분석 글에서 이식되었으며 합성 왕복 테스트로 검증되었고, 실제 x86 샘플에 대해서는 실행되지 않음 |
| rootfs.gz — ChaCha20 본문 (7.4.1–7.4.3 시기) | 시드에서 파생된 키/IV, 비-RFC7539 카운터 | fortigate-crypto/Bishop Fox에서 이식되었으며 합성 왕복 테스트로 검증되었고, 해당 시기의 실제 샘플에 대해서는 실행되지 않음 |
| rootfs.gz — XOR+RSA+{FORT-RC4,수정된-RC4} 계열 | 7.6.x, 8.0 | 공개 분석 글(fgx, forticrack_v8)에서 이식되었으며 합성 왕복 테스트로 검증되었고, 실제 샘플에 대해서는 실행되지 않음 |
| 디스크 이미지 레이아웃 | 어플라이언스 MBR+ext3 @512; QCOW2 VM 디스크; 고정 오프셋 볼륨 | 어플라이언스 경로는 실제 펌웨어와 바이트 단위로 동일함이 검증됨; QCOW2/파티션 및 ext4 extent 탐색은 합성 테스트로 검증되었고, 실제 FortiGate VM 이미지에 대해서는 실행되지 않음 |
| ext2/3 파일시스템 읽기 | FSoC3/ARM 어플라이언스 MBR+ext3 레이아웃 | 이중 간접 블록 매핑을 포함하여 실제 펌웨어와 바이트 단위로 동일함이 검증됨 |
| ext4 extent 매핑 읽기 | FortiOS 8.0 VM rootfs (xz 압축 ext4 이미지) | 합성 왕복 테스트만 수행되었으며, 실제 8.0 샘플을 사용할 수 없음 |
| tar/gzip/xz 압축 해제 | 모두 | 실제 펌웨어와 바이트 단위로 동일함이 검증됨 |
| PKCS#7 SignedData 검증 | 분리 서명(.x 파일), 이중 서명 포함 | 실제 서명된 엔진/DB 파일에 대해 두 서명자 체인 모두 검증됨 |
Config-secret ENC <base64> 복호화 | 모든 시기 | 레거시 하드코딩 AES-128 키는 최소 7.2.3까지 실제 장치 데이터에 대해 검증됨 (흔한 통념과 달리 6.2에서 교체된 적이 없음). >=7.4 (빌드 2731) AES-256-CBC 키는 init 모놀리식의 RE를 통해 복구되었으며 두 시기에 걸친 실제 장치 백업에 대해 검증됨 — 두 키 모두 내장되어 있음, Config-secret 키 참조 |
"검증됨"은 실제 펌웨어/설정 샘플에 대해 실행하고 출력이 바이트 단위로 동일하거나 의미상 올바른지 확인했음을 뜻합니다. 그 외의 모든 것은 문서화된, 동작하는 참조 구현을 충실히 이식한 것으로, 이 저장소의 테스트 스위트로 실행되지만 해당 특정 시기의 실제 샘플에 대해서는 아직 실행되지 않았습니다 — 실제 펌웨어로 검증한 패치를 환영합니다.
decrypt는 어플라이언스, QCOW2 및 고정 오프셋 디스크 레이아웃에서 지원되는 ext 파일시스템을 탐색합니다. Rootfs 컨테이너에는 gzip tar/CPIO 및 XZ CPIO/ext 파일시스템이 포함됩니다. Rootfs 압축 해제는 4 GiB로 제한됩니다.
FAZ/FMG KVM 설치 디스크는 베어 QCOW2 파일 또는 정확히 하나의 일반 QCOW2 파일을 포함하는 ZIP 패키지로 허용되며, ZIP 압축 해제 후 2 GiB로 제한됩니다. 이 디스크에는 L1 펌웨어 헤더가 없으며 flatkc 대신 vmlinuz를 사용합니다. 제품/버전 플래그는 필요하지 않습니다.
각 행은 FAZ_VM64_KVM 및 FMG_VM64_KVM .out.kvm.zip 설치 패키지로 모두 테스트되었습니다: 총 24개 패키지입니다. 모두 검사, 전체 추출 및 부팅 전용 추출을 완료했습니다. 아래의 릴리스/빌드 레이블은 파일명에서 가져온 것입니다. 오래된 파일명은 v5 또는 v6만 지정하며, 해당 마이너 릴리스 번호는 확인되지 않았습니다. 실제 이미지 엔드투엔드 실행에는 ZIP 패키지가 사용되었습니다. 베어 QCOW2 입력은 압축 해제 후 리더를 공유하며 합성 테스트로 별도로 검증됩니다.
| 릴리스/빌드 레이블 (FAZ 및 FMG 모두) | 메인 rootfs |
|---|---|
v5-build0383 | gzip/newc CPIO |
v5-build0786 | gzip/newc CPIO |
v5-build1247 | XZ/newc CPIO |
v5-build1821 | XZ/newc CPIO |
v6-build0485 | XZ/newc CPIO |
v6-build1565 | XZ/newc CPIO |
v6-build2689 | XZ/newc CPIO |
v7.0.16-build0710 | XZ/newc CPIO |
v7.2.12-build1721 | XOR로 보호된 커널, AES-128-CTR XZ/newc CPIO rootfs |
v7.4.11.M-build2804 | XOR로 보호된 커널, AES-128-CTR XZ/newc CPIO rootfs |
v7.6.7.M-build3737 | XOR로 보호된 커널, AES-128-CTR XZ/newc CPIO rootfs |
v8.0.1.F-build0189 | XOR로 보호된 커널, AES-128-CTR XZ/newc CPIO rootfs |
보호된 커널은 해당 x86-64 디컴프레서 스텁에서 복구한 자료를 사용하여
디코딩됩니다. Rootfs 후보는 추가된 평문 SHA-256 다이제스트를 통과하고
XZ/CPIO 검증을 완료해야 합니다. 이러한 검사는 키 선택을 확인하고
손상을 감지합니다. 다이제스트는 키가 적용되지 않으며 게시자 인증이나
의도적인 변조에 대한 보호를 제공하지 않습니다.
각 기본 init은 독립적인 libarchive 추출과 바이트 단위로 일치했습니다.
이 범위는 이러한 KVM 설치 패키지에 대한 것이며, FAZ/FMG 업그레이드
.out 파일, 하드웨어 어플라이언스 또는 기타 Fortinet 제품에는 해당하지 않습니다.
fortitool inspect FMG_VM64_KVM-v7.0.16-build0710-FORTINET.out.kvm.zip
fortitool decrypt -o fmg FMG_VM64_KVM-v7.0.16-build0710-FORTINET.out.kvm.zip
fortitool decrypt --boot-only -o boot faz.qcow2
fortitool unpack -o extensions boot/rootfs-ext.tar.xz
전체 FAZ/FMG 추출은 기본 루트 파일시스템을 rootfs/ 아래에 보존합니다.
중첩된 bin.tar.xz, lib.tar.xz, usr.tar.xz, migadmin.tar.xz 및
node-scripts.tar.xz 아카이브는 존재하는 경우 layers/rootfs/<archive-name>/
아래에 별도로 풀립니다. 추가 syntax.tar.xz,
rootfs-ext.tar.xz, docker.tar.xz 및 widgets.tar.gz 부트 아카이브는
layers/boot/<archive-name>/ 아래에 위치합니다. 원본 아카이브는 보존됩니다.
예를 들어, rootfs/bin/init과 layers/rootfs/bin.tar.xz/bin/init은
서로 다른 부트스트랩 및 애플리케이션 프로그램을 포함할 수 있습니다. 이 출력물은
정적 분석을 위해 두 버전을 모두 보존하며, 병합된 부팅 가능한
파일시스템을 나타내지 않습니다. 기존 FortiGate 추출은 계속해서 중첩
아카이브를 rootfs/로 병합합니다.