Prérequis réseau et paramètres de pare-feu

Screenbird lui-même utilise uniquement HTTPS et WebSocket Secure sur le port 443. Sur un réseau strict, ajoutez les domaines ci-dessous à votre liste d'autorisation : une liste pour le tableau de bord, une autre pour les écrans (le lecteur). Si vous utilisez un Amazon Signage Stick ou une Fire TV, lisez aussi la section Synchronisation de l'heure sur les appareils Amazon : ces appareils ont besoin de connexions supplémentaires qui leur sont propres.

Quand en avez-vous besoin ?

La plupart des réseaux domestiques et de bureau fonctionnent tout de suite. Cette liste vous sert si le réseau bloque les domaines inconnus, s'il passe par un proxy ou un filtre web, ou si les écrans se trouvent dans un VLAN séparé dont l'accès à internet est limité.

Domaines pour le tableau de bord

Pour les ordinateurs sur lesquels votre équipe gère le contenu :

• screenbird.app : le tableau de bord lui-même
• dev.screenbird.app : l'environnement de préproduction, utile seulement si votre équipe y travaille
• *.supabase.co : base de données et connexion au compte, y compris en WebSocket
• cdn.screenbird.app : fichiers, images, vidéos et polices importées
• integrations.screenbird.app : les aperçus d'applications dans le tableau de bord
• lh3.googleusercontent.com et avatars.githubusercontent.com : les photos de profil des comptes liés
• challenges.cloudflare.com : le contrôle de sécurité à la connexion et à l'inscription
• wss://api.screenbird.app : les mises à jour en direct entre le tableau de bord et les écrans
• js.stripe.com et *.js.stripe.com : la fenêtre de paiement à l'inscription et lors d'un changement d'abonnement
• api.stripe.com et hooks.stripe.com : la finalisation du paiement, 3D Secure compris
• m.stripe.com et m.stripe.network : le contrôle antifraude de Stripe

Utiles uniquement pour certaines fonctions :

• apis.google.com et docs.google.com : le sélecteur Google Drive, Docs, Sheets et Slides
• images.pexels.com : la banque de photos
• api.qrserver.com : les QR codes dans les modèles de design
• geocoding-api.open-meteo.com : la recherche d'un lieu dans l'application Météo

Domaines pour les écrans

Pour chaque appareil qui fait tourner le lecteur :

• player.screenbird.app : le lecteur lui-même
• api.screenbird.app : l'enregistrement, le signal de présence et la récupération du contenu, y compris en WebSocket
• cdn.screenbird.app : le contenu que l'écran diffuse
• media.screenbird.app : les fichiers d'installation et les mises à jour des applications
• integrations.screenbird.app : toutes les applications et tous les designs tournent à l'intérieur
• mirror.screenbird.app : utile uniquement pour le partage d'écran, y compris en WebSocket
• fonts.googleapis.com et fonts.gstatic.com : les polices des applications et des designs

Utiles uniquement pour certaines applications :

• www.youtube.com et player.vimeo.com : les applications vidéo

Si vous n'utilisez pas une connexion ou une application, vous n'avez pas besoin d'autoriser le domaine correspondant.

Ports et protocoles

• HTTPS sur le port 443 pour tout le trafic
• WebSocket Secure (WSS) sur ce même port 443 pour les mises à jour en direct entre le tableau de bord et l'écran

Screenbird lui-même n'utilise aucun autre port. Un Amazon Signage Stick ou une Fire TV a en revanche besoin de connexions supplémentaires pour régler son horloge (port UDP 123 et port TCP 80), voir la section ci-dessous.

Synchronisation de l'heure sur les appareils Amazon

Cette section concerne uniquement l'Amazon Signage Stick et la Fire TV. Si vous utilisez un Samsung, LG, Android TV, PC, Mac ou Raspberry Pi, vous pouvez la passer.

