Requisiti di rete e impostazioni del firewall

Screenbird di per sé usa solo HTTPS e WebSocket Secure sulla porta 443. Su una rete restrittiva, metti in allowlist i domini qui sotto: un elenco per la dashboard e uno per gli schermi (il player). Se usi un Amazon Signage Stick o una Fire TV, leggi anche la sezione Sincronizzazione dell'ora sui dispositivi Amazon: questi dispositivi hanno bisogno di connessioni extra proprie.

Quando ti serve tutto questo?

La maggior parte delle reti domestiche e aziendali funziona subito. Questo elenco ti serve se la rete blocca i domini sconosciuti, se usa un proxy o un filtro web, oppure se gli schermi stanno su una VLAN separata con accesso a internet limitato.

Domini per la dashboard

Per i computer su cui il tuo team gestisce i contenuti:

• screenbird.app: la dashboard vera e propria
• dev.screenbird.app: lo staging, serve solo se il tuo team ci lavora
• *.supabase.co: database e accesso, anche via WebSocket
• cdn.screenbird.app: file, immagini, video e font personalizzati
• integrations.screenbird.app: le anteprime delle app nella dashboard
• lh3.googleusercontent.com e avatars.githubusercontent.com: le foto profilo degli account collegati
• challenges.cloudflare.com: il controllo di sicurezza all'accesso e alla registrazione
• wss://api.screenbird.app: gli aggiornamenti in tempo reale tra dashboard e schermi
• js.stripe.com e *.js.stripe.com: il popup di pagamento alla registrazione e alla modifica dell'abbonamento
• api.stripe.com e hooks.stripe.com: il completamento del pagamento, 3D Secure compreso
• m.stripe.com e m.stripe.network: il controllo antifrode di Stripe

Servono solo per funzioni specifiche:

• apis.google.com e docs.google.com: il selettore di Google Drive, Documenti, Fogli e Presentazioni
• images.pexels.com: la libreria di immagini stock
• api.qrserver.com: i codici QR nei modelli di design
• geocoding-api.open-meteo.com: la ricerca di una località nell'app Meteo

Domini per gli schermi

Per ogni dispositivo su cui gira il player:

• player.screenbird.app: il player vero e proprio
• api.screenbird.app: registrazione, heartbeat e recupero dei contenuti, anche via WebSocket
• cdn.screenbird.app: i contenuti che lo schermo riproduce
• media.screenbird.app: i file di installazione e gli aggiornamenti delle app
• integrations.screenbird.app: qui dentro girano tutte le app e i design
• mirror.screenbird.app: serve solo per la condivisione schermo, anche via WebSocket
• fonts.googleapis.com e fonts.gstatic.com: i font nelle app e nei design

Servono solo per alcune app:

• www.youtube.com e player.vimeo.com: le app video

Se non usi un collegamento o un'app, non devi autorizzare il dominio corrispondente.

Porte e protocolli

• HTTPS sulla porta 443 per tutto il traffico
• WebSocket Secure (WSS) sulla stessa porta 443 per gli aggiornamenti in tempo reale tra dashboard e schermo

Screenbird di per sé non usa nessun'altra porta. Un Amazon Signage Stick o una Fire TV ha invece bisogno di connessioni extra per impostare il proprio orologio (porta UDP 123 e porta TCP 80), vedi la sezione qui sotto.

Sincronizzazione dell'ora sui dispositivi Amazon

Questa sezione vale solo per l'Amazon Signage Stick e la Fire TV. Se usi un Samsung, LG, Android TV, PC, Mac o Raspberry Pi, puoi saltarla.

Questi dispositivi non hanno un orologio che continua a funzionare quando manca la corrente. Recuperano l'ora da internet all'avvio. Se non ci riescono, si avviano con una data che è indietro di settimane o mesi, e con la data sbagliata ogni connessione sicura viene rifiutata. Lo schermo resta quindi offline, anche con la porta 443 completamente aperta e tutti i domini in allowlist.

Consenti quindi queste connessioni:

• ftv-smp.ntp-fireos.com via UDP, porta 123: il recupero dell'ora. Questo nome viene risolto in time.aws.com; se il tuo firewall filtra per nome DNS, consenti entrambi
• firetvcaptiveportal.com, fireoscaptiveportal.com e kindle-time.amazon.com via TCP, porta 80, senza intercettazione: il controllo della rete e la soluzione di riserva per recuperare l'ora

La porta 80 è necessaria anche quando UDP 123 è aperta. Il dispositivo imposta l'ora solo su una rete che ha validato, e quel controllo è esso stesso una richiesta sulla porta 80. Se la porta 80 in uscita è bloccata, l'orologio non viene mai impostato, qualunque cosa succeda su UDP 123.

Il dispositivo riprova a ogni connessione a una rete e poi solo una volta ogni 7 giorni. Uno schermo che manca il primo tentativo può quindi restare a lungo con la data sbagliata. Una volta corretto il firewall, riavvia il dispositivo o ricollegalo alla rete per far partire un nuovo tentativo.

Cose a cui fare attenzione:

• Il dispositivo usa indirizzi fissi e non accetta un time server distribuito dalla rete stessa, quindi impostare un tuo time server non serve a niente.
• Il traffico sulla porta 80 non deve essere intercettato. Un proxy trasparente che inoltra la richiesta a internet va benissimo. Un proxy o un filtro web che risponde da solo, per esempio con una pagina di blocco, imposta l'orologio sulla propria ora, e questa è corretta solo se lo è l'orologio di quel proxy. Una cache che ripropone vecchie risposte può impostare un'ora obsoleta.
• Usa una rete senza pagina di accesso (captive portal). Su una rete con pagina di accesso il dispositivo fa un solo tentativo e non salva il risultato, quindi l'orologio non è affidabile finché il portale non viene superato. È esattamente quello che fanno molte reti ospiti.

Uno schermo resta associato ma offline mentre il dispositivo ha chiaramente internet? Questo è il primo posto dove guardare.

Larghezza di banda

La banda necessaria dipende dalle dimensioni dei tuoi contenuti. Uno schermo scarica un file una volta sola e poi lo riproduce in locale, quindi dopo il download il traffico è minimo. A riposo lo schermo tiene solo aperta la connessione con un heartbeat ogni 60 secondi. Se il WebSocket non funziona, lo schermo recupera comunque i contenuti ogni ora. Le dirette e le app che scaricano di continuo dati nuovi consumano invece banda, in base alla fonte.

Le brevi interruzioni di rete non fermano la riproduzione: i contenuti già scaricati continuano a essere riprodotti.

Verificare se la rete va bene

Sul dispositivo apri un browser e vai su:

• https://player.screenbird.app: qui deve comparire la schermata di associazione con un codice
• https://screenbird.app: qui deve comparire la pagina di accesso della dashboard

Se una delle due non si apre, controlla nei log del firewall quale dei domini qui sopra è bloccato.

Dove sono i miei dati?

• Il database gira su Supabase a Parigi (regione eu-west-3).
• I backup esterni sono su Backblaze ad Amsterdam (regione eu-central-003).
• La dashboard, le app e i file passano dalla rete di Cloudflare, che gira su nodi edge in tutto il mondo.

L'elenco completo dei responsabili del trattamento e i tempi di conservazione sono nell'informativa privacy su screenbird.app.

Assistenza per un rollout aziendale

Stai installando molti schermi dietro una rete aziendale e ti serve documentazione per il tuo reparto IT? Scrivi a support@screenbird.app.