MCM — Mosquitto Control Manager
Plano de control open source para Mosquitto: gestiona usuarios, ACLs, listeners y TLS con MFA y audit trail, sin reemplazar el broker.
El problema
Mosquitto es ligero, fiable y ampliamente usado en el edge industrial. Pero operar un broker en producción significa editar ficheros de configuración a mano, gestionar ACLs en texto plano, rotar contraseñas sin trazabilidad y montar dashboards por separado. No existe una capa de control oficial.
MCM cubre ese hueco: un plano de control limpio que se conecta al broker existente como cliente, lo configura donde es posible, y da al operador visibilidad, auditabilidad y acceso con mínimo privilegio.
Qué hace
Auth y RBAC — Login con JWT, bcrypt, cuatro roles (viewer < auditor < operator < admin), bloqueo por IP/usuario tras intentos fallidos (429) y MFA para operaciones sensibles como aplicar configuración.
Gestión de ACLs y schemas — Reglas Mosquitto con validación de wildcards. Validadores JSON Schema enlazados a filtros de topic MQTT.
Stream en tiempo real — Cliente paho.mqtt.golang con keepalive y reconexión automática, distribuido por WebSocket autenticado al dashboard React.
Audit trail — Cada acción de administración y evento de seguridad persiste en SQLite, expuesto por APIs de solo lectura.
Observabilidad — slog estructurado con request IDs, /metrics Prometheus con labels acotados, dashboard Grafana de arranque.
HTTPS / mTLS — Listener TLS opcional con versión mínima configurable y verificación de certificado cliente.
Listeners, TLS y plugins — Gestión de listeners con perfiles de certificado (mTLS opcional), bridges hacia otros brokers y plugins del broker, incluida la security database del dynamic security plugin.
Editor de mosquitto.conf — El editor avanzado de la configuración raíz soporta importar, validar en borrador, revisión inmutable, aplicar y recuperar revisiones anteriores.
Stack
| Capa | Tecnología |
|---|---|
| Backend | Go 1.24, net/http, slog |
| Base de datos | SQLite (driver pure-Go) |
| Mensajería | Eclipse paho MQTT |
| Observabilidad | Prometheus, Grafana |
| API | OpenAPI 3.1 |
| Frontend | React 19, Vite, Tailwind 4 |
| Ops | Single binary, Docker Compose |
El binario es estático — sin CGO, sin dependencias de sistema. Cross-compila a Linux amd64/arm64, macOS arm64 y Windows en cada PR.
CLI
mcm server — arranca el control plane
mcm doctor — valida config y conectividad con el broker
mcm status — estado del servidor en ejecución
mcm backup — exporta la base de datos
mcm version — versión y build info
Estado actual
Alpha: el MVP de configuración gráfica no está completo. Ya están disponibles usuarios y ACLs MQTT, listeners y material TLS, ajustes generales del broker, bridges y plugins (incluido dynamic security), tráfico observado, métricas, logs, cuentas de operador con MFA y vistas de auditoría, todo ejercitado por CI en cada PR.