50 lines
1.7 KiB
Markdown
50 lines
1.7 KiB
Markdown
# OPNsense Device Control for Home Assistant
|
|
|
|
A comprehensive system for discovering, managing, and controlling internet access to devices through OPNsense firewall integration with Home Assistant.
|
|
|
|
## Repository
|
|
|
|
🔗 **https://gitea.hideawaygaming.com.au/jessikitty/opnsense-device-control**
|
|
|
|
## Features
|
|
|
|
- **Device Discovery**: Automatically discover all devices on your network
|
|
- **MAC-Based Blocking**: Block internet access by MAC address (prevents circumvention)
|
|
- **Per-Device Control**: Individual blocking for each device
|
|
- **User-Wide Control**: Block all devices for a user with one toggle
|
|
- **Tablet-Optimized Dashboard**: Clean, intuitive interface for easy management
|
|
- **Multiple MAC Support**: Handle devices with both wired and WiFi connections
|
|
- **Real-Time Status**: See which devices are blocked at a glance
|
|
|
|
## Quick Start
|
|
|
|
1. **Generate OPNsense API credentials** (System → Access → Users)
|
|
2. **Configure secrets.yaml** with API key/secret
|
|
3. **Run device discovery** script to find all devices
|
|
4. **Configure MAC addresses** in Home Assistant
|
|
5. **Create firewall aliases and rules** in OPNsense
|
|
6. **Install dashboard** for control interface
|
|
|
|
## Files
|
|
|
|
- `opnsense_device_control.yaml` - Home Assistant configuration
|
|
- `lovelace_device_control.yaml` - Tablet-optimized dashboard
|
|
- `opnsense_device_manager.py` - Device discovery Python script
|
|
- `secrets.yaml.example` - API credentials template
|
|
- `FULL_DOCUMENTATION.md` - Complete setup and usage guide
|
|
|
|
## Family Configuration
|
|
|
|
Pre-configured for:
|
|
- **Bella** (14) - Phone + Tablet
|
|
- **Xander** (15) - Phone + Desktop
|
|
- **William** (17) - Phone + Laptop
|
|
|
|
Easily customizable!
|
|
|
|
## Network
|
|
|
|
- **OPNsense**: 10.0.0.254
|
|
- **Home Assistant**: 10.0.0.55
|
|
- **LAN**: 10.0.0.0/24
|