82 lines
2.1 KiB
Markdown
82 lines
2.1 KiB
Markdown
FreeRADIUS Manager
|
|
A lightweight web UI to manage MAC-based FreeRADIUS configurations, backed by a MySQL/MariaDB database and integrated with maclookup.app for vendor resolution.
|
|
|
|
✨ Features
|
|
Manage MAC-based users (add/edit/delete)
|
|
|
|
Assign users to VLANs via group mapping
|
|
|
|
View Access-Accept, Access-Reject, and Fallback logs
|
|
|
|
Filter logs by time range (e.g. last 5 min, last day)
|
|
|
|
Vendor lookup for MAC addresses (with local caching)
|
|
|
|
Asynchronous background updates to reduce API hits
|
|
|
|
Manual MAC vendor lookup with detailed results
|
|
|
|
Pagination for log history and user/group lists
|
|
|
|
Dark/light theme toggle, scroll position memory, and toasts
|
|
|
|
Admin actions to clean stale vendors and logs (planned)
|
|
|
|
🧱 Requirements
|
|
Existing FreeRADIUS installation with a compatible schema
|
|
|
|
Existing MariaDB or MySQL server
|
|
|
|
maclookup.app API key (optional, for vendor lookup)
|
|
|
|
🗃️ Required Tables
|
|
Make sure your database includes the following tables:
|
|
|
|
sql
|
|
Copy
|
|
Edit
|
|
CREATE TABLE `users` (
|
|
`mac_address` VARCHAR(17) PRIMARY KEY,
|
|
`description` VARCHAR(255),
|
|
`vlan_id` INT
|
|
);
|
|
|
|
CREATE TABLE `groups` (
|
|
`vlan_id` INT PRIMARY KEY,
|
|
`description` VARCHAR(255)
|
|
);
|
|
|
|
CREATE TABLE `auth_logs` (
|
|
`id` INT AUTO_INCREMENT PRIMARY KEY,
|
|
`mac_address` VARCHAR(17),
|
|
`reply` ENUM('Access-Accept','Access-Reject','Access-Fallback'),
|
|
`result` TEXT,
|
|
`timestamp` DATETIME DEFAULT CURRENT_TIMESTAMP
|
|
);
|
|
|
|
CREATE TABLE `mac_vendors` (
|
|
`mac_prefix` VARCHAR(6) PRIMARY KEY,
|
|
`vendor_name` VARCHAR(255),
|
|
`status` ENUM('found', 'not_found') DEFAULT 'found',
|
|
`last_checked` DATETIME,
|
|
`last_updated` DATETIME
|
|
);
|
|
⚙️ Configuration
|
|
Environment variables (via .env or Docker Compose):
|
|
|
|
OUI_API_URL: MAC vendor API URL (default: https://api.maclookup.app/v2/macs/{})
|
|
|
|
OUI_API_KEY: API key for maclookup.app
|
|
|
|
OUI_API_LIMIT_PER_SEC: API rate limit per second (default: 2)
|
|
|
|
OUI_API_DAILY_LIMIT: Max API calls per day (default: 10000)
|
|
|
|
APP_TIMEZONE: Display timezone (e.g., America/Toronto)
|
|
|
|
🚀 Usage
|
|
Run with Docker Compose or your preferred WSGI stack
|
|
|
|
Navigate to / for the dashboard
|
|
|
|
Browse /users, /groups, and /stats for more details |