Ces appareils n'ont pas d'horloge qui continue de tourner une fois l'alimentation coupée. Ils récupèrent l'heure sur internet au démarrage. Si cela échoue, ils démarrent avec une date qui remonte à des semaines, voire des mois, et avec une date erronée, toute connexion sécurisée est refusée. L'écran reste alors hors ligne, même avec le port 443 entièrement ouvert et tous les domaines dans votre liste d'autorisation.

Autorisez donc ces connexions :

• ftv-smp.ntp-fireos.com en UDP, port 123 : la récupération de l'heure. Ce nom renvoie vers time.aws.com ; si votre pare-feu filtre par nom DNS, autorisez les deux
• firetvcaptiveportal.com, fireoscaptiveportal.com et kindle-time.amazon.com en TCP, port 80, sans interception : la vérification du réseau et la solution de repli pour récupérer l'heure

Le port 80 est nécessaire, même quand l'UDP 123 est ouvert. L'appareil ne règle son heure que sur un réseau qu'il a validé, et cette vérification est elle-même une requête sur le port 80. Si le port 80 sortant est bloqué, l'horloge n'est jamais réglée, quoi qu'il se passe sur UDP 123.

L'appareil réessaie à chaque connexion à un réseau, puis seulement une fois tous les 7 jours. Un écran qui rate la première tentative peut donc rester longtemps à la mauvaise date. Une fois le pare-feu corrigé, redémarrez l'appareil ou reconnectez-le au réseau pour déclencher une nouvelle tentative.

Points à surveiller :

• L'appareil utilise des adresses fixes et n'accepte pas un serveur horaire distribué par le réseau lui-même : indiquer votre propre serveur horaire ne sert donc à rien.
• Le trafic du port 80 ne doit pas être intercepté. Un proxy transparent qui transmet la requête à internet ne pose pas de problème. Un proxy ou un filtre web qui répond lui-même, par exemple avec une page de blocage, règle l'horloge sur sa propre heure, ce qui n'est correct que si l'horloge de ce proxy l'est. Un cache qui rejoue d'anciennes réponses peut régler une heure périmée.
• Utilisez un réseau sans page de connexion (portail captif). Sur un réseau avec page de connexion, l'appareil fait une seule tentative et n'enregistre pas le résultat : l'horloge n'est donc fiable qu'une fois le portail passé. C'est exactement ce que font de nombreux réseaux invités.

Un écran reste associé mais hors ligne alors que l'appareil a clairement accès à internet ? C'est le premier endroit à vérifier.

Bande passante

La bande passante nécessaire dépend de la taille de votre contenu. Un écran télécharge un fichier une fois, puis le lit en local : après le téléchargement, le trafic est donc quasi nul. Au repos, un écran maintient seulement la connexion, avec un signal de présence toutes les 60 secondes. Si le WebSocket ne fonctionne pas, l'écran va quand même chercher son contenu toutes les heures. Les diffusions en direct et les applications qui rechargent sans cesse de nouvelles données continuent, elles, à consommer de la bande passante, selon la source.

Une courte coupure réseau n'interrompt pas la diffusion : le contenu déjà téléchargé continue de tourner.

Vérifier que le réseau est bien configuré

Sur l'appareil, ouvrez un navigateur et rendez-vous sur :

• https://player.screenbird.app : l'écran d'association avec un code d'association doit apparaître
• https://screenbird.app : la page de connexion du tableau de bord doit apparaître

Si l'une des deux ne s'affiche pas, consultez les journaux du pare-feu pour repérer lequel des domaines ci-dessus est bloqué.

Où sont stockées mes données ?

• La base de données tourne chez Supabase à Paris (région eu-west-3).
• Les sauvegardes externes sont conservées chez Backblaze à Amsterdam (région eu-central-003).
• Le tableau de bord, les applications et les fichiers sont livrés par le réseau de Cloudflare, présent sur des points de présence partout dans le monde.

La liste complète des sous-traitants et les durées de conservation figurent dans la déclaration de confidentialité sur screenbird.app.

Aide pour un déploiement en entreprise

Vous déployez de nombreux écrans derrière un réseau d'entreprise et il vous faut de la documentation pour votre service informatique ? Écrivez à support@screenbird.app.