Netzwerkanforderungen und Firewall-Einstellungen

Screenbird selbst nutzt ausschließlich HTTPS und WebSocket Secure über Port 443. In einem streng abgesicherten Netzwerk setzt du die Domains unten auf die Allowlist: eine Liste für das Dashboard und eine für die Bildschirme (den Player). Nutzt du einen Amazon Signage Stick oder einen Fire TV, lies zusätzlich den Abschnitt Zeitsynchronisation auf Amazon-Geräten: Diese Geräte brauchen eigene zusätzliche Verbindungen.

Wann brauchst du das?

Die meisten Heim- und Büronetzwerke funktionieren sofort. Diese Liste brauchst du, wenn das Netzwerk unbekannte Domains blockiert, einen Proxy oder Webfilter einsetzt oder wenn die Bildschirme in einem eigenen VLAN mit eingeschränktem Internetzugang hängen.

Domains für das Dashboard

Für die Rechner, auf denen dein Team Inhalte verwaltet:

  • screenbird.app: das Dashboard selbst
  • dev.screenbird.app: Staging, nur nötig, wenn dein Team damit arbeitet
  • *.supabase.co: Datenbank und Anmeldung, auch über WebSocket
  • cdn.screenbird.app: Dateien, Bilder, Videos und eigene Schriftarten
  • integrations.screenbird.app: die App-Vorschauen im Dashboard
  • lh3.googleusercontent.com und avatars.githubusercontent.com: Profilbilder verbundener Konten
  • challenges.cloudflare.com: Sicherheitsprüfung beim Anmelden und beim Registrieren
  • wss://api.screenbird.app: Live-Updates zwischen Dashboard und Bildschirmen
  • js.stripe.com und *.js.stripe.com: das Bezahlfenster beim Registrieren und beim Ändern deines Abos
  • api.stripe.com und hooks.stripe.com: der Abschluss der Zahlung, inklusive 3D Secure
  • m.stripe.com und m.stripe.network: die Betrugsprüfung von Stripe

Nur für bestimmte Funktionen nötig:

  • apis.google.com und docs.google.com: die Auswahl für Google Drive, Docs, Tabellen und Präsentationen
  • images.pexels.com: die Stockfoto-Bibliothek
  • api.qrserver.com: QR-Codes in Designvorlagen
  • geocoding-api.open-meteo.com: die Ortssuche in der Wetter-App

Domains für die Bildschirme

Für jedes Gerät, auf dem der Player läuft:

  • player.screenbird.app: der Player selbst
  • api.screenbird.app: Anmeldung, Heartbeat und Abruf der Inhalte, auch über WebSocket
  • cdn.screenbird.app: die Inhalte, die der Bildschirm abspielt
  • media.screenbird.app: Installationsdateien und Updates der Apps
  • integrations.screenbird.app: darin laufen alle Apps und Designs
  • mirror.screenbird.app: nur nötig für die Bildschirmfreigabe, auch über WebSocket
  • fonts.googleapis.com und fonts.gstatic.com: Schriftarten in Apps und Designs

Nur für bestimmte Apps nötig:

  • www.youtube.com und player.vimeo.com: die Video-Apps

Nutzt du eine Verbindung oder eine App nicht, musst du die zugehörige Domain auch nicht freigeben.

Ports und Protokolle

  • HTTPS über Port 443 für den gesamten Verkehr
  • WebSocket Secure (WSS) über denselben Port 443 für Live-Updates zwischen Dashboard und Bildschirm

Screenbird selbst nutzt keine weiteren Ports. Ein Amazon Signage Stick oder Fire TV braucht zusätzlich Verbindungen, um seine Uhr zu stellen (UDP-Port 123 und TCP-Port 80), siehe den Abschnitt unten.

Zeitsynchronisation auf Amazon-Geräten

Dieser Abschnitt gilt nur für den Amazon Signage Stick und den Fire TV. Nutzt du einen Samsung, LG, Android TV, PC, Mac oder Raspberry Pi, kannst du ihn überspringen.

Diese Geräte haben keine Uhr, die weiterläuft, wenn der Strom ausfällt. Sie holen sich die Zeit beim Start aus dem Internet. Klappt das nicht, starten sie mit einem Datum, das Wochen oder Monate in der Vergangenheit liegt, und mit dem falschen Datum wird jede sichere Verbindung abgelehnt. Der Bildschirm bleibt dann offline, selbst wenn Port 443 vollständig offen ist und alle Domains auf der Allowlist stehen.

