Autenticación y roles
Administrador, lectores, modo público, sesiones y listas de permisos.
Los administradores gestionan ajustes, usuarios y modificaciones. Los lectores reciben configuración filtrada y acceso de lectura autorizado. Configure cuentas en Ajustes → Usuarios y acceso y compruebe con una sesión real de lector.
Una instalación nueva es privada y crea solo admin. La guía de primer inicio sustituye el código de configuración por una nueva contraseña del administrador. Cambiar al modo público en la guía o en Ajustes crea viewer si falta, con acceso inicial a todas las páginas y widgets. Su contraseña aleatoria nunca se muestra. Limite sus permisos en Ajustes → Usuarios y acceso y defina una contraseña allí solo si alguien necesita acceder como viewer. Se conservan las cuentas y los permisos existentes.
Identidades y listas permitidas
En modo público, las peticiones anónimas usan los permisos del viewer guardado. En privado reciben 401. Los lectores conectados usan su rol y permisos actuales; los administradores tienen lectura completa. El token de un usuario eliminado recibe 401 en ambos modos. allowedTabs y allowedWidgets limitan pestañas y tipos de widgets: por compatibilidad, una lista vacía significa acceso ilimitado dentro de esa lista. Una API se permite si al menos una pestaña o widget asociado está permitido. Ocultar un botón no verifica autorización.
Correspondencias de recursos del servidor
| Recurso | Pestañas | Widgets |
|---|---|---|
| Estado de servicios | dashboard | quickstats, networkgraph |
| Métricas de máquinas | dashboard | devices, quickstats |
| Calendario | — | calendar |
| Topología de red | networks | networkgraph |
| Tailscale | networks | tailscale |
| Lista de contenedores Docker | docker, networks | dockercontainers |
| Detalles Docker, registros, imágenes, volúmenes | docker | — |
Los widgets de contenido actuales también requieren su familia de permisos: DNS, Medios (incluye música y descargas), Fotos, API personalizada, VPN o SAI. Autorice los widgets necesarios en Ajustes → Usuarios y acceso y compruebe una sesión de lectura.
Las modificaciones requieren administrador y permisos del proveedor elegido. El ajuste que muestra botones Iniciar/Detener en widgets controla presentación, no autorización API. Un proxy de socket también limita los métodos API permitidos.
Configuración y sesiones revocables
GET /api/config devuelve una copia filtrada sin cambiar la caché del servidor. Las credenciales se ocultan para todas las identidades. Los lectores no reciben categorías secretas, recursos prohibidos, URL de daemon/rutas de socket ni credenciales de integraciones. Los enlaces autorizados siguen funcionando. Cambiar contraseña, rol o listas incrementa sessionVersion; las siguientes peticiones rechazan tokens antiguos y exigen iniciar sesión. Los tokens antiguos sin ese valor usan versión cero. Mantenga estables claves persistentes y secretos existentes; consulte variables y copias.
Elija explícitamente Todo, entradas concretas o Ninguno para los permisos. Ninguno deniega esa lista; las listas vacías antiguas mantienen acceso sin restricciones por compatibilidad. Los widgets de máquinas comparten permiso de datos: ocultar CPU permitiendo otro widget de máquinas no restringe valores individuales de sensores. Verifique páginas y API con una sesión lectora separada. La URL privada del calendario permanece en el servidor; los lectores reciben eventos, no su token de acceso.