Agente Linux — Configurazione

La finestra Settings si apre digitando 12345 oppure toccando 5 volte l'angolo in alto a sinistra (in <2 s). Ha quattro schede: Browser, Server, Log, Security.

Browser

Impostazione	Descrizione
Mode	Web (URL kiosk) oppure Playlist (slideshow gestito da RDS). Si gestisce anche dal pannello web.
Home URL	Pagina caricata all'avvio e alla quale si torna se si tenta di navigare fuori dalla whitelist (modalità web).
Allowlist	Domini consentiti per la navigazione. Qualsiasi URL fuori dall'elenco reindirizza alla Home URL. Si gestisce dal pannello web.
Remove Local Videos	Cancella la cache locale di video/immagini della playlist (solo modalità Playlist).

Server

Impostazione	Descrizione
Server URL	URL base del server RDS. Per impostazione predefinita `https://rds.digitalsignagerds.com`.
Username	Utente di Promotienda.
Device ID	Identificativo assegnato nel pannello (es. `RDSA1B2`).
Test Connection	Verifica le credenziali e registra il dispositivo.
App version	Versione attuale dell'agente (sola lettura).

Log

Vista in tempo reale dei log dell'agente, con aggiornamento automatico ogni 3 secondi. Queste voci vengono caricate anche sul server a ogni heartbeat — dal pannello si consultano in Logs → Log dei dispositivi.

Security

Impostazione	Descrizione
Passcode	Codice numerico per aprire Settings. Predefinito `0000` — lo cambi in produzione.
Exit App	Chiude il browser kiosk (utile solo per la manutenzione).

Allowlist (lista bianca)

La whitelist viene valutata per dominio. Una voce come example.com:

✓ Consente example.com, www.example.com, cdn.example.com, ecc.
✗ Blocca evil.com anche se contiene un parametro verso example.com.

Qualsiasi tentativo di navigare fuori dalla whitelist reindirizza alla Home URL. I link target=_blank vengono intercettati e aperti nella stessa finestra (non sono consentite nuove finestre o schede).

Sincronizzazione con il pannello

Questi campi sono gestiti dal pannello web (Dispositivi → Modifica kiosk) e l'agente li riceve all'heartbeat successivo:

Modalità (Web / Playlist)
Home URL
Allowlist
Passcode

Se modifica localmente uno di questi campi, la modifica andrà persa alla successiva sincronizzazione dell'agente con il server. Li cambi dal pannello web.

Accesso via SSH

Per le attività di manutenzione può accedere via SSH alla macchina Linux:

journalctl -u kiosk-browser -f      # log in tempo reale
systemctl restart kiosk-browser     # riavviare l'agente
systemctl stop kiosk-browser        # arrestare
chvt 7                              # tornare a vedere il browser