Agente Linux — Configuración

El diálogo de Settings se abre tecleando 12345 o tocando la esquina superior izquierda 5 veces (en <2 s). Tiene cuatro pestañas: Browser, Server, Log, Security.

Browser

Ajuste	Descripción
Mode	Web (URL kiosk) o Playlist (slideshow gestionado desde RDS). Se gestiona también desde el panel web.
Home URL	Página que carga al arrancar y a la que vuelve si se intenta navegar fuera de la whitelist (modo web).
Allowlist	Dominios permitidos para navegación. Cualquier URL fuera de la lista redirige a Home URL. Se gestiona desde el panel web.
Remove Local Videos	Borra la caché local de vídeos/imágenes de la playlist (sólo modo Playlist).

Server

Ajuste	Descripción
Server URL	URL base del servidor RDS. Por defecto `https://rds.digitalsignagerds.com`.
Username	Usuario de Promotienda.
Device ID	Identificador asignado en el panel (ej. `RDSA1B2`).
Test Connection	Verifica credenciales y registra el dispositivo.
App version	Versión actual del agente (sólo lectura).

Log

Vista en directo de los logs del agente, auto-refresca cada 3 segundos. Estas entradas también se suben al servidor en cada heartbeat — desde el panel se ven en Logs → Logs de dispositivos.

Security

Ajuste	Descripción
Passcode	Código numérico para abrir Settings. Por defecto `0000` — cámbialo en producción.
Exit App	Cierra el navegador kiosk (útil sólo para mantenimiento).

Allowlist (lista blanca)

La whitelist se evalúa por dominio. Una entrada como example.com:

✓ Permite example.com, www.example.com, cdn.example.com, etc.
✗ Bloquea evil.com aunque lleve un parámetro a example.com.

Cualquier intento de navegar fuera de la whitelist redirige a la Home URL. Los enlaces target=_blank se interceptan y se abren en la misma ventana (no se permiten nuevas ventanas / pestañas).

Sincronización con el panel

Estos campos los gestiona el panel web (Dispositivos → Editar kiosk) y el agente los recibe en su próximo heartbeat:

Modo (Web / Playlist)
Home URL
Allowlist
Passcode

Si modificas localmente uno de estos campos, el cambio se perderá la próxima vez que el agente sincronice con el servidor. Cámbialos desde el panel web.

Acceso por SSH

Para tareas de mantenimiento puedes acceder por SSH al equipo Linux:

journalctl -u kiosk-browser -f      # logs en directo
systemctl restart kiosk-browser     # reiniciar el agente
systemctl stop kiosk-browser        # detener
chvt 7                              # volver a ver el navegador