Nätverkskrav och brandväggsinställningar

Screenbird använder själv bara HTTPS och WebSocket Secure över port 443. På ett strikt nätverk sätter du domänerna nedan på tillåtelselistan: en lista för instrumentpanelen och en för skärmarna (spelarappen). Använder du en Amazon Signage Stick eller en Fire TV, läs även avsnittet Tidssynkronisering på Amazon-enheter: de enheterna behöver egna extra anslutningar.

När behöver du det här?

De flesta hem- och kontorsnätverk fungerar direkt. Listan behöver du om nätverket blockerar okända domäner, använder en proxy eller ett webbfilter, eller om skärmarna sitter i ett eget VLAN med begränsad internetåtkomst.

Domäner för instrumentpanelen

För datorerna där ditt team sköter innehållet:

• screenbird.app: själva instrumentpanelen
• dev.screenbird.app: staging, behövs bara om ditt team arbetar med den
• *.supabase.co: databas och inloggning, även via WebSocket
• cdn.screenbird.app: filer, bilder, videor och egna typsnitt
• integrations.screenbird.app: appförhandsvisningarna i instrumentpanelen
• lh3.googleusercontent.com och avatars.githubusercontent.com: profilbilder från anslutna konton
• challenges.cloudflare.com: säkerhetskontrollen vid inloggning och registrering
• wss://api.screenbird.app: liveuppdateringar mellan instrumentpanel och skärmar
• js.stripe.com och *.js.stripe.com: betalningsrutan vid registrering och när du ändrar din prenumeration
• api.stripe.com och hooks.stripe.com: slutförandet av betalningen, inklusive 3D Secure
• m.stripe.com och m.stripe.network: Stripes bedrägerikontroll

Behövs bara för vissa funktioner:

• apis.google.com och docs.google.com: väljaren för Google Drive, Dokument, Kalkylark och Presentationer
• images.pexels.com: stockbildsbiblioteket
• api.qrserver.com: QR-koder i designmallar
• geocoding-api.open-meteo.com: platssökningen i Väder-appen

Domäner för skärmarna

För varje enhet som kör spelarappen:

• player.screenbird.app: själva spelarappen
• api.screenbird.app: inloggning, heartbeat och hämtning av innehåll, även via WebSocket
• cdn.screenbird.app: innehållet som skärmen spelar upp
• media.screenbird.app: installationsfiler och uppdateringar av apparna
• integrations.screenbird.app: alla appar och designer körs här inne
• mirror.screenbird.app: behövs bara för Skärmdelning, även via WebSocket
• fonts.googleapis.com och fonts.gstatic.com: typsnitt i appar och designer

Behövs bara för vissa appar:

• www.youtube.com och player.vimeo.com: videoapparna

Använder du inte en anslutning eller en app behöver du inte tillåta domänen som hör till den.

Portar och protokoll

• HTTPS över port 443 för all trafik
• WebSocket Secure (WSS) över samma port 443 för liveuppdateringar mellan instrumentpanel och skärm

Screenbird använder själv inga andra portar. En Amazon Signage Stick eller Fire TV behöver däremot extra anslutningar för att ställa sin klocka (UDP-port 123 och TCP-port 80), se avsnittet nedan.

Tidssynkronisering på Amazon-enheter

Det här avsnittet gäller bara Amazon Signage Stick och Fire TV. Använder du en Samsung, LG, Android TV, PC, Mac eller Raspberry Pi kan du hoppa över det.

De här enheterna har ingen klocka som går vidare när strömmen bryts. De hämtar tiden från internet vid uppstart. Går det inte, startar de med ett datum som ligger veckor eller månader tillbaka i tiden, och med fel datum nekas varje säker anslutning. Skärmen förblir då offline, även om port 443 är helt öppen och alla domäner finns på din tillåtelselista.

Släpp därför igenom dessa anslutningar:

• ftv-smp.ntp-fireos.com över UDP, port 123: hämtar tiden. Det här namnet pekar på time.aws.com; om din brandvägg filtrerar på DNS-namn, släpp igenom båda
• firetvcaptiveportal.com, fireoscaptiveportal.com och kindle-time.amazon.com över TCP, port 80, utan att fångas upp: nätverkskontrollen och reservlösningen för att hämta tiden

Port 80 krävs, även när UDP 123 är öppen. Enheten ställer bara sin klocka på ett nätverk som den har validerat, och den kontrollen är själv en begäran på port 80. Om utgående port 80 är blockerad ställs klockan aldrig, oavsett vad som händer på UDP 123.

Enheten försöker igen varje gång den ansluter till ett nätverk och därefter bara en gång var 7:e dag. En skärm som missar det första försöket kan därför stå med fel datum länge. När brandväggen är åtgärdad, starta om enheten eller anslut den till nätverket igen för att utlösa ett nytt försök.

Saker att tänka på:

• Enheten använder fasta adresser och accepterar inte en tidsserver som nätverket delar ut, så att peka den mot en egen tidsserver hjälper inte.
• Trafik på port 80 får inte fångas upp. En transparent proxy som skickar vidare begäran till internet är i sin ordning. En proxy eller ett webbfilter som svarar själv, till exempel med en blockeringssida, ställer klockan på sin egen tid, och det stämmer bara om proxyns klocka stämmer. En cache som spelar upp gamla svar igen kan ställa en föråldrad tid.
• Använd ett nätverk utan inloggningssida (captive portal). På ett nätverk med inloggningssida gör enheten ett enda försök och sparar inte resultatet, så klockan går inte att lita på förrän portalen är passerad. Det är precis vad många gästnätverk gör.

Är en skärm parkopplad men offline trots att enheten tydligt har internet? Då är det här du ska titta först.

Bandbredd

Hur mycket bandbredd du behöver beror på hur stort ditt innehåll är. En skärm laddar ner en fil en gång och spelar sedan upp den lokalt, så efter nedladdningen går det knappt någon trafik alls. I vila håller skärmen bara anslutningen vid liv med en heartbeat var 60:e sekund. Fungerar inte WebSocket hämtar skärmen ändå sitt innehåll varje timme. Livesändningar och appar som hela tiden hämtar nya data drar bandbredd hela tiden, beroende på källan.

Korta nätverksavbrott stoppar inte uppspelningen: nedladdat innehåll spelas vidare.

Testa att nätverket stämmer

Öppna en webbläsare på enheten och gå till:

• https://player.screenbird.app: här ska parkopplingsskärmen med en parkopplingskod dyka upp
• https://screenbird.app: här ska instrumentpanelens inloggningssida dyka upp

Går någon av de två inte att nå, titta i brandväggsloggarna vilken av domänerna ovan som blockeras.

Var lagras mina uppgifter?

• Databasen körs hos Supabase i Paris (regionen eu-west-3).
• Offsite-backuperna ligger hos Backblaze i Amsterdam (regionen eu-central-003).
• Instrumentpanelen, apparna och filerna levereras via Cloudflares nätverk, som körs på edge-platser över hela världen.

Hela listan över underbiträden och lagringstiderna står i integritetspolicyn på screenbird.app.

Hjälp vid en företagsutrullning

Rullar du ut många skärmar bakom ett företagsnätverk och behöver dokumentation till din IT-avdelning? Mejla då support@screenbird.app.