Gib deshalb diese Verbindungen frei:

  • ftv-smp.ntp-fireos.com über UDP, Port 123: das Abrufen der Zeit. Dieser Name verweist auf time.aws.com; filtert deine Firewall nach DNS-Name, gib beide frei
  • firetvcaptiveportal.com, fireoscaptiveportal.com und kindle-time.amazon.com über TCP, Port 80, nicht abgefangen: die Netzwerkprüfung und die Rückfalllösung für das Abrufen der Zeit

Port 80 ist auch dann nötig, wenn UDP 123 offen ist. Das Gerät stellt seine Uhr nur in einem Netzwerk, das es geprüft hat, und diese Prüfung ist selbst eine Anfrage auf Port 80. Ist ausgehender Port 80 gesperrt, wird die Uhr nie gestellt, egal was auf UDP 123 passiert.

Das Gerät versucht es bei jeder Verbindung mit einem Netzwerk erneut und danach nur noch einmal alle 7 Tage. Ein Bildschirm, der den ersten Versuch verpasst, kann deshalb lange mit dem falschen Datum weiterlaufen. Ist die Firewall angepasst, starte das Gerät neu oder verbinde es erneut mit dem Netzwerk, damit es einen neuen Versuch unternimmt.

Darauf solltest du achten:

  • Das Gerät nutzt feste Adressen und akzeptiert keinen Zeitserver, den das Netzwerk selbst verteilt, einen eigenen Zeitserver anzugeben hilft also nicht.
  • Verkehr auf Port 80 darf nicht abgefangen werden. Ein transparenter Proxy, der die Anfrage ins Internet weiterleitet, ist in Ordnung. Ein Proxy oder Webfilter, der selbst antwortet, zum Beispiel mit einer Sperrseite, stellt die Uhr auf seine eigene Zeit, und die stimmt nur, wenn die Uhr dieses Proxys stimmt. Ein Cache, der alte Antworten wiedergibt, kann eine veraltete Zeit setzen.
  • Nutze ein Netzwerk ohne Anmeldeseite (Captive Portal). In einem Netzwerk mit Anmeldeseite macht das Gerät nur einen Versuch und speichert das Ergebnis nicht, die Uhr ist also erst verlässlich, wenn die Anmeldeseite durchlaufen ist. Genau das tun viele Gastnetzwerke.

Bleibt ein Bildschirm gekoppelt, aber offline, während das Gerät eindeutig Internet hat? Dann ist das der erste Ort, an dem du nachschaust.

Bandbreite

Wie viel Bandbreite du brauchst, hängt von der Größe deiner Inhalte ab. Ein Bildschirm lädt eine Datei einmal herunter und spielt sie danach lokal ab, nach dem Download entsteht also kaum noch Verkehr. Im Ruhezustand hält ein Bildschirm nur die Verbindung offen, mit einem Heartbeat alle 60 Sekunden. Funktioniert der WebSocket nicht, holt sich der Bildschirm seine Inhalte stündlich trotzdem ab. Livestreams und Apps, die laufend neue Daten abrufen, verbrauchen weiterhin Bandbreite, je nach Quelle.

Kurze Netzwerkstörungen unterbrechen die Wiedergabe nicht: Heruntergeladene Inhalte laufen einfach weiter.

Prüfen, ob das Netzwerk stimmt

Öffne auf dem Gerät einen Browser und gehe zu:

  • https://player.screenbird.app: hier sollte der Kopplungsbildschirm mit einem Kopplungscode erscheinen
  • https://screenbird.app: hier sollte die Anmeldeseite des Dashboards erscheinen

Klappt eines von beiden nicht, schau in den Firewall-Logs nach, welche der oben genannten Domains blockiert wird.

Wo liegen meine Daten?

  • Die Datenbank läuft bei Supabase in Paris (Region eu-west-3).
  • Die Offsite-Backups liegen bei Backblaze in Amsterdam (Region eu-central-003).
  • Das Dashboard, die Apps und die Dateien werden über das Netzwerk von Cloudflare ausgeliefert, das weltweit an Edge-Standorten läuft.

Die vollständige Liste der Auftragsverarbeiter und die Aufbewahrungsfristen stehen in der Datenschutzerklärung auf screenbird.app.

Hilfe beim Rollout im Unternehmen

Rollst du viele Bildschirme hinter einem Firmennetzwerk aus und brauchst du Unterlagen für deine IT-Abteilung? Dann schreib eine Mail an support@screenbird.app.

Verwandte Artikel

© screenbird.app