Outils de déchiffrement et d'analyse du firmware Fortinet
Un binaire Go statique unique et une bibliothèque pour déchiffrer et décompresser les firmware Fortinet : images FortiGate/FortiWiFi FortiOS et packages d'installation KVM FortiAnalyzer/FortiManager testés. Les conteneurs, systèmes de fichiers et schémas cryptographiques pris en charge sont détectés à partir de leur contenu, sans indicateur de produit, de version ou d'architecture CPU. Voir Firmware pris en charge pour les produits, types de packages et étapes testés.
Les lecteurs de format et de cryptographie sont implémentés en Go. Aucun openssl, xz, tar, cpio, mount/debugfs, 7z, binwalk, vmlinux-to-elf ou Python n'est requis à l'exécution. Le déchiffrement du secret de configuration FortiOS et l'inspection des signatures PKCS#7 FortiGuard sont également inclus.
Historiquement, déchiffrer une image de firmware impliquait de choisir le bon outil parmi plusieurs outils spécifiques à une version (forticrack, fgx, forticrack_v8, decrypt-fortigate-rootfs, ...) et d'enchaîner manuellement des binaires du système d'exploitation. fortitool regroupe tout cela en une seule commande.
Téléchargez l'archive correspondant à votre plateforme depuis les
versions GitHub. Chaque version
inclut un fichier de somme de contrôle SHA-256 couvrant toutes les archives de binaires précompilés.
Extrayez l'archive, placez fortitool (ou fortitool.exe) dans votre PATH, et
exécutez fortitool version pour confirmer le tag installé.
Alternativement, installez avec Go :
go install github.com/mosajjal/fortitool/cmd/fortitool@latest
Ou compiler depuis les sources :
git clone https://github.com/mosajjal/fortitool
cd fortitool
CGO_ENABLED=0 go build -o fortitool ./cmd/fortitool
CGO_ENABLED=0 est important si vous voulez le binaire entièrement statique que ce projet
promet — sans cela, Go se lie à la glibc pour le résolveur réseau (inutilisé).
Vérifiez avec file fortitool (devrait indiquer "statically linked") ou
ldd fortitool (devrait indiquer "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
Chaque commande dispose d'une description complète, de ses options et d'exemples via
fortitool <command> -h (ou exécutez fortitool -h pour obtenir la liste des commandes).
Les options doivent précéder les arguments positionnels — le paquet flag de Go ne
permute pas argv comme le fait getopt.
inspect rapporte une image sous forme de lignes stables et lisibles champ: valeur.
Il applique les mêmes décisions de classification L1, de disposition sur disque, de membres requis, de chiffrement du rootfs et de charge utile que decrypt, mais n'extrait ni n'écrit rien
et n'affiche jamais le matériel de clé récupéré. Une image lisible qui n'est que
partiellement reconnue rapporte status: partial, un last-successful-stage et
un unsupported-stage, et se termine avec le code 0 car décrire cette frontière constitue
une inspection réussie. Une entrée absente ou inaccessible se termine avec le code 1 ; des options ou un nombre d'arguments invalides se terminent avec le code 2.
decrypt et unpack ne publient une arborescence complète que lorsque le répertoire
de sortie demandé n'existe pas déjà. Linux utilise un renommage atomique sans remplacement ;
les autres plateformes effectuent une vérification d'existence au mieux avant le
renommage. Les arborescences préparées et les fichiers déchiffrés autonomes sont privés à
l'identité appelante : mode 0700 ou 0600 sous Unix, et une DACL par utilisateur protégée
sous Windows. Les liens symboliques d'archive et de système de fichiers avec des cibles absolues sont réécrits
en liens relatifs confinés, afin que les liens extraits restent à l'intérieur de l'arborescence de sortie
plutôt que de faire référence à des chemins sur l'hôte.
Pour les secrets de configuration, préférez --stdin ou --file afin que le texte chiffré
n'apparaisse pas dans les listes de processus ou l'historique du shell. La forme directe
fortitool config decrypt <base64-blob> reste disponible uniquement pour
compatibilité, et exactement une des trois sources d'entrée est acceptée.
L'entrée est limitée à 1 MiB ; les espaces environnants sont supprimés, et la
valeur restante doit être non vide et ne contenir aucun espace.
Avec pkg inspect --content, la vérification ne réussit que lorsque le wrapper
contient au moins un signataire et que chaque SignerInfo est validé par rapport à la
charge utile. Cela prouve l'intégrité cryptographique à l'aide des certificats intégrés
dans le wrapper PKCS#7 ; cela ne valide pas leurs chaînes de confiance jusqu'à une
autorité de certification racine de confiance.
La couverture est spécifique au produit, au type de paquet et à l'étape de traitement. La prise en charge des firmwares FAZ/FMG n'établit pas la prise en charge de leurs secrets de sauvegarde de configuration ni celle d'autres produits Fortinet.
Sur 167 images FortiOS uniques testées, avec des versions allant de 3.0 à 8.0, la récupération L1/en-tête a réussi pour chaque image et correspondait octet pour octet à un décodeur indépendant. Cela couvre uniquement cette étape et cet ensemble testé ; le déchiffrement et l'extraction ultérieurs restent dépendants du format, comme détaillé ci-dessous.