Wymagania sieciowe i ustawienia zapory

Sam Screenbird korzysta wyłącznie z HTTPS i WebSocket Secure na porcie 443. W restrykcyjnej sieci dopisz do listy dozwolonych domeny podane niżej: jedna lista dotyczy panelu, druga ekranów, czyli odtwarzacza. Jeśli korzystasz z Amazon Signage Stick albo Fire TV, przeczytaj też sekcję Synchronizacja czasu na urządzeniach Amazon: te urządzenia potrzebują własnych, dodatkowych połączeń.

Kiedy jest to potrzebne?

Większość sieci domowych i biurowych działa od razu. Ta lista przyda się, gdy sieć blokuje nieznane domeny, korzysta z serwera proxy albo filtra WWW, lub gdy ekrany wiszą w osobnym VLAN-ie z ograniczonym dostępem do internetu.

Domeny dla panelu

Dla komputerów, na których zespół zarządza treścią:

• screenbird.app: sam panel
• dev.screenbird.app: staging, potrzebny tylko wtedy, gdy zespół z niego korzysta
• *.supabase.co: baza danych i logowanie, także przez WebSocket
• cdn.screenbird.app: pliki, obrazy, filmy i własne czcionki
• integrations.screenbird.app: podglądy aplikacji w panelu
• lh3.googleusercontent.com i avatars.githubusercontent.com: zdjęcia profilowe z połączonych kont
• challenges.cloudflare.com: kontrola bezpieczeństwa przy logowaniu i rejestracji
• wss://api.screenbird.app: aktualizacje na żywo między panelem a ekranami
• js.stripe.com i *.js.stripe.com: okienko płatności przy rejestracji i przy zmianie subskrypcji
• api.stripe.com i hooks.stripe.com: finalizacja płatności, łącznie z 3D Secure
• m.stripe.com i m.stripe.network: kontrola antyfraudowa Stripe

Potrzebne tylko przy wybranych funkcjach:

• apis.google.com i docs.google.com: okno wyboru dla Google Drive, Dokumentów, Arkuszy i Prezentacji
• images.pexels.com: biblioteka zdjęć stockowych
• api.qrserver.com: kody QR w szablonach projektów
• geocoding-api.open-meteo.com: wyszukiwanie lokalizacji w aplikacji Pogoda

Domeny dla ekranów

Dla każdego urządzenia, na którym działa odtwarzacz:

• player.screenbird.app: sam odtwarzacz
• api.screenbird.app: rejestracja urządzenia, sygnał obecności i pobieranie treści, także przez WebSocket
• cdn.screenbird.app: treść, którą ekran odtwarza
• media.screenbird.app: pliki instalacyjne i aktualizacje aplikacji
• integrations.screenbird.app: w tym środowisku działają wszystkie aplikacje i projekty
• mirror.screenbird.app: potrzebne tylko do udostępniania ekranu, także przez WebSocket
• fonts.googleapis.com i fonts.gstatic.com: czcionki w aplikacjach i projektach

Potrzebne tylko przy wybranych aplikacjach:

• www.youtube.com i player.vimeo.com: aplikacje wideo

Jeśli z danego połączenia albo z danej aplikacji nie korzystasz, nie musisz dopuszczać powiązanej domeny.

Porty i protokoły

• HTTPS na porcie 443 dla całego ruchu
• WebSocket Secure (WSS) na tym samym porcie 443 dla aktualizacji na żywo między panelem a ekranem

Sam Screenbird nie korzysta z żadnych innych portów. Amazon Signage Stick albo Fire TV potrzebuje jednak dodatkowych połączeń, żeby ustawić swój zegar (port UDP 123 i port TCP 80), zobacz sekcję niżej.

Synchronizacja czasu na urządzeniach Amazon

Ta sekcja dotyczy tylko Amazon Signage Stick i Fire TV. Jeśli korzystasz z Samsunga, LG, Android TV, PC, Maca albo Raspberry Pi, możesz ją pominąć.

Te urządzenia nie mają zegara, który działa dalej po odcięciu zasilania. Czas pobierają z internetu przy starcie. Jeśli się to nie uda, uruchamiają się z datą cofniętą o tygodnie albo miesiące, a przy błędnej dacie każde bezpieczne połączenie zostaje odrzucone. Ekran zostaje wtedy offline, nawet gdy port 443 jest w pełni otwarty i wszystkie domeny są na liście dozwolonych.

