Netværkskrav og firewallindstillinger

Screenbird selv bruger kun HTTPS og WebSocket Secure over port 443. På et stramt netværk skal du give domænerne herunder adgang: én liste til dashboardet og én til skærmene (playeren). Bruger du en Amazon Signage Stick eller en Fire TV, så læs også afsnittet Tidssynkronisering på Amazon-enheder: disse enheder har selv brug for ekstra forbindelser.

Hvornår har du brug for det her?

De fleste hjemme- og kontornetværk virker med det samme. Du får brug for listen, hvis netværket blokerer ukendte domæner, bruger en proxy eller et webfilter, eller hvis skærmene hænger i et separat VLAN med begrænset internetadgang.

Domæner til dashboardet

Til de computere, hvor dit team styrer indholdet:

• screenbird.app: selve dashboardet
• dev.screenbird.app: staging, kun nødvendigt, hvis dit team arbejder med det
• *.supabase.co: database og login, også via WebSocket
• cdn.screenbird.app: filer, billeder, videoer og egne skrifttyper
• integrations.screenbird.app: forhåndsvisningen af apps i dashboardet
• lh3.googleusercontent.com og avatars.githubusercontent.com: profilbilleder fra tilknyttede konti
• challenges.cloudflare.com: sikkerhedstjekket ved login og tilmelding
• wss://api.screenbird.app: liveopdateringer mellem dashboard og skærme
• js.stripe.com og *.js.stripe.com: betalingsvinduet ved tilmelding og ved ændring af abonnementet
• api.stripe.com og hooks.stripe.com: gennemførelsen af betalingen, inklusive 3D Secure
• m.stripe.com og m.stripe.network: Stripes svindelkontrol

Kun nødvendigt til bestemte funktioner:

• apis.google.com og docs.google.com: vælgeren til Google Drev, Docs, Sheets og Slides
• images.pexels.com: stockfotobiblioteket
• api.qrserver.com: QR-koder i designskabeloner
• geocoding-api.open-meteo.com: søgningen efter en lokation i Vejr-appen

Domæner til skærmene

Til hver enhed, hvor playeren kører:

• player.screenbird.app: selve playeren
• api.screenbird.app: tilknytning, heartbeat og hentning af indhold, også via WebSocket
• cdn.screenbird.app: det indhold, skærmen afspiller
• media.screenbird.app: installationsfiler og opdateringer til apps
• integrations.screenbird.app: alle apps og design kører herinde
• mirror.screenbird.app: kun nødvendigt til skærmdeling, også via WebSocket
• fonts.googleapis.com og fonts.gstatic.com: skrifttyper i apps og design

Kun nødvendigt til bestemte apps:

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

Bruger du ikke en bestemt forbindelse eller app, behøver du heller ikke give det tilhørende domæne adgang.

Porte og protokoller

• HTTPS over port 443 til al trafik
• WebSocket Secure (WSS) over den samme port 443 til liveopdateringer mellem dashboard og skærm

Screenbird selv bruger ingen andre porte. En Amazon Signage Stick eller Fire TV har dog brug for ekstra forbindelser for at stille sit ur (UDP-port 123 og TCP-port 80), se afsnittet herunder.

Tidssynkronisering på Amazon-enheder

Dette afsnit gælder kun for Amazon Signage Stick og Fire TV. Bruger du en Samsung, LG, Android TV, pc, Mac eller Raspberry Pi, kan du springe det over.

Disse enheder har intet ur, der bliver ved med at gå, når strømmen forsvinder. De henter tiden fra internettet ved opstart. Lykkes det ikke, starter de op med en dato, der ligger uger til måneder tilbage i tiden, og med en forkert dato bliver enhver sikker forbindelse afvist. Skærmen forbliver derfor offline, selv om port 443 er helt åben, og alle domænerne har fået adgang.

Giv derfor adgang til disse forbindelser:

• ftv-smp.ntp-fireos.com over UDP, port 123: henter tiden. Dette navn peger på time.aws.com; hvis din firewall giver adgang efter DNS-navn, skal du give adgang til begge
• firetvcaptiveportal.com, fireoscaptiveportal.com og kindle-time.amazon.com over TCP, port 80, uden at blive opfanget: netværkstjekket og reserveløsningen til at hente tiden

Port 80 er påkrævet, selv når UDP 123 er åben. Enheden stiller kun sit ur på et netværk, som den har valideret, og det tjek er selv en forespørgsel på port 80. Hvis udgående port 80 er blokeret, bliver uret aldrig stillet, uanset hvad der sker på UDP 123.

Enheden prøver igen, hver gang den forbinder til et netværk, og derefter kun én gang hver 7. dag. En skærm, der misser det første forsøg, kan derfor blive stående med en forkert dato i lang tid. Når firewallen er rettet, skal du genstarte enheden eller forbinde den til netværket igen for at udløse et nyt forsøg.

Ting at være opmærksom på:

• Enheden bruger faste adresser og accepterer ikke en tidsserver, som netværket selv deler ud, så det hjælper ikke at pege den mod din egen tidsserver.
• Trafik på port 80 må ikke opfanges. En transparent proxy, der sender forespørgslen videre til internettet, er fin. En proxy eller et webfilter, der svarer selv, for eksempel med en blokeringsside, stiller uret til sit eget klokkeslæt, og det er kun rigtigt, hvis proxyens ur er rigtigt. En cache, der afspiller gamle svar igen, kan stille en forældet tid.
• Brug et netværk uden loginside (captive portal). På et netværk med en loginside gør enheden ét enkelt forsøg og gemmer ikke resultatet, så uret kan ikke stoles på, før portalen er passeret. Det er præcis, hvad mange gæstenetværk gør.

Er en skærm tilknyttet, men offline, selvom enheden tydeligvis har internet? Så er det her, du skal kigge først.

Båndbredde

Hvor meget båndbredde du har brug for, afhænger af størrelsen på dit indhold. En skærm henter en fil én gang og afspiller den derefter lokalt, så efter download er der næsten ingen trafik. I hvile holder skærmen kun forbindelsen i live med et heartbeat hvert 60. sekund. Virker WebSocket ikke, henter skærmen alligevel sit indhold hver time. Livestreams og apps, der hele tiden henter nye data, bliver ved med at bruge båndbredde, afhængigt af kilden.

Korte netværksudfald afbryder ikke afspilningen, for hentet indhold spiller videre.

Test, om netværket er sat rigtigt op

Åbn en browser på enheden, og gå til:

• https://player.screenbird.app: her skal tilknytningsskærmen med en parringskode dukke op
• https://screenbird.app: her skal login-siden til dashboardet dukke op

Virker en af delene ikke, så kig i firewallens logfiler efter, hvilket af domænerne ovenfor der bliver blokeret.

Hvor ligger mine data?

• Databasen kører hos Supabase i Paris (regionen eu-west-3).
• Offsite-backupperne ligger hos Backblaze i Amsterdam (regionen eu-central-003).
• Dashboardet, apps og filerne leveres via Cloudflares netværk, som kører på edge-lokationer over hele verden.

Den fulde liste over databehandlere og opbevaringsperioder står i privatlivspolitikken på screenbird.app.

Hjælp til en udrulning i virksomheden

Ruller du mange skærme ud bag et virksomhedsnetværk og har du brug for dokumentation til din it-afdeling? Så skriv til support@screenbird.app.