Requisitos de red y ajustes del firewall

Screenbird en sí solo usa HTTPS y WebSocket Secure por el puerto 443. En una red restrictiva, añade a la lista de permitidos los dominios de abajo: una lista para el panel y otra para las pantallas (el reproductor). Si usas un Amazon Signage Stick o una Fire TV, lee también el apartado Sincronización horaria en dispositivos Amazon: esos dispositivos necesitan conexiones adicionales propias.

¿Cuándo necesitas esto?

La mayoría de redes domésticas y de oficina funcionan sin tocar nada. Esta lista te hace falta si la red bloquea los dominios que no conoce, si pasa por un proxy o un filtro web, o si las pantallas están en una VLAN aparte con acceso limitado a internet.

Dominios para el panel

Para los ordenadores desde los que tu equipo gestiona el contenido:

• screenbird.app: el panel
• dev.screenbird.app: el entorno de staging, solo si tu equipo trabaja con él
• *.supabase.co: base de datos e inicio de sesión, también por WebSocket
• cdn.screenbird.app: archivos, imágenes, vídeos y fuentes propias
• integrations.screenbird.app: las vistas previas de las apps dentro del panel
• lh3.googleusercontent.com y avatars.githubusercontent.com: las fotos de perfil de las cuentas conectadas
• challenges.cloudflare.com: la comprobación de seguridad al iniciar sesión y al registrarte
• wss://api.screenbird.app: las actualizaciones en directo entre el panel y las pantallas
• js.stripe.com y *.js.stripe.com: la ventana de pago al registrarte y al cambiar de suscripción
• api.stripe.com y hooks.stripe.com: el cierre del pago, incluido 3D Secure
• m.stripe.com y m.stripe.network: el control antifraude de Stripe

Solo para funciones concretas:

• apis.google.com y docs.google.com: el selector de Google Drive, Documentos, Hojas de cálculo y Presentaciones
• images.pexels.com: la biblioteca de fotos de stock
• api.qrserver.com: los códigos QR de las plantillas de diseño
• geocoding-api.open-meteo.com: la búsqueda de una ubicación en la app del tiempo

Dominios para las pantallas

Para cada dispositivo en el que corre el reproductor:

• player.screenbird.app: el reproductor
• api.screenbird.app: registro, señal de actividad y descarga del contenido, también por WebSocket
• cdn.screenbird.app: el contenido que reproduce la pantalla
• media.screenbird.app: los archivos de instalación y las actualizaciones de las apps
• integrations.screenbird.app: aquí dentro corren todas las apps y los diseños
• mirror.screenbird.app: solo para Compartir pantalla, también por WebSocket
• fonts.googleapis.com y fonts.gstatic.com: las fuentes de las apps y los diseños

Solo para apps concretas:

• www.youtube.com y player.vimeo.com: las apps de vídeo

Si no usas una conexión o una app, tampoco tienes que permitir su dominio.

Puertos y protocolos

• HTTPS por el puerto 443 para todo el tráfico
• WebSocket Secure (WSS) por ese mismo puerto 443 para las actualizaciones en directo entre el panel y la pantalla

Screenbird en sí no usa ningún otro puerto. Un Amazon Signage Stick o una Fire TV sí necesita conexiones adicionales para ajustar su reloj (puerto UDP 123 y puerto TCP 80), consulta el apartado de abajo.

Sincronización horaria en dispositivos Amazon

Este apartado solo se aplica al Amazon Signage Stick y a la Fire TV. Si usas un Samsung, LG, Android TV, PC, Mac o Raspberry Pi, puedes saltártelo.

Estos dispositivos no tienen un reloj que siga funcionando cuando se corta la corriente. Obtienen la hora de internet al arrancar. Si eso falla, arrancan con una fecha que está semanas o meses en el pasado, y con la fecha equivocada se rechaza cualquier conexión segura. La pantalla se queda entonces sin conexión, incluso con el puerto 443 totalmente abierto y todos los dominios en tu lista de permitidos.

Así que permite estas conexiones:

• ftv-smp.ntp-fireos.com por UDP, puerto 123: la obtención de la hora. Este nombre se resuelve a time.aws.com; si tu firewall filtra por nombre DNS, permite ambos
• firetvcaptiveportal.com, fireoscaptiveportal.com y kindle-time.amazon.com por TCP, puerto 80, sin interceptar: la comprobación de la red y la alternativa para obtener la hora

El puerto 80 es necesario incluso con el UDP 123 abierto. El dispositivo solo ajusta su hora en una red que ha validado, y esa comprobación es en sí una petición por el puerto 80. Si el puerto 80 saliente está bloqueado, el reloj nunca se ajusta, pase lo que pase en UDP 123.

El dispositivo lo intenta de nuevo cada vez que se conecta a una red y, después, solo una vez cada 7 días. Una pantalla que falla el primer intento puede quedarse mucho tiempo con la fecha equivocada. Cuando el firewall esté corregido, reinicia el dispositivo o vuelve a conectarlo a la red para provocar un nuevo intento.

Cosas a vigilar:

• El dispositivo usa direcciones fijas y no acepta un servidor de hora que reparta la propia red, así que indicarle tu propio servidor de hora no sirve de nada.
• El tráfico del puerto 80 no debe interceptarse. Un proxy transparente que reenvía la petición a internet no es problema. Un proxy o filtro web que responde por sí mismo, por ejemplo con una página de bloqueo, ajusta el reloj a su propia hora, y eso solo es correcto si el reloj de ese proxy lo es. Una caché que repite respuestas antiguas puede fijar una hora obsoleta.
• Usa una red sin página de inicio de sesión (captive portal). En una red con página de inicio de sesión el dispositivo hace un único intento y no guarda el resultado, de modo que el reloj no es fiable hasta que se supera el portal. Eso es justo lo que hacen muchas redes de invitados.

¿Una pantalla está vinculada pero sin conexión mientras el dispositivo claramente tiene internet? Este es el primer sitio donde mirar.

Ancho de banda

El ancho de banda que necesitas depende del tamaño de tu contenido. Una pantalla descarga cada archivo una vez y luego lo reproduce en local, así que después de la descarga casi no genera tráfico. En reposo, la pantalla solo mantiene viva la conexión con una señal de actividad cada 60 segundos. Si el WebSocket no funciona, la pantalla descarga su contenido igualmente cada hora. Las emisiones en directo y las apps que consultan datos nuevos continuamente sí siguen consumiendo ancho de banda, según la fuente.

Los cortes breves de red no interrumpen la reproducción: el contenido ya descargado sigue funcionando.

Comprobar si la red está bien

Abre un navegador en el dispositivo y ve a:

• https://player.screenbird.app: aquí tiene que aparecer la pantalla de emparejamiento con un código
• https://screenbird.app: aquí tiene que aparecer la página de inicio de sesión del panel

Si alguna de las dos no carga, mira en los registros del firewall cuál de los dominios de arriba está bloqueado.

¿Dónde están mis datos?

• La base de datos está en Supabase, en París (región eu-west-3).
• Las copias de seguridad externas están en Backblaze, en Ámsterdam (región eu-central-003).
• El panel, las apps y los archivos se sirven por la red de Cloudflare, que funciona desde ubicaciones edge repartidas por todo el mundo.

La lista completa de proveedores y los plazos de conservación están en la política de privacidad de screenbird.app.

Ayuda con un despliegue de empresa

¿Vas a instalar muchas pantallas en la red de una empresa y necesitas documentación para tu departamento de IT? Escríbenos a support@screenbird.app.