Agente Linux — Configuração

O diálogo de Settings abre-se escrevendo 12345 ou tocando no canto superior esquerdo 5 vezes (em < 2 s). Tem quatro separadores: Browser, Server, Log, Security.

Browser

Definição	Descrição
Mode	Web (URL kiosk) ou Playlist (slideshow gerido a partir do RDS). Também é gerido a partir do painel web.
Home URL	Página carregada no arranque e para a qual regressa se tentar navegar fora da whitelist (modo web).
Allowlist	Domínios permitidos para navegação. Qualquer URL fora da lista redireciona para Home URL. É gerido a partir do painel web.
Remove Local Videos	Apaga a cache local de vídeos/imagens da playlist (apenas modo Playlist).

Server

Definição	Descrição
Server URL	URL base do servidor RDS. Por defeito `https://rds.digitalsignagerds.com`.
Username	Utilizador da Promotienda.
Device ID	Identificador atribuído no painel (ex. `RDSA1B2`).
Test Connection	Verifica as credenciais e regista o dispositivo.
App version	Versão atual do agente (apenas leitura).

Log

Vista em direto dos logs do agente, auto-refresca a cada 3 segundos. Estas entradas também são enviadas para o servidor em cada heartbeat — no painel são visíveis em Logs → Logs de dispositivos.

Security

Definição	Descrição
Passcode	Código numérico para abrir Settings. Por defeito `0000` — altere em produção.
Exit App	Fecha o navegador kiosk (útil apenas para manutenção).

Allowlist (lista branca)

A whitelist é avaliada por domínio. Uma entrada como example.com:

✓ Permite example.com, www.example.com, cdn.example.com, etc.
✗ Bloqueia evil.com mesmo que tenha um parâmetro para example.com.

Qualquer tentativa de navegar fora da whitelist redireciona para a Home URL. As ligações target=_blank são intercetadas e abertas na mesma janela (não são permitidas novas janelas / separadores).

Sincronização com o painel

Estes campos são geridos pelo painel web (Dispositivos → Editar kiosk) e o agente recebe-os no próximo heartbeat:

Modo (Web / Playlist)
Home URL
Allowlist
Passcode

Se modificar localmente um destes campos, a alteração perder-se-á na próxima vez que o agente sincronizar com o servidor. Altere-os a partir do painel web.

Acesso por SSH

Para tarefas de manutenção pode aceder por SSH ao equipamento Linux:

journalctl -u kiosk-browser -f      # logs em direto
systemctl restart kiosk-browser     # reiniciar o agente
systemctl stop kiosk-browser        # parar
chvt 7                              # voltar a ver o navegador