Warum USB-Boot auf einem gesperrten Gerät?

Sichere Feldgeräte sperren im Produktivzustand bewusst Zugriffe: USB-Serial-Download und Fastboot sind deaktiviert, die UART-Konsole ist zu, der Bootloader akzeptiert nur signierte Images. Das ist richtig so - jeder dieser Pfade wäre sonst ein Einfallstor. Aber Fertigung und Service brauchen einen Recovery-Pfad: Was, wenn ein Gerät nicht mehr bootet oder ein neues Image eingespielt werden muss, ohne das Gehäuse zu öffnen?

Die Antwort ist ein USB-Recovery-Boot, der die Sicherheitskette nicht aufweicht: Ein signiertes System wird vom FAT-USB-Stick geladen und durchläuft dieselbe HAB-Signaturprüfung wie der normale Boot. Schlägt die Prüfung fehl, wird nicht gebootet. Dieser Artikel beschreibt einen solchen Spike auf einem i.MX6-basierten Energie-Feldgerät mit U-Boot 2024.01 - inklusive der Probleme, die erst auf echter Hardware auftauchten.

Die Leitfrage des Spikes: Kann der Controller überhaupt von USB booten, und lässt sich die HAB-Authentifizierung in den Autoboot-Pfad integrieren, ohne sie zu umgehen? Beides wurde auf der Hardware demonstriert; einige Punkte bleiben offen und werden unten ehrlich benannt.

Der Umfang war bewusst eng: die bestehende U-Boot-Umgebung erweitern, die bestehende Authentifizierung wiederverwenden und dokumentieren, was auf echter Hardware passiert. Kein neuer Bootloader, kein neuer Sicherheitsmechanismus, keine Änderung am gefusten Trust Root. Genau diese Zurückhaltung macht das Ergebnis vertrauenswürdig - ein Recovery-Pfad, der die Sicherheitsarchitektur von Grund auf neu baut, bräuchte einen eigenen Verifikationsaufwand.

Die Sicherheitsgrenze: HAB bleibt unangetastet

Ein Recovery-Pfad darf keine Hintertür sein. Die Regel: Jeder Boot-Pfad - intern, USB, TFTP - authentifiziert das fitImage über denselben HAB-Mechanismus, bevor der Kernel startet. Der USB-Pfad erweitert also nur die Lade-Logik (woher kommt das Image?), nicht die Prüf-Logik (darf es starten?). Konkret wird die bestehende Authentifizierungs-Routine des normalen Boots wiederverwendet, nicht neu implementiert.

Dazu gehört auch die Fehlerbehandlung: Drei Fälle müssen explizit unterschieden werden - kein USB-Gerät gefunden (überspringen, normal weiterbooten), Image nicht ladbar (Abbruch mit Meldung), HAB-Authentifizierung fehlgeschlagen (Abbruch, kein Boot). Ein stiller Fallback auf einen unsignierten Boot wäre ein Sicherheitsfehler.

Der Vergleich mit den gesperrten Pfaden ist aufschlussreich: Fastboot und USB-Serial-Download (SDP) erlauben es, einen Bootloader in den RAM zu laden und auszuführen - auf einem offenen Gerät ist das ein legitimer Fertigungsweg, auf einem geschlossenen Gerät ein Angriffspfad, weil sich ein signierter Bootloader aus einem Update-Image extrahieren lässt. Der USB-Recovery-Boot ist etwas anderes: Er lädt ein signiertes System vom Stick und prüft es über HAB, bevor er bootet. Die Sicherheitsgrenze verläuft also nicht zwischen „USB ja/nein", sondern zwischen „geprüft oder ungeprüft".

Das Boot-Medium vorbereiten

Der Stick braucht eine FAT-Partition mit vier Artefakten aus dem Yocto-Build: das dm-verity-geschützte Rootfs (SquashFS mit angehängter Signatur), den Device Tree, das signierte fitImage und das dm-verity-Initramfs. Wichtig: Auch die .verity.env-Datei des Initramfs muss auf den Stick - sie enthält Metadaten, die das Initramfs beim Boot erwartet (dazu unten mehr).

Die Dateinamen sollten generisch und stabil sein, damit die U-Boot-Umgebung sie ohne Raten findet. Wer die Namen aus dem Build übernimmt, muss die Umgebung entsprechend parametrisieren - beides ist möglich, aber die Zuordnung muss dokumentiert sein.

# FAT partition on the stick (example: /dev/sdb1)
mount /dev/sdb1 usb
cp rootfs.squashfs.verity usb/
cp board.dtb usb/
cp fitImage usb/
cp dm-verity-initramfs.squashfs.verity usb/
cp dm-verity-initramfs.squashfs.verity.env usb/
umount usb

