Nettverkskrav og brannmurinnstillinger

Screenbird bruker selv bare HTTPS og WebSocket Secure over port 443. På et strengt nettverk må du åpne for domenene nedenfor: én liste for dashbordet og én for skjermene (avspilleren). Bruker du en Amazon Signage Stick eller en Fire TV, les også avsnittet Tidssynkronisering på Amazon-enheter: disse enhetene trenger selv ekstra tilkoblinger.

Når trenger du dette?

De fleste hjemme- og kontornettverk fungerer med en gang. Du trenger denne listen hvis nettverket blokkerer ukjente domener, bruker en proxy eller et nettfilter, eller hvis skjermene står i et eget VLAN med begrenset internettilgang.

Domener for dashbordet

For maskinene der teamet ditt administrerer innhold:

• screenbird.app: selve dashbordet
• dev.screenbird.app: staging, bare nødvendig hvis teamet ditt jobber med den
• *.supabase.co: database og innlogging, også via WebSocket
• cdn.screenbird.app: filer, bilder, videoer og egne skrifttyper
• integrations.screenbird.app: forhåndsvisningene av appene i dashbordet
• lh3.googleusercontent.com og avatars.githubusercontent.com: profilbilder fra tilkoblede kontoer
• challenges.cloudflare.com: sikkerhetssjekken ved innlogging og registrering
• wss://api.screenbird.app: sanntidsoppdateringer mellom dashbord og skjermer
• js.stripe.com og *.js.stripe.com: betalingsvinduet ved registrering og når du endrer abonnementet
• api.stripe.com og hooks.stripe.com: fullføringen av betalingen, inkludert 3D Secure
• m.stripe.com og m.stripe.network: svindelkontrollen til Stripe

Bare nødvendig for enkelte funksjoner:

• apis.google.com og docs.google.com: velgeren for Google Disk, Dokumenter, Regneark og Presentasjoner
• images.pexels.com: stockbildebiblioteket
• api.qrserver.com: QR-koder i designmaler
• geocoding-api.open-meteo.com: stedssøket i Vær-appen

Domener for skjermene

For hver enhet som kjører avspilleren:

• player.screenbird.app: selve avspilleren
• api.screenbird.app: pålogging, hjerteslag og henting av innhold, også via WebSocket
• cdn.screenbird.app: innholdet skjermen spiller av
• media.screenbird.app: installasjonsfiler og oppdateringer av appene
• integrations.screenbird.app: alle apper og design kjører her
• mirror.screenbird.app: bare nødvendig for Skjermdeling, også via WebSocket
• fonts.googleapis.com og fonts.gstatic.com: skrifttyper i apper og design

Bare nødvendig for enkelte apper:

• www.youtube.com og player.vimeo.com: videoappene

Bruker du ikke en tilkobling eller en app, trenger du heller ikke åpne for domenet som hører til.

Porter og protokoller

• HTTPS over port 443 for all trafikk
• WebSocket Secure (WSS) over den samme porten 443 for sanntidsoppdateringer mellom dashbord og skjerm

Screenbird bruker selv ingen andre porter. En Amazon Signage Stick eller Fire TV trenger derimot ekstra tilkoblinger for å stille klokken sin (UDP-port 123 og TCP-port 80), se avsnittet nedenfor.

Tidssynkronisering på Amazon-enheter

Dette avsnittet gjelder bare Amazon Signage Stick og Fire TV. Bruker du en Samsung, LG, Android TV, PC, Mac eller Raspberry Pi, kan du hoppe over det.

Disse enhetene har ingen klokke som går videre når strømmen forsvinner. De henter tiden fra internett ved oppstart. Går ikke det, starter de opp med en dato som ligger uker til måneder tilbake i tid, og med feil dato blir enhver sikker forbindelse avvist. Skjermen forblir da offline, selv om port 443 er helt åpen, og selv om du har åpnet for alle domenene.

Åpne derfor for disse tilkoblingene:

• ftv-smp.ntp-fireos.com over UDP, port 123: henter tiden. Dette navnet peker til time.aws.com; hvis brannmuren din filtrerer på DNS-navn, må du åpne for begge
• firetvcaptiveportal.com, fireoscaptiveportal.com og kindle-time.amazon.com over TCP, port 80, uten avskjæring: nettverkskontrollen og reserveløsningen for å hente tiden

Port 80 er nødvendig, selv når UDP 123 er åpen. Enheten stiller bare klokken på et nettverk den har validert, og den kontrollen er selv en forespørsel på port 80. Hvis utgående port 80 er blokkert, blir klokken aldri stilt, uansett hva som skjer på UDP 123.

Enheten prøver på nytt hver gang den kobler til et nettverk, og deretter bare én gang hver 7. dag. En skjerm som går glipp av det første forsøket, kan derfor stå med feil dato lenge. Når brannmuren er rettet, må du starte enheten på nytt eller koble den til nettverket igjen for å utløse et nytt forsøk.

Ting å være oppmerksom på:

• Enheten bruker faste adresser og godtar ikke en tidsserver som nettverket selv deler ut, så det hjelper ikke å peke den mot din egen tidsserver.
• Trafikk på port 80 må ikke fanges opp. En transparent proxy som sender forespørselen videre til internett, er helt i orden. En proxy eller et nettfilter som svarer selv, for eksempel med en blokkeringsside, stiller klokken til sin egen tid, og det stemmer bare hvis klokken til den proxyen stemmer. En hurtigbuffer som spiller av gamle svar på nytt, kan stille en utdatert tid.
• Bruk et nettverk uten innloggingsside (captive portal). På et nettverk med innloggingsside gjør enheten ett eneste forsøk og lagrer ikke resultatet, så klokken kan ikke stoles på før portalen er passert. Det er nøyaktig hva mange gjestenettverk gjør.

Er en skjerm koblet til, men offline, selv om enheten tydelig har internett? Da er dette det første stedet å se.

Båndbredde

Hvor mye båndbredde du trenger, kommer an på hvor stort innholdet ditt er. En skjerm laster ned en fil én gang og spiller den av lokalt etterpå, så etter nedlastingen er det nesten ingen trafikk. Når det er rolig, holder skjermen bare forbindelsen åpen med et hjerteslag hvert 60. sekund. Fungerer ikke WebSocket, henter skjermen innholdet sitt hver time likevel. Direktesendinger og apper som stadig henter nye data, bruker båndbredde hele tiden, avhengig av kilden.

Korte nettverksbrudd stopper ikke avspillingen: innhold som er lastet ned, spiller videre.

Teste om nettverket er riktig satt opp

Åpne en nettleser på enheten og gå til:

• https://player.screenbird.app: her skal koblingsskjermen med en koblingskode dukke opp
• https://screenbird.app: her skal innloggingssiden til dashbordet dukke opp

Får du ikke opp én av dem, se i brannmurloggene hvilket av domenene over som blokkeres.

Hvor ligger dataene mine?

• Databasen kjører hos Supabase i Paris (regionen eu-west-3).
• Sikkerhetskopiene utenfor huset ligger hos Backblaze i Amsterdam (regionen eu-central-003).
• Dashbordet, appene og filene leveres via nettverket til Cloudflare, som kjører på edge-lokasjoner over hele verden.

Hele listen over databehandlere og lagringstidene står i personvernerklæringen på screenbird.app.

Hjelp til en utrulling i bedriften

Ruller du ut mange skjermer bak et bedriftsnettverk og trenger dokumentasjon til IT-avdelingen? Send en e-post til support@screenbird.app.