Repository navigation
Build Bring Up and Field Operations
Cyberdeck Home ยท Wireless Field Device Procedures ยท Acceptance Tests ยท Private Implementation Roadmap
This runbook turns the reference architecture into a sequence of decisions and checks. It supplies no vendor configuration or private application code. For official links to the hardware and software mentioned in this project, see Device & Platform References. Complete the inventory for the actual equipment before connecting a client interface.
Start with an operator workstation, one segmentation router, an approved uplink and separately protected evidence storage. Add a passive sensor only after its traffic feed is demonstrated. Optional RF devices and an external runner are later milestones, not prerequisites for an offline workflow. For Flipper, Marauder, Bruce/M5StickC Plus2 and Pineapple, follow the separate field-device setup, stop and export runbook; never treat those gadgets as prewired Cyberdeck sensors.
| Item | Record before purchase or reuse | Acceptance requirement |
|---|---|---|
| Operator host | OS/support lifecycle, architecture, RAM, ports, recovery media | Runs offline tools, locks sessions, has verified storage protection |
| Upstream router | Exact model, firmware, operating mode, power input | Uplink works without exposing operator administration |
| Segmentation router | Port map, firmware, VLAN and IPv6 support, recovery method | Enforces the documented zone matrix on actual paths |
| Evidence storage | Usable capacity, encryption mechanism, recovery-key custody | Unlock, access restriction, backup and restore demonstrated |
| Sensor, if used | NIC/chipset, driver, OS, approved feed, storage needs | Observes the intended lab traffic without bridging zones |
| Power system | Per-device input voltage/current, adapters, cable ratings | Stable under representative simultaneous load |
| Enclosure/cabling | Airflow, strain relief, labels, spare cables | Ports accessible, no exposed contacts or obstructed cooling |
For printed brackets, port covers, cable exits and strain relief, the CAD & 3D Printing guide shows how to mock up each device and prove clearance before printing.
Keep serial numbers, invoices, credentials and real configurations in the private inventory. Publish only generic roles and synthetic measurements. Model compatibility and prices must be checked against current manufacturer documentation before procurement.
Draw the physical cabling and logical routes separately. Record interface labels, VLANs, address families, gateway placement and management access. Do not paste a generic subnet plan into an existing site without checking overlap.
| Source | Destination | Reference policy | How to qualify |
|---|---|---|---|
| UPSTREAM | MGMT, SENSOR, LAB | Deny new inbound sessions | Owned upstream fixture cannot open approved test listeners |
| LAB | MGMT and STORAGE | Deny | Test each relevant routed path and address family |
| SENSOR | MGMT | Deny unsolicited access | Sensor cannot open management listeners |
| MGMT | Router administration | Allow only named operator source and service | Approved operator succeeds; other zones fail |
| MGMT | Evidence import endpoint | Explicit, minimal exception if needed | Import works; unrelated services remain inaccessible |
| CLIENT TEST | Other deck zones | Deny unless a specific approved method requires a path | No accidental transit, DHCP, RA, forwarding or bridging |
| Any zone | Internet | Explicit decision per zone | Required egress succeeds; disallowed egress fails |
This is a policy worksheet, not a preconfigured firewall. Stateful return traffic, DNS, time synchronization, software updates and IPv6 need explicit decisions. Test same-subnet and offloaded paths separately because routed firewall tests do not cover them.
- Keep all client cables disconnected. Label uplink, management, sensor and lab ports.
- Establish console/recovery access and save a protected configuration backup.
- Configure one zone at a time. Use the acceptance matrix to record both allowed and denied paths.
- Connect a sensor only to its approved feed. Generate a benign exchange between owned fixtures and identify it at the sensor.
- Create a synthetic case outside Git. Verify encryption and a restore to a separate protected location.
- Run the offline manifest rehearsal below. Record tool revision and outcomes.
- Exercise loss of uplink, low storage, power interruption recovery and emergency stop in the lab. Stop each independent device; terminating a dashboard does not stop separate hardware.
- Mark every unresolved gate as failed, blocked or not tested. Do not reinterpret missing results as passes.
From the parent repository root, choose a new output filename each run. The destination parent must exist and must be outside the evidence folder.
python Cyberdeck/tools/evidence_manifest.py --input Cyberdeck/examples/synthetic-evidence --output /tmp/cyberdeck-demo-manifest.json
python Cyberdeck/tools/verify_manifest.py --input Cyberdeck/examples/synthetic-evidence --manifest /tmp/cyberdeck-demo-manifest.json
python -m unittest discover -s Cyberdeck/tests -vPowerShell equivalent:
$demoManifest = Join-Path $env:TEMP ('cyberdeck-' + [guid]::NewGuid().ToString() + '.json')
py -3 Cyberdeck/tools/evidence_manifest.py --input Cyberdeck/examples/synthetic-evidence --output $demoManifest
py -3 Cyberdeck/tools/verify_manifest.py --input Cyberdeck/examples/synthetic-evidence --manifest $demoManifest
py -3 -m unittest discover -s Cyberdeck/tests -vVerification exits with 0 for a matching inventory, 1 for added/missing/changed regular files and 2 for invalid input or an operational error. Do not overwrite the original manifest after a mismatch. Preserve it and investigate. Both tools exclude symlinks; neither proves the absence of skipped objects or protects against hostile concurrent filesystem changes. Work on a quiescent, access-controlled copy. Protect the baseline separately: replacing both evidence and manifest defeats this comparison.
Before attachment, review the specific signed scope, actual interface, target list, exclusions, test window and stop contacts. Check clocks and note offsets; record acquisition time separately from hashing time. Confirm storage capacity, recovery access and independent device stop controls.
After collection, preserve originals, create hashes, review derivatives and use the report template. Verify transferred evidence at the destination against a separately protected manifest. Remove temporary access, disconnect the client interface, confirm equipment removal and record the agreed retention/deletion action. Flash storage deletion guarantees depend on the medium and encryption lifecycle; do not claim secure erasure merely because files were deleted.
| Symptom | Check | Required disposition |
|---|---|---|
| No sensor packets | Actual feed, interface, mirror direction, offload and capture filters | Restore proven visibility or report coverage as unavailable |
| Unexpected cross-zone access | Same-subnet paths, bridge membership, IPv6, alternate uplinks | Disconnect client interface and resolve before field use |
| Hash mismatch | Changed bytes, partial transfer, wrong case or baseline | Preserve both versions; investigate without regenerating away the discrepancy |
| Empty manifest | Selected directory, file types, symlink-only content | Confirm intended files exist; an empty inventory is not collection evidence |
| Read error or storage full | Permissions, media health, capacity and locks | Stop evidence writes; preserve existing material and record the failure |
| Local portal unreachable | Binding, process state, local firewall and logs | Use recovery access; do not expose the portal publicly as a workaround |
| Time discrepancy | UTC settings, clock source, offline drift | Record offset and uncertainty; do not silently rewrite originals |
๐ Source: Cyberdeck/docs/BUILD_AND_OPERATIONS.md | โ๏ธ Suggest an edit | โฌ
๏ธ Back to PNWC Cyberdeck
- ๐บ๏ธ Browse by Topic
- ๐ All Repository Files
- ๐งญ Learning Paths
- ๐ Master Guide
- ๐ค Glossary
- โ๏ธ Legal & Disclaimer
๐ Foundations & Learning
๐ก๏ธ Defense & Investigations
- Incident Response
- Open Source Intelligence (OSINT)
- Reverse Engineering
- Operations Security (OPSEC)
- Compliance
โ๏ธ Platforms & Infrastructure
๐ก Hardware, Wireless & Field Projects
- PNWC Cyberdeck
- Hardware Testing
- Hardware Hacking
- Software-Defined Radio
- Wardriving
- uConsole
- Space Security
๐งฐ Assessment & Field Reference
๐ฆ Downloads & Project Resources
๐๏ธ Additional Topics