Communitygithub.com

auditing-uefi-firmware-with-chipsec

Utilisez Intel CHIPSEC pour évaluer la configuration du firmware de la plateforme, la protection en écriture de la mémoire flash SPI, le verrouillage du BIOS, l'état des variables SMM/SMRR et Secure Boot, dump la mémoire flash SPI et trier les variables UEFI pour détecter les menaces au niveau du firmware.

Qu'est-ce que auditing-uefi-firmware-with-chipsec ?

Cette compétence permet d'auditer la sécurité du firmware UEFI en utilisant le framework open-source CHIPSEC développé par Intel. Elle s'adresse aux ingénieurs en sécurité, aux analystes forensiques et aux administrateurs système qui doivent vérifier les protections de bas niveau d'une plateforme x86. CHIPSEC inspecte les registres matériels, les MSR, l'espace de configuration PCI, la mémoire flash SPI et les variables UEFI, puis exécute une suite de tests automatisés pour détecter les faiblesses de configuration. La compétence guide l'utilisateur à travers sept étapes clés : exécution de la suite complète de tests, vérification individuelle des modules de protection du firmware (bios_wp, spi_lock, smrr, smm, secureboot.variables), inspection des permissions d'accès à la mémoire flash SPI, dump de la mémoire flash pour analyse forensique hors ligne, énumération des variables UEFI, analyse limitée sans pilote noyau, et triage des résultats avec rapport. Elle couvre spécifiquement la technique MITRE ATT&CK T1542.001 (Pre-OS Boot: System Firmware) en vérifiant que les protections empêchant la modification non autorisée du firmware sont activées : verrouillage de la zone BIOS de la mémoire flash SPI (BIOS_CNTL BLE/SMM_BWP), verrouillage du descripteur flash (FLOCKDN), protection SMRAM/SMRR et protection des variables Secure Boot. L'outil est supporté sur Linux, Windows et depuis l'environnement UEFI shell. La compétence insiste sur l'utilisation responsable : CHIPSEC charge un pilote noyau qui peut lire/écrire des registres critiques et une mauvaise utilisation (surtout les modules d'écriture) peut endommager définitivement la machine. Il est impératif de ne l'exécuter que sur du matériel de test ou des systèmes explicitement autorisés.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mukul975/Anthropic-Cybersecurity-Skills/tree/main/skills/auditing-uefi-firmware-with-chipsec

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Auditer le firmware UEFI avec CHIPSEC

