Requisiti di rete e impostazioni del firewall

Quando ti serve questa guida?

La maggior parte delle reti domestiche e dei piccoli uffici funziona con Screenbird senza configurazioni aggiuntive. Hai bisogno di questo articolo solo se la tua rete ha:

Un firewall restrittivo che blocca i domini sconosciuti
Un filtro web o un proxy che limita il traffico in uscita
Una VLAN separata per i display senza accesso a Internet

Domini richiesti

Aggiungi alla whitelist questi domini sia per il dashboard (utilizzato dalle persone che gestiscono i contenuti) sia per il player (in esecuzione sullo schermo).

Domini del dashboard

screenbird.app: applicazione principale
dev.screenbird.app: staging (necessario solo se il tuo team utilizza lo staging)
api.screenbird.app: API dei dispositivi
*.supabase.co: database e autenticazione
cdn.screenbird.app: asset statici e contenuti
media.screenbird.app: immagini e video

Domini del player

player.screenbird.app: applicazione player
cdn.screenbird.app: distribuzione dei contenuti
*.supabase.co: connessione al tuo account
api.screenbird.app: heartbeat e sincronizzazione dei contenuti

Domini facoltativi (utilizzati da alcune app e integrazioni)

apis.google.com: selettore Google Slides, Sheets, Docs
*.googleusercontent.com: anteprime Google Drive
images.pexels.com: libreria immagini Pexels
api.qrserver.com: codici QR nei template
geocoding-api.open-meteo.com: completamento automatico della località nell'app Meteo
challenges.cloudflare.com: Cloudflare Turnstile (utilizzato durante la registrazione e nei moduli di contatto)

Se non utilizzi una particolare integrazione, non hai bisogno di aggiungerne il dominio alla whitelist.

Porte richieste

HTTPS (443): tutte le comunicazioni utilizzano HTTPS sulla porta 443
WebSocket (443): anche la comunicazione in tempo reale passa attraverso la porta 443

Screenbird non utilizza porte non standard.

Protocolli richiesti

HTTPS per tutto il traffico
WebSocket Secure (WSS) per gli aggiornamenti in tempo reale dal dashboard al player

Requisiti di banda

Player inattivo: meno di 10 KB al minuto (solo heartbeat)
Player con immagini statiche in riproduzione: minimo una volta scaricato il contenuto
Player con video 1080p in riproduzione: il download iniziale dipende dalla dimensione del file, poi 0 traffico durante la riproduzione (i video vengono memorizzati nella cache locale)
Player con stream live in riproduzione (YouTube, RSS): dipende dallo stream

Per la maggior parte delle reti di signage, 5 Mbps in download sono più che sufficienti per schermo. Screenbird è progettato per funzionare offline una volta scaricati i contenuti, quindi brevi interruzioni di rete non interrompono la riproduzione.

Testare la rete

Per verificare che uno schermo possa raggiungere Screenbird, apri un browser sul dispositivo e vai a:

https://player.screenbird.app: dovrebbe caricare la schermata di accesso del player
https://screenbird.app: dovrebbe caricare la pagina di accesso del dashboard

Se uno dei due non funziona, controlla i log del firewall per le richieste bloccate verso i domini elencati sopra.

Hai bisogno di aiuto per un rollout aziendale?

Se stai distribuendo molti schermi dietro reti aziendali e hai bisogno di aiuto con la documentazione per la whitelist, la convalida IT o la configurazione del proxy, contattaci all'indirizzo support@screenbird.app e ti aiuteremo.