secubox-openwrt/package/secubox/luci-app-iot-guard/README.md
CyberMind-FR 8ef0c70d0f feat(iot-guard): Add IoT device isolation and security monitoring
Backend (secubox-iot-guard):
- OUI-based device classification with 100+ IoT vendor prefixes
- 10 device classes: camera, thermostat, lighting, plug, assistant, etc.
- Risk scoring (0-100) with auto-isolation threshold
- Anomaly detection: bandwidth spikes, port scans, time anomalies
- Integration with Client Guardian, MAC Guardian, Vortex Firewall
- iot-guardctl CLI for status/list/scan/isolate/trust/block
- SQLite database for devices, anomalies, cloud dependencies
- Traffic baseline profiles for common device classes

Frontend (luci-app-iot-guard):
- KISS-style overview dashboard with security score
- Device management with isolate/trust/block actions
- Vendor classification rules editor
- Settings form for UCI configuration
- RPCD handler with 11 methods
- Public ACL for unauthenticated dashboard access

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-11 10:36:04 +01:00

2.3 KiB

LuCI IoT Guard

LuCI dashboard for IoT Guard device isolation and security monitoring.

Features

  • Overview Dashboard - Security score, device counts, risk distribution
  • Device List - Filterable table with device details
  • Device Actions - Isolate, trust, or block devices
  • Cloud Mapping - View cloud services each device contacts
  • Anomaly Alerts - Real-time anomaly notifications
  • Policy Management - Vendor classification rules
  • Settings - Configure auto-isolation, thresholds, zones

Installation

opkg install luci-app-iot-guard

Requires secubox-iot-guard backend package.

Menu Location

SecuBox > Services > IoT Guard

Screens

Overview (/iot-guard/overview)

Dashboard with:

  • Device count, isolated, blocked, high-risk stats
  • Security score (0-100%)
  • Device grid grouped by risk level
  • Recent anomaly events

Devices (/iot-guard/devices)

Device management table:

  • MAC, IP, hostname, vendor, class, risk, score, zone, status
  • Click to view device detail modal with cloud deps and anomalies
  • Quick actions: Isolate, Trust, Block

Policies (/iot-guard/policies)

Vendor classification rules:

  • View/add/delete vendor rules
  • Configure OUI prefix, pattern, class, risk level
  • Device class reference table

Settings (/iot-guard/settings)

Configuration options:

  • Enable/disable service
  • Scan interval
  • Auto-isolation threshold
  • Anomaly detection sensitivity
  • Zone policy (block LAN, allow internet, bandwidth limit)
  • Allowlist/blocklist management

RPCD Methods

Method Description
status Dashboard stats
get_devices List devices (optional filter)
get_device Device detail with cloud map
get_anomalies Recent anomaly events
get_vendor_rules List classification rules
get_cloud_map Device cloud dependencies
scan Trigger network scan
isolate_device Move device to IoT zone
trust_device Add to allowlist
block_device Block device
add_vendor_rule Add classification rule
delete_vendor_rule Delete classification rule

Public Access

The overview and device list are available publicly via the unauthenticated ACL group.

Dependencies

  • secubox-iot-guard
  • luci-base

License

GPL-3.0