Erst manuell booten

Bevor der Autoboot erweitert wird, muss der manuelle Pfad funktionieren. Die Sequenz: USB-Subsystem starten, Device Tree und fitImage von der FAT-Partition in den RAM laden, USB-Subsystem stoppen, dann bootm. Das Stoppen vor dem Boot ist wichtig - der Kernel soll den Stick selbst neu enumerieren, nicht einen halb initialisierten Bus übernehmen.

Der fitImage-Start über bootm wählt die passende Konfiguration anhand des Device Tree. Im manuellen Test reicht die einfache Form; der Autoboot-Pfad nutzt später die explizite FIT-Konfiguration conf-<dtb>, damit Kernel und Device Tree garantiert zusammenpassen.

Die Ladeadressen sind plattformspezifisch und müssen zum Speicherlayout passen: Auf dem Testgerät liegen fitImage und Device Tree in einem RAM-Bereich, der nicht mit dem Kernel-Ziel oder dem FDT-Ziel kollidiert. Wer die Adressen aus einem alten Boot-Log übernimmt, ohne das aktuelle Memory-Layout zu prüfen, riskiert, dass sich Images beim Laden gegenseitig überschreiben - ein Fehler, der erst nach dem Start des Kernels als seltsames Verhalten auftaucht. Die Standard-Umgebung des Boards liefert die richtigen Werte; eigene Anpassungen sollten selten nötig sein.

usb start
fatload usb 0:1 $fdt_addr board.dtb
fatload usb 0:1 $loadaddr fitImage
usb stop
bootm $loadaddr - $fdt_addr

FIT-Image und HAB: zwei Prüfungen, ein Ziel

