97 lines
3.2 KiB
Markdown
97 lines
3.2 KiB
Markdown
# LF_ICEHID — Multi-Format LF Credential Collector
|
|
|
|
> **Author:** Iceman
|
|
> **Frequency:** LF (125 kHz)
|
|
> **Hardware:** RDV4 (requires flash memory and battery)
|
|
|
|
[Back to Standalone Modes Index](../../armsrc/Standalone/readme.md#individual-mode-documentation) | [Source Code](../../armsrc/Standalone/lf_icehid.c) | [Development Guide](../../armsrc/Standalone/readme.md#developing-standalone-modes)
|
|
|
|
---
|
|
|
|
## What
|
|
|
|
A passive LF credential collector that continuously listens for **HID, IOprox, AWID, and EM4100** cards and logs all captured credentials to flash memory. Runs unattended — just power on and leave it.
|
|
|
|
## Why
|
|
|
|
This is the ultimate "drop and collect" standalone mode. Place a powered Proxmark3 RDV4 (with battery) near a high-traffic area (like a card reader or badge check-in point) and it silently captures every LF credential that comes into range. Unlike single-protocol modes, IceHID tries all four common LF formats on every signal, catching whatever cards employees are carrying.
|
|
|
|
Use cases:
|
|
- **Passive badge collection**: Covert long-duration credential harvesting
|
|
- **Multi-format sites**: Sites using a mix of HID, AWID, IOprox, and EM4100
|
|
- **Physical penetration testing**: Leave device near a turnstile, collect badges over hours
|
|
|
|
## How
|
|
|
|
1. The Proxmark3 continuously samples the LF antenna
|
|
2. On each sample, it attempts demodulation in four formats: HID → AWID → IOprox → EM4100
|
|
3. If any format decodes successfully, the credential is logged to `lf_hidcollect.log` on flash
|
|
4. The cycle repeats indefinitely until the button is held or USB data is received
|
|
|
|
The multi-format approach uses `ASKDemod()` and protocol-specific decoders in sequence.
|
|
|
|
## LED Indicators
|
|
|
|
| LED | Meaning |
|
|
|-----|---------|
|
|
| **A** (solid) | Reading / recording LF signal |
|
|
| **B** (solid) | Writing captured data to flash |
|
|
| **C** (solid) | Unmounting / syncing flash filesystem |
|
|
|
|
## Button Controls
|
|
|
|
| Action | Effect |
|
|
|--------|--------|
|
|
| **Hold 280ms** | Exit standalone mode |
|
|
| **USB command** | Exit standalone mode |
|
|
|
|
## State Machine
|
|
|
|
```mermaid
|
|
stateDiagram-v2
|
|
[*] --> Sample : Startup
|
|
|
|
Sample --> DemodHID : LF signal detected
|
|
DemodHID --> LogFlash : HID decoded
|
|
DemodHID --> DemodAWID : HID failed
|
|
|
|
DemodAWID --> LogFlash : AWID decoded
|
|
DemodAWID --> DemodIO : AWID failed
|
|
|
|
DemodIO --> LogFlash : IOprox decoded
|
|
DemodIO --> DemodEM : IOprox failed
|
|
|
|
DemodEM --> LogFlash : EM4100 decoded
|
|
DemodEM --> Sample : All decoders failed
|
|
|
|
LogFlash --> Sample : Logged, continue
|
|
|
|
Sample --> [*] : Button hold / USB data
|
|
|
|
note right of Sample
|
|
Continuous loop
|
|
Tries 4 demod formats
|
|
per signal capture
|
|
end note
|
|
```
|
|
|
|
## Flash Storage
|
|
|
|
- **Log file**: `lf_hidcollect.log` on SPI flash
|
|
- Each entry contains the decoded credential data and format type
|
|
- Retrieve with client: `mem spiffs dump -s lf_hidcollect.log -d lf_hidcollect.log`
|
|
|
|
## Compilation
|
|
|
|
```
|
|
make clean
|
|
make STANDALONE=LF_ICEHID -j
|
|
./pm3-flash-fullimage
|
|
```
|
|
|
|
## Related
|
|
|
|
- [NexID Collector](lf_nexid.md) — Similar collector for Nexwatch credentials
|
|
- [SamyRun](lf_samyrun.md) — Active HID read/clone/sim
|
|
- [HID FC Brute](lf_hidfcbrute.md) — Active HID facility code brute force
|