Firmware Probe

Firmware/embedded analysis under contract, via extensions/offsec-tools/wrapper.py (domain firmware).

Contract (mandatory)

--target (image path), --window, --roe. Extraction is read-only against the image; emulated boot is out of scope unless the ROE says so.

Tools

Commands

W=extensions/offsec-tools/wrapper.py

python $W run --tool binwalk --target fw.bin --window "..." --roe "..." \
  --backend wsl -- -Me fw.bin
python $W run --tool unblob --target fw.bin --window "..." --roe "..." \
  --backend docker -- fw.bin
python $W run --tool emba --target fw.bin --window "..." --roe "..." \
  --backend docker -- -f /work/fw.bin -l /work/emba_logs

Docker backend auto-mounts the target's directory read-only at /work and rewrites the target arg. Extracted binaries needing real RE go to re-binary (rea-ops wrapper, same contract).

Workflow

1. binwalk/unblob to unpack; hash the image (sha256) first.
2. Inventory filesystem: versions, init scripts, certs, configs.
3. emba for SBOM + CVE correlation when a full report is needed.
4. Interesting binaries -> re-binary; interesting services -> net-probe-style reasoning (offline only).

Evidence

Per finding: image sha256, extraction tool+version, file path inside image, CVE/SBOM reference, confidence. Emba/CVE hits are likely until version-confirmed in the extracted filesystem.

Boundaries

• Analysis only; no flashing or writing to live devices.
• Full device emulation (firmadyne/FirmAE class) is native-linux-only -- report unsupported_platform on this host rather than approximating.
• Found secrets are evidence of exposure, not material for use.