Requisitos de rede e configurações de firewall

O Screenbird em si usa só HTTPS e WebSocket Secure na porta 443. Em uma rede restritiva, coloque os domínios abaixo na lista de permissões: uma lista para o dashboard e outra para as telas (o player). Se você usa um Amazon Signage Stick ou uma Fire TV, leia também a seção Sincronização de hora nos dispositivos Amazon: esses dispositivos precisam de conexões extras próprias.

Quando você precisa disso?

A maioria das redes domésticas e de escritório funciona de primeira. Essa lista é necessária se a rede bloquear domínios desconhecidos, se você usar um proxy ou um filtro web, ou se as telas estiverem em uma VLAN separada com acesso limitado à internet.

Domínios para o dashboard

Para os computadores em que a sua equipe gerencia os conteúdos:

screenbird.app: o próprio dashboard
dev.screenbird.app: staging, só é necessário se a sua equipe trabalhar com ele
*.supabase.co: banco de dados e login, também por WebSocket
cdn.screenbird.app: arquivos, imagens, vídeos e fontes próprias
integrations.screenbird.app: as pré-visualizações dos apps no dashboard
lh3.googleusercontent.com e avatars.githubusercontent.com: fotos de perfil das contas conectadas
challenges.cloudflare.com: a verificação de segurança no login e na criação da conta
wss://api.screenbird.app: atualizações ao vivo entre o dashboard e as telas
js.stripe.com e *.js.stripe.com: a janela de pagamento no registro e na alteração da assinatura
api.stripe.com e hooks.stripe.com: a conclusão do pagamento, incluindo 3D Secure
m.stripe.com e m.stripe.network: o controle antifraude da Stripe

Só são necessários para determinadas funcionalidades:

apis.google.com e docs.google.com: o seletor do Google Drive, Documentos, Planilhas e Apresentações
images.pexels.com: a biblioteca de fotos de stock
api.qrserver.com: os códigos QR nos modelos de design
geocoding-api.open-meteo.com: a busca de uma localidade no app de meteorologia

Domínios para as telas

Para cada dispositivo em que o player roda:

player.screenbird.app: o próprio player
api.screenbird.app: registro, sinal de atividade e obtenção de conteúdo, também por WebSocket
cdn.screenbird.app: o conteúdo que a tela reproduz
media.screenbird.app: arquivos de instalação e atualizações dos apps
integrations.screenbird.app: todos os apps e designs rodam aqui dentro
mirror.screenbird.app: só é necessário para o compartilhamento de tela, também por WebSocket
fonts.googleapis.com e fonts.gstatic.com: as fontes nos apps e nos designs

Só são necessários para determinados apps:

www.youtube.com e player.vimeo.com: os apps de vídeo

Se você não usa uma conexão ou um app, não precisa liberar o domínio correspondente.

Portas e protocolos

HTTPS na porta 443 para todo o tráfego
WebSocket Secure (WSS) na mesma porta 443 para as atualizações ao vivo entre o dashboard e a tela

O Screenbird em si não usa mais nenhuma porta. Um Amazon Signage Stick ou uma Fire TV precisa, sim, de conexões a mais para acertar o relógio (porta UDP 123 e porta TCP 80), veja a seção abaixo.

Sincronização de hora nos dispositivos Amazon

Esta seção vale só para o Amazon Signage Stick e a Fire TV. Se você usa um Samsung, LG, Android TV, PC, Mac ou Raspberry Pi, pode pular esta parte.

Esses dispositivos não têm um relógio que continua funcionando quando a energia é cortada. Eles buscam a hora na internet ao ligar. Se isso falhar, eles ligam com uma data que está semanas ou meses no passado, e com a data errada qualquer conexão segura é recusada. A tela então fica offline, mesmo com a porta 443 totalmente aberta e todos os domínios na sua lista de permissões.

Por isso, libere estas conexões:

ftv-smp.ntp-fireos.com por UDP, porta 123: a obtenção da hora. Esse nome é resolvido para time.aws.com; se o seu firewall filtra por nome DNS, libere os dois
firetvcaptiveportal.com, fireoscaptiveportal.com e kindle-time.amazon.com por TCP, porta 80, sem interceptação: a verificação da rede e a alternativa para obter a hora

A porta 80 é necessária mesmo com a UDP 123 aberta. O dispositivo só acerta a hora em uma rede que ele validou, e essa verificação é, ela própria, uma requisição na porta 80. Se a porta 80 de saída estiver bloqueada, o relógio nunca é acertado, aconteça o que acontecer na UDP 123.

O dispositivo tenta de novo a cada conexão com uma rede e, depois disso, só uma vez a cada 7 dias. Uma tela que perde a primeira tentativa pode, por isso, ficar muito tempo com a data errada. Com o firewall corrigido, reinicie o dispositivo ou reconecte-o à rede para disparar uma nova tentativa.

Pontos de atenção:

O dispositivo usa endereços fixos e não aceita um servidor de hora distribuído pela própria rede, então indicar o seu próprio servidor de hora não ajuda.
O tráfego da porta 80 não pode ser interceptado. Um proxy transparente que repassa a requisição para a internet não tem problema. Um proxy ou filtro web que responde por conta própria, por exemplo com uma página de bloqueio, acerta o relógio com a hora dele, e isso só está certo se o relógio desse proxy estiver certo. Um cache que repete respostas antigas pode acertar uma hora desatualizada.
Use uma rede sem página de login (captive portal). Em uma rede com página de login, o dispositivo faz uma única tentativa e não guarda o resultado, então o relógio só é confiável depois que o portal for superado. É exatamente isso que muitas redes de convidados fazem.

Uma tela fica emparelhada mas offline enquanto o dispositivo claramente tem internet? Esse é o primeiro lugar para olhar.

Largura de banda

A largura de banda de que você precisa depende do tamanho dos seus conteúdos. Uma tela baixa um arquivo uma vez e passa a reproduzir esse arquivo localmente, por isso, depois do download, quase não há tráfego. Em repouso, a tela só mantém a conexão ativa com um sinal de atividade a cada 60 segundos. Se o WebSocket não funcionar, a tela busca o conteúdo de hora em hora mesmo assim. As transmissões ao vivo e os apps que ficam buscando dados novos continuam consumindo largura de banda, de acordo com a fonte.

Falhas curtas de rede não interrompem a reprodução: o conteúdo já baixado continua rodando.

Testar se a rede está bem

No dispositivo, abra um navegador e vá em:

https://player.screenbird.app: aqui deve aparecer a tela de emparelhamento com um código
https://screenbird.app: aqui deve aparecer a página de login do dashboard

Se um dos dois falhar, veja nos registros do firewall qual dos domínios acima está bloqueado.

Onde estão os meus dados?

O banco de dados roda na Supabase, em Paris (região eu-west-3).
Os backups externos ficam na Backblaze, em Amsterdã (região eu-central-003).
O dashboard, os apps e os arquivos são entregues pela rede da Cloudflare, que roda em localizações edge no mundo inteiro.

A lista completa de subcontratados e os prazos de retenção estão na política de privacidade em screenbird.app.

Ajuda em uma instalação empresarial

Você vai instalar muitas telas atrás de uma rede empresarial e precisa de documentação para o seu departamento de TI? Escreva para support@screenbird.app.