Utilisation autorisée uniquement : CHIPSEC charge un pilote noyau et lit/écrit des registres matériels de bas niveau, la mémoire flash SPI et le SMM. Exécutez-le uniquement sur des systèmes dont vous êtes propriétaire ou que vous êtes explicitement autorisé à évaluer, idéalement sur du matériel de test dédié. Une mauvaise utilisation (en particulier les modules d'écriture/modification) peut détruire une machine. N'exécutez jamais de modules capables d'écrire sur des systèmes de production.

Présentation

CHIPSEC est le framework d'évaluation de la sécurité de la plateforme open source créé par l'équipe de recherche sur les menaces avancées d'Intel. Il inspecte la configuration de sécurité de bas niveau du firmware et du matériel des plateformes x86 — la couche située sous le système d'exploitation où résident les bootkits et les implants de firmware. CHIPSEC charge un pilote noyau signé (Linux, Windows, ou peut fonctionner depuis l'environnement UEFI shell) pour lire et écrire les registres matériels, les registres spécifiques au modèle (MSR), l'espace de configuration PCI, la mémoire flash SPI et les variables UEFI, puis exécute une suite de tests automatisés qui vérifie si les verrous défensifs de la plateforme sont effectivement activés.

La menace à laquelle CHIPSEC répond est la technique MITRE ATT&CK T1542.001 — Pre-OS Boot: System Firmware : des adversaires qui modifient le firmware système (l'image BIOS/UEFI sur la mémoire flash SPI) pour obtenir un contrôle furtif, persistant et survivant au système d'exploitation. Les implants de firmware persistent après la réinstallation du système d'exploitation et le remplacement du disque et sont invisibles pour la plupart des EDR. La valeur de CHIPSEC réside dans la vérification des conditions préalables qui empêchent de tels implants : que la zone BIOS de la mémoire flash SPI est protégée en écriture (BIOS_CNTL BLE/SMM_BWP, plages protégées SPI), que le descripteur flash verrouille l'accès aux régions, que la SMRAM/SMRR est configurée et que les variables Secure Boot sont protégées. Il permet également de dumper la mémoire flash SPI pour une comparaison forensique hors ligne.

Sources : Projet Intel/CHIPSEC (https://github.com/chipsec/chipsec), documentation CHIPSEC (https://chipsec.github.io/).

Quand l'utiliser

  • Évaluation de base de la sécurité du firmware d'une nouvelle plateforme ordinateur portable/serveur ou d'une image de flotte
  • Vérification que la protection en écriture du BIOS et les verrous de la mémoire flash SPI sont correctement activés par le fabricant
  • Forensique du firmware : dumper la mémoire flash SPI pour la comparer à une image de référence connue
  • Validation de la protection des variables Secure Boot et de la protection du script de démarrage S3
  • Recherche de preuves d'un implant de firmware ou d'une mauvaise configuration qui en permettrait un

Prérequis

  • Accès physique ou administrateur/root à la plateforme x86 cible (Intel ou AMD)
  • Linux (root) ou Windows (Administrateur), ou un environnement UEFI shell
  • Capacité à charger un pilote noyau (Secure Boot peut nécessiter d'autoriser le pilote CHIPSEC, ou utiliser --no_driver pour des vérifications limitées)
  • Python 3.8+ et un compilateur C/outils de construction pour le module noyau sur Linux
  • Matériel de test dédié fortement recommandé

Installer CHIPSEC :

# Depuis PyPI
pip install chipsec

# Ou depuis les sources (construit le pilote d'aide noyau)
git clone https://github.com/chipsec/chipsec
cd chipsec
python setup.py install        # construit et installe, y compris le pilote Linux

# Vérifier
sudo chipsec_main --help
sudo chipsec_util --help

Objectifs

  • Exécuter la suite complète de tests automatisés de sécurité de la plateforme et interpréter les résultats PASS/FAIL/WARNING
  • Vérifier la protection en écriture du BIOS (BIOS_CNTL) et les plages protégées SPI
  • Vérifier que le descripteur flash SPI verrouille l'accès en lecture/écriture des régions
  • Vérifier les protections SMRAM/SMRR et des gestionnaires SMI
  • Vérifier la protection des variables Secure Boot et la protection du script de démarrage S3
  • Dumper la mémoire flash SPI et la décoder pour une analyse hors ligne
  • Énumérer les variables UEFI et détecter les entrées anormales/inattendues

Cartographie MITRE ATT&CK

ID de techniqueNomTactique
T1542.001Pre-OS Boot: System FirmwarePersistance / Défense Évasive

CHIPSEC défend contre T1542.001 en vérifiant que les contrôles empêchant la modification non autorisée du firmware sont activés. Un FAIL sur common.bios_wp (BIOS non protégé en écriture) ou chipsec.modules.common.spi_lock (descripteur flash déverrouillé) signifie qu'un attaquant disposant de privilèges OS pourrait réécrire la mémoire flash SPI et implanter un firmware persistant — exactement la condition préalable pour cette technique.

Flux de travail

Étape 1 : Exécuter la suite de tests automatisés complète

chipsec_main sans argument de module exécute toutes les vérifications de sécurité applicables pour la plateforme détectée et affiche un résumé des résultats PASS/FAIL/WARNING/INFORMATION.

sudo chipsec_main

# Sauvegarder la sortie lisible par machine pour le rapport/la comparaison
sudo chipsec_main -j results.json -x results.xml -l chipsec.log

Étape 2 : Exécuter les modules de protection du firmware de base individuellement

Le groupe de modules common contient les vérifications de sécurité indépendantes du fabricant. Exécutez le groupe ou des modules spécifiques :

# Exécuter tout le groupe common
sudo chipsec_main -m common

# Protection en écriture du BIOS : vérifie BIOS_CNTL BLE/SMM_BWP et les plages protégées SPI
sudo chipsec_main -m common.bios_wp

# Verrou du descripteur flash SPI (FLOCKDN) — les accès aux régions flash sont-ils verrouillés ?
sudo chipsec_main -m common.spi_lock

# Programmation SMRR — protège la SMRAM des attaques basées sur le cache
sudo chipsec_main -m common.smrr

# Protection en écriture du BIOS SMM
sudo chipsec_main -m common.smm

# Protection du script de démarrage S3 (contre les attaques de table de script de démarrage)
sudo chipsec_main -m common.uefi.s3bootscript

Étape 3 : Vérifier la protection des variables Secure Boot

# Vérifie que les variables UEFI Secure Boot sont correctement protégées
sudo chipsec_main -m common.secureboot.variables

# Pour tester activement la protection en écriture des variables (matériel de test UNIQUEMENT) :
sudo chipsec_main -m common.secureboot.variables -a modify

Étape 4 : Inspecter les permissions d'accès aux régions de la mémoire flash SPI

# Rapporter les régions de la mémoire flash SPI, le descripteur et les permissions d'accès
sudo chipsec_util spi info

# Vérifier le module de contrôle d'accès SPI
sudo chipsec_main -m common.spi_access

Étape 5 : Dumper la mémoire flash SPI pour une forensique hors ligne

Dumper la flash vous permet de décoder les volumes de firmware et de les comparer à une image OEM de référence.

# Dumper toute la mémoire flash SPI dans un fichier
sudo chipsec_util spi dump rom.bin

# Décoder l'image dumpée : extrait les volumes de firmware, fichiers, variables NVRAM, etc.
sudo chipsec_util decode rom.bin

Étape 6 : Énumérer et trier les variables UEFI

# Lister toutes les variables UEFI de l'interface runtime
sudo chipsec_util uefi var-list

# Lister les variables directement depuis l'image SPI (hors ligne)
sudo chipsec_util uefi var-find PK
sudo chipsec_util uefi var-read db <GUID> db.bin

# Décoder la structure du firmware UEFI
sudo chipsec_util uefi decode rom.bin

Étape 7 : Évaluation limitée sans pilote noyau

Lorsque le chargement du pilote est impossible (Secure Boot verrouillé), certaines vérifications peuvent encore être exécutées en lecture seule.

sudo chipsec_main -n            # --no_driver : ignorer les vérifications nécessitant le pilote
sudo chipsec_main -p <PLATEFORME> # forcer le code de plateforme si la détection automatique échoue

Étape 8 : Trier les résultats et rapporter

  • FAIL sur bios_wp / spi_lock → le firmware est réinscriptible depuis l'OS : risque élevé pour T1542.001.
  • FAIL sur secureboot.variables → la politique Secure Boot peut être falsifiée.
  • Comparez le spi dump avec l'image de référence du fabricant (hacher les volumes de firmware) pour détecter des modifications non autorisées.
  • Enregistrez la plateforme, la version du BIOS et chaque FAIL/WARNING avec les valeurs de registre pertinentes pour le rapport.

Outils et ressources

OutilObjectifSource
chipsec_mainSuite de tests automatisés de sécurité de la plateformehttps://github.com/chipsec/chipsec
chipsec_utilAccès manuel au matériel/firmware (spi, uefi, decode)https://chipsec.github.io/
UEFIToolAnalyse GUI/CLI des images UEFI dumpéeshttps://github.com/LongSoft/UEFITool
Binarly fwhuntRègles de chasse aux vulnérabilités/implants de firmwarehttps://github.com/binarly-io/fwhunt-scan
Guide Secure Boot UEFI de la NSARéférence de durcissementhttps://media.defense.gov/

Référence des modules principaux

ModuleVérifications
common.bios_wpBIOS_CNTL BLE / SMM_BWP et plages protégées SPI
common.spi_lockVerrou FLOCKDN du descripteur flash SPI
common.spi_accessPermissions de lecture/écriture des régions de la mémoire flash SPI
common.smrrProgrammation des registres de plage de gestion système
common.smmProtection en écriture du BIOS SMM
common.secureboot.variablesProtection des variables Secure Boot
common.uefi.s3bootscriptProtection du script de démarrage S3

Critères de validation

  • CHIPSEC installé et le pilote se charge (ou -n documenté si ce n'est pas le cas)
  • Suite complète chipsec_main exécutée avec sortie JSON/XML/log sauvegardée
  • Résultat de common.bios_wp interprété (état de la protection en écriture)
  • Résultat de common.spi_lock / spi_access interprété (verrou du descripteur)
  • Résultats des modules SMRR/SMM enregistrés
  • Protection des variables Secure Boot vérifiée
  • Mémoire flash SPI dumpée et décodée pour analyse hors ligne
  • Variables UEFI énumérées et triées
  • Tous les résultats FAIL/WARNING documentés avec la plateforme/version du BIOS
  • Modules d'écriture/modification NON exécutés sur du matériel de production

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

abusing-dpapi-for-credential-access

Extract and decrypt Windows DPAPI-protected secrets (Credential Manager, browser logins/cookies, Wi-Fi credentials, KeePass keys) online or offline using SharpDPAPI, SharpChrome, Mimikatz, or Impacket

abusing-shadow-credentials-for-privesc

Take over Active Directory accounts by writing attacker-controlled public keys to msDS-KeyCredentialLink (Shadow Credentials) with pyWhisker, Whisker, or Certipy, then authenticate via PKINIT to recover the target

achieving-cmmc-level-2-compliance

>-

acquiring-disk-image-with-dd-and-dcfldd

Create forensically sound bit-for-bit disk images with dd or dcfldd on a Linux forensic workstation, preserving evidence integrity through hash verification (MD5/SHA) during acquisition. Use when imaging a suspect drive, USB device, or memory card for investigation, preserving volatile disk evidence during incident response, or producing a verified copy for legal or law-enforcement proceedings before any destructive analysis.

analyzing-active-directory-acl-abuse

Detect dangerous ACL misconfigurations in Active Directory using ldap3

analyzing-android-malware-with-apktool

Perform static analysis of Android APK malware using apktool for resource decompilation, jadx for Java source recovery, and androguard for manifest inspection, dangerous permission-combination detection, and identification of obfuscated code, dynamic code loading, and reflection-based API calls. Use to statically triage a suspicious APK without executing it or to build mobile malware detection rules.

analyzing-api-gateway-access-logs

Parses API Gateway access logs (AWS API Gateway, Kong, Nginx) to detect

analyzing-apt-group-with-mitre-navigator

Query ATT&CK data with attackcti, mitreattack-python, and stix2, then build MITRE ATT&CK Navigator layers and multi-layer heatmap overlays mapping one or more APT groups

analyzing-azure-activity-logs-for-threats

Queries Azure Monitor activity logs and sign-in logs via azure-monitor-query

analyzing-bootkit-and-rootkit-samples

Analyzes bootkit and advanced rootkit malware infecting the Master

analyzing-browser-forensics-with-hindsight

Parse Chromium-based browser databases with Hindsight to extract and correlate browsing history, downloads, cookies, cached content, autofill data, saved passwords, and extensions from Chrome, Edge, Brave, Opera, and Vivaldi into a unified timeline (XLSX, JSON, or SQLite output). Use during incident response, insider-threat investigations, or criminal cases when you need to reconstruct a user

analyzing-campaign-attribution-evidence

Systematically evaluate cyber-campaign evidence to attribute an operation to a threat actor, using the Diamond Model and Analysis of Competing Hypotheses (ACH) to weigh infrastructure overlaps, TTP consistency, malware code similarity, and timing/language artifacts into confidence-weighted attribution assessments. Use when an incident investigation needs a defensible attribution confidence level.

analyzing-certificate-transparency-for-phishing

Monitor Certificate Transparency logs using crt.sh and Certstream to

analyzing-cloud-storage-access-patterns

Detect abnormal access in AWS S3, GCS, and Azure Blob Storage by analyzing CloudTrail Data Events, GCS audit logs, and Azure Storage Analytics for after-hours bulk downloads, new-IP access, and API-call spikes (e.g. GetObject) via statistical baselines and time-series anomaly detection. Use when investigating suspected cloud data exfiltration or building related detection rules.

analyzing-cobalt-strike-beacon-configuration

Extract and analyze Cobalt Strike beacon configuration from PE files

analyzing-cobaltstrike-malleable-c2-profiles

Parse and analyze Cobalt Strike Malleable C2 profiles with dissect.cobaltstrike (profiles and beacon-payload configs) and pyMalleableC2 (AST parsing) to extract HTTP/DNS transforms, URIs, headers, sleep/jitter, and injection behavior, then generate network detection signatures. Use when reverse-engineering a captured malleable profile or building detections against Cobalt Strike Beacon traffic.

analyzing-command-and-control-communication

Analyzes malware C2 communication over HTTP, HTTPS, DNS, and custom

analyzing-cyber-kill-chain

Analyzes intrusion activity against the Lockheed Martin Cyber Kill Chain

analyzing-disk-image-with-autopsy

Perform comprehensive forensic analysis of raw (dd), E01, or AFF disk images with Autopsy and The Sleuth Kit, recovering deleted files, examining metadata and embedded artifacts, keyword searching, and building investigation timelines with visual reports. Use for structured analysis of a forensic disk image or when stakeholders need visual reports from evidence.

analyzing-dns-logs-for-exfiltration

Analyzes DNS query logs to detect data exfiltration via DNS tunneling,

Skills associés