Ein FIT-Image (Flattened Image Tree) bündelt Kernel, Device Tree und optional ein Initramfs in einer einzigen Datei, beschrieben durch einen Device-Tree-artigen Baum. Jede Subimage-Sektion trägt einen Hash (etwa sha256); bootm prüft diese Hashes beim Laden („Verifying Hash Integrity"). Das schützt gegen Übertragungsfehler und zufällige Korruption - aber nicht gegen einen Angreifer, der das gesamte Image samt Hashes austauscht. Dafür ist die HAB-Signatur zuständig: Sie authentifiziert den FIT über die RSA-Vertrauenskette, bevor der Kernel überhaupt startet.

Beide Prüfungen ergänzen sich also: der FIT-Hash stellt die Integrität der Subimages sicher, die HAB-Signatur die Authentizität des gesamten Pakets. Wer nur eines von beiden implementiert, hat eine Lücke. Wichtig ist auch die FIT-Konfiguration: Ein FIT kann mehrere Kernel/DTB-Kombinationen enthalten; die Konfiguration conf-<dtb> wählt die zum Device Tree passende. Der USB-Boot-Pfad muss dieselbe Konfiguration verwenden wie der interne Boot - sonst startet unter Umständen ein Kernel mit falschem Device Tree, was auf echter Hardware zu schwer diagnostizierbaren Fehlern führt.

Den Autoboot erweitern

Das Herzstück sind zwei Environment-Variablen: eine für die Kernel-Kommandozeile des USB-Boots und eine für den Boot-Ablauf selbst. Der Ablauf prüft zuerst, ob überhaupt ein Stick steckt (fatls als Presence-Probe), lädt dann Device Tree und fitImage, setzt die Bootargs und ruft die bestehende HAB-Authentifizierung auf. Erst bei erfolgreicher Prüfung wird bootm mit der passenden FIT-Konfiguration ausgeführt.

Jeder Fehlerzweig gibt eine eigene Meldung aus und bootet nicht. Die Variable wird in das bestehende Autoboot-Environment eingehängt, sodass der USB-Pfad vor dem internen Boot probiert wird - ein gesteckter, signierter Stick hat Vorrang, ohne Stick bootet das Gerät normal weiter. Die Namen der Variablen sind frei wählbar; entscheidend ist die Wiederverwendung der Authentifizierungs-Routine.

env set usb_bootargs 'env set bootargs console=ttymxc3,115200 rootfstype=ramfs rootwait'

env set bootcmd_usb 'usb start; if fatls usb 0:1; then \
  echo "USB-Boot: device found, attempting boot"; \
  fatload usb 0:1 $fdt_addr $fdt_file; \
  fatload usb 0:1 $loadaddr $image; \
  usb stop; \
  run usb_bootargs; \
  if run authenticate_image; then \
    if bootm ${loadaddr} - ${loadaddr}#conf-${fdt_file}; then \
      echo "USB-Boot: booting now..."; \
    else echo "USB-Boot: failed to load image!"; fi; \
  else echo "USB-Boot: HAB authentication failed"; fi; \
else echo "USB-Boot: no USB device found, skipping..."; usb stop; fi'

run bootcmd_usb

Den Boot-Log lesen

Der Boot-Log belegt die Kette Stück für Stück: bootm lädt den FIT, verifiziert die sha256-Hashes der Subimages (Kernel, Device Tree), reloziert den FDT und startet den Kernel. Auf dem Testgerät: Kernel 6.1, 256 MB RAM, SPI-NAND als Rootfs-Medium, CAAM Era 8. Entscheidend ist die Zeile „Verifying Hash Integrity ... sha256+ OK" - sie zeigt, dass der FIT manipulationsfrei geladen wurde.

Danach übernimmt das dm-verity-Initramfs: Es sucht die Signatur hinter dem Rootfs, prüft sie und richtet dm-verity ein, bevor das eigentliche Rootfs gemountet wird. Im Log sieht man die USB-Enumeration durch den Kernel, das Attach des Sticks als SCSI-Removable-Disk und den Start des Initramfs. Wer diese Reihenfolge kennt, kann Fehler eindeutig einer Stufe zuordnen.

## Loading kernel from FIT Image at 82000000 ...
   Using 'conf-<board>.dtb' configuration
   Trying 'kernel-1' kernel subimage
     Description:  Linux kernel
     Type:         Kernel Image
     Data Size:    <size> Bytes
     Hash algo:    sha256
   Verifying Hash Integrity ... sha256+ OK
## Flattened Device Tree blob at 83000000
   Loading Kernel Image
   Loading Device Tree ... OK
Starting kernel ...

Was das Initramfs danach tut

Nach dem Kernel-Start läuft das in den Kernel kompilierte Initramfs als erster Userspace-Prozess. Seine Aufgabe im dm-verity-Setup ist eine feste Sequenz: Zuerst prüft es eine Markierung (MARK) am erwarteten Offset hinter dem Rootfs, dann liest es Signaturgröße und Env-Größe (SIGN_SIZE, ENV_SIZE), verifiziert die ECDSA-Signatur des Root-Hashes mit dem beim Build integrierten Public Key und richtet schließlich dm-verity ein. Erst danach wird das verifizierte Rootfs gemountet und per switch_root an den eigentlichen Userspace übergeben.

Jede dieser Stufen kann scheitern - und die Fehlermeldung verrät, wo: Eine fehlende oder falsche Markierung bedeutet meist, dass das Rootfs-Paket unvollständig kopiert wurde (die .verity.env-Datei fehlt). Eine fehlgeschlagene Signaturprüfung bedeutet, dass Rootfs und Signatur nicht zusammenpassen - etwa nach einer nachträglichen Modifikation des Rootfs. Ein dm-verity-Fehler beim Mounten bedeutet, dass ein Block nicht zum Hashbaum passt. Wer die Sequenz kennt, liest den Boot-Log wie ein Diagnoseprotokoll statt wie eine Fehlerwand.

Für den USB-Boot ist diese Sequenz identisch mit dem internen Boot - das Initramfs unterscheidet nicht, woher das Rootfs kam. Genau das ist die gewünschte Eigenschaft: Der Recovery-Pfad erbt die Verifikation, statt sie zu umgehen. Der einzige Unterschied liegt in der Herkunft der Daten (Stick statt NAND) und in der Frage, ob das Medium schnell und vollständig genug ist.

Praktische Stolpersteine

Erster Fund: langsame USB-Sticks. Der EHCI-Controller läuft in Timeouts, wenn der Stick im Mittel weniger als etwa 20 MiB/s liest. Das Symptom: wiederholte „EHCI timed out on TD"-Meldungen, dann „Error reading cluster" und „Failed to load fitImage". Die Lösung ist banal, aber wichtig: einen schnellen Stick verwenden und die Lesegeschwindigkeit vorab messen. Im Service-Kit sollte nur ein getestetes Modell liegen.

Zweiter Fund: das Initramfs erwartet eine .verity.env-Datei auf dem Boot-Medium. Fehlt sie, bricht die dm-verity-Einrichtung mit einer Markierungs-Prüfung ab („Wrong DM-VERITY-ENV-MARK"). Die Datei gehört also zwingend auf den Stick - sie ist Teil des signierten Rootfs-Pakets und wird beim Kopieren leicht übersehen.

Dritter Fund: kein Shell-Zugang im Produktiv-Initramfs. Das dm-verity-Initramfs ist minimal und startet keine Shell - für Debugging braucht es ein dediziertes USB-Boot-Initramfs mit Shell-Fähigkeit. Als Workaround wurde ein Getty auf der seriellen Konsole dokumentiert (inittab-Zeilen für sulogin bzw. start_getty). Wichtig: Ein solcher Debug-Pfad darf nur in Entwicklungs-Images existieren, niemals im Produktiv-Initramfs eines geschlossenen Geräts.

Die Stick-Geschwindigkeit lässt sich einfach vorab prüfen: unter Linux eine große Datei vom Stick lesen (etwa mit dd if=/dev/sdb of=/dev/null bs=1M) und den Durchsatz messen. Liegt er deutlich unter 20 MiB/s, ist der Stick für den Recovery-Boot ungeeignet - nicht wegen einer Spezifikation, sondern weil der EHCI-Treiber im U-Boot bei langsamen Geräten in Timeouts läuft. Diese Messung gehört in die Service-Dokumentation, damit nicht jeder Techniker dieselbe Fehlerkette durchläuft.

# EHCI timeout signature of a too-slow stick:
EHCI timed out on TD - token=0x1f8c80
Error reading cluster
Failed to load 'fitImage'

# Getty workaround (development images only), /etc/inittab:
z6:6:respawn:/sbin/sulogin
mxc3:12345:respawn:/bin/start_getty 115200 ttymxc3 vt102

Vom Spike zum Service-Pfad

Ein demonstrierter Spike ist noch kein Service-Prozess. Damit der USB-Boot im Feld zuverlässig funktioniert, gehören mehrere Dinge festgelegt: ein getestetes Stick-Modell mit nachgewiesener Lesegeschwindigkeit (die 20-MiB/s-Schwelle ist kein theoretischer Wert, sondern aus EHCI-Timeouts abgeleitet), ein dokumentierter Kopiervorgang für alle fünf Artefakte inklusive .verity.env, und eine Versionszuordnung zwischen Stick-Inhalt und Geräte-Software. Ein Service-Kit mit ungeprüften Sticks ist eine Fehlerquelle, keine Absicherung.

Auch die U-Boot-Umgebung selbst braucht Aufmerksamkeit: Sie wird typischerweise per env save persistiert und ist nur CRC-geschützt, nicht signiert. Wer den USB-Boot-Pfad in die Umgebung aufnimmt, sollte die beschreibbaren Variablen eingrenzen und sicherstellen, dass ein Angreifer mit Konsolenzugriff den Authentifizierungsschritt nicht einfach entfernen kann. Auf geschlossenen Geräten ist die Konsole ohnehin gesperrt - der USB-Pfad muss also ohne Konsoleneingriff auskommen, allein durch das Stecken des Sticks.

Schließlich die Dokumentation: Der Service-Techniker braucht eine kurze Anleitung (Stick einstecken, warten, Log prüfen), keine HAB-Abhandlung. Und der Entwicklungspfad braucht das Gegenteil - die vollständige Fehleranalyse mit den drei Fehlerzweigen, den EHCI-Symptomen und der Initramfs-Sequenz. Beides aus derselben Quelle zu pflegen hält den Prozess konsistent, wenn sich Images oder Umgebung ändern.

Offene Punkte und Lehren

Ehrlicher Stand am Spike-Ende: Der HAB-authentifizierte USB-Boot wurde auf der Hardware demonstriert (FIT-Hash geprüft, Kernel gestartet, dm-verity-Initramfs übernommen). Offen blieben: ein dediziertes USB-Initramfs mit Shell, der Test auf einem Gerät mit gebrannten SRK-Fuses (geschlossenem Zustand), ein funktionierender Netzwerk-Stack mit SSH im Recovery-System und Werkzeuge zum Bearbeiten der U-Boot-Umgebung aus Linux. Der Test auf geschlossenem Gerät ist der sicherheitsrelevante - erst dort beweist sich, dass der Pfad auch mit erzwungener HAB-Prüfung hält.

Die Lehre: Ein Recovery-Pfad ist kein separates Sicherheitsprojekt, sondern eine Erweiterung der bestehenden Kette. Wer die Authentifizierungs-Routine wiederverwendet, die Fehlerzweige explizit macht und das Medium vollständig vorbereitet (inklusive .verity.env), bekommt einen Service-Zugang, der die Sicherheitsgrenze nicht verschiebt. Und: Die praktischen Probleme - Stick-Geschwindigkeit, fehlende Dateien, fehlende Shell - findet man nur auf echter Hardware, nicht im Code-Review.