Dopuść więc te połączenia:

• ftv-smp.ntp-fireos.com przez UDP, port 123: pobieranie czasu. Ta nazwa wskazuje na time.aws.com; jeśli zapora filtruje po nazwie DNS, dopuść obie
• firetvcaptiveportal.com, fireoscaptiveportal.com i kindle-time.amazon.com przez TCP, port 80, bez przechwytywania: kontrola sieci i rozwiązanie awaryjne przy pobieraniu czasu

Port 80 jest potrzebny nawet wtedy, gdy UDP 123 jest otwarty. Urządzenie ustawia czas tylko w sieci, którą zweryfikowało, a ta kontrola sama jest żądaniem na porcie 80. Jeśli wychodzący port 80 jest zablokowany, zegar nigdy nie zostanie ustawiony, bez względu na to, co dzieje się na UDP 123.

Urządzenie ponawia próbę przy każdym połączeniu z siecią, a potem już tylko raz na 7 dni. Ekran, któremu nie uda się pierwsza próba, może więc długo pozostawać z błędną datą. Gdy zapora zostanie poprawiona, uruchom urządzenie ponownie albo połącz je ponownie z siecią, żeby wykonało nową próbę.

Na co zwrócić uwagę:

• Urządzenie korzysta ze stałych adresów i nie akceptuje serwera czasu przydzielanego przez samą sieć, więc wskazanie własnego serwera czasu nic nie da.
• Ruch na porcie 80 nie może być przechwytywany. Przezroczyste proxy, które przekazuje żądanie dalej do internetu, jest w porządku. Proxy albo filtr internetowy, który odpowiada samodzielnie, na przykład stroną blokady, ustawia zegar na swój własny czas, a ten jest poprawny tylko wtedy, gdy zegar tego proxy jest poprawny. Pamięć podręczna, która odtwarza stare odpowiedzi, może ustawić nieaktualny czas.
• Używaj sieci bez strony logowania (captive portal). W sieci ze stroną logowania urządzenie wykonuje jedną próbę i nie zapisuje wyniku, więc zegarowi można ufać dopiero po przejściu strony logowania. Dokładnie tak działa wiele sieci gościnnych.

Ekran jest sparowany, ale offline, mimo że urządzenie wyraźnie ma internet? To jest pierwsze miejsce, w które warto zajrzeć.

Przepustowość

Ile przepustowości potrzebujesz, zależy od wielkości Twoich treści. Ekran pobiera plik raz i odtwarza go potem lokalnie, więc po pobraniu ruch jest już znikomy. W spoczynku ekran tylko podtrzymuje połączenie sygnałem obecności co 60 sekund. Gdy WebSocket nie działa, ekran i tak pobiera swoją treść co godzinę. Transmisje na żywo oraz aplikacje, które wciąż pobierają nowe dane, zużywają przepustowość na bieżąco, zależnie od źródła.

Krótkie awarie sieci nie przerywają odtwarzania: pobrana treść gra dalej.

Sprawdzenie, czy sieć jest w porządku

Otwórz na urządzeniu przeglądarkę i wejdź na:

• https://player.screenbird.app: powinien pojawić się ekran parowania z kodem parowania
• https://screenbird.app: powinna pojawić się strona logowania do panelu

Jeśli któraś z nich się nie otwiera, sprawdź w logach zapory, która z powyższych domen jest blokowana.

Gdzie leżą moje dane?

• Baza danych działa w Supabase w Paryżu (region eu-west-3).
• Kopie zapasowe poza siedzibą leżą w Backblaze w Amsterdamie (region eu-central-003).
• Panel, aplikacje i pliki są dostarczane przez sieć Cloudflare, która działa w lokalizacjach brzegowych na całym świecie.

Pełną listę podmiotów przetwarzających i okresy przechowywania znajdziesz w polityce prywatności na screenbird.app.

Pomoc przy wdrożeniu firmowym

Wdrażasz wiele ekranów w sieci firmowej i potrzebujesz dokumentacji dla swojego działu IT? Napisz na support@screenbird.app.