ネットワーク要件とファイアウォールの設定

Screenbird 自体が使うのは、ポート 443 上の HTTPS と WebSocket Secure だけです。制限の厳しいネットワークでは、以下のドメインを許可リストに登録してください。ダッシュボード用とスクリーン（プレーヤー）用の2つに分かれています。Amazon Signage Stick や Fire TV を使う場合は、「Amazon デバイスの時刻同期」もあわせてお読みください。これらのデバイスには、別途追加の接続が必要です。

この設定が必要になるのはどんなときですか

家庭や一般的なオフィスのネットワークなら、たいていそのまま動きます。この一覧が必要になるのは、未知のドメインをブロックするネットワーク、プロキシや Web フィルターを使っているネットワーク、スクリーンがインターネット接続を制限された別の VLAN にぶら下がっている場合です。

ダッシュボード用のドメイン

チームがコンテンツを管理するパソコン向けの一覧です。

screenbird.app：ダッシュボード本体
dev.screenbird.app：ステージング環境。チームで使っている場合のみ必要です
*.supabase.co：データベースとログイン。WebSocket も通ります
cdn.screenbird.app：ファイル、画像、動画、カスタムフォント
integrations.screenbird.app：ダッシュボード内のアプリのプレビュー
lh3.googleusercontent.com と avatars.githubusercontent.com：接続したアカウントのプロフィール画像
challenges.cloudflare.com：ログインと登録時のセキュリティチェック
wss://api.screenbird.app：ダッシュボードとスクリーンのあいだのライブ更新
js.stripe.com と *.js.stripe.com：登録時とサブスクリプション変更時の決済ポップアップ
api.stripe.com と hooks.stripe.com：決済の完了処理（3D Secure を含む）
m.stripe.com と m.stripe.network：Stripe の不正利用チェック

次のドメインは、特定の機能を使う場合にだけ必要です。

apis.google.com と docs.google.com：Google ドライブ、ドキュメント、スプレッドシート、スライドの選択画面
images.pexels.com：ストック写真のライブラリ
api.qrserver.com：デザインテンプレートの QR コード
geocoding-api.open-meteo.com：天気アプリでの地点検索

スクリーン用のドメイン

プレーヤーが動くデバイスごとに必要な一覧です。

player.screenbird.app：プレーヤー本体
api.screenbird.app：登録、ハートビート、コンテンツの取得。WebSocket も通ります
cdn.screenbird.app：スクリーンが再生するコンテンツ
media.screenbird.app：アプリのインストールファイルとアップデート
integrations.screenbird.app：すべてのアプリとデザインがこの中で動きます
mirror.screenbird.app：画面共有を使う場合のみ必要です。WebSocket も通ります
fonts.googleapis.com と fonts.gstatic.com：アプリとデザインで使うフォント

次のドメインは、特定のアプリを使う場合にだけ必要です。

www.youtube.com と player.vimeo.com：動画系のアプリ

使っていない接続やアプリがあれば、対応するドメインを許可する必要はありません。

ポートとプロトコル

すべての通信は HTTPS のポート 443 を通ります
ダッシュボードとスクリーンのあいだのライブ更新は、同じポート 443 上の WebSocket Secure (WSS) を使います

Screenbird 自体はこれ以外のポートを使いません。ただし Amazon Signage Stick や Fire TV は、時刻を合わせるために追加の接続（UDP ポート 123 と TCP ポート 80）が必要です。詳しくは次の項目をご覧ください。

Amazon デバイスの時刻同期

この項目が当てはまるのは Amazon Signage Stick と Fire TV だけです。Samsung、LG、Android TV、パソコン、Mac、Raspberry Pi をお使いの場合は読み飛ばして構いません。

これらのデバイスには、電源を切っても動き続ける時計がありません。起動時にインターネットから時刻を取得します。これに失敗すると、数週間から数か月前の日付で起動してしまい、日付が間違っていると、あらゆる安全な接続が拒否されます。その結果、ポート 443 を完全に開放し、すべてのドメインを許可リストに登録していても、スクリーンはオフラインのままになります。

そのため、次の接続を許可してください。

ftv-smp.ntp-fireos.com（UDP、ポート 123）：時刻を取得します。この名前は time.aws.com に解決されます。ファイアウォールが DNS 名で許可リストを管理している場合は、両方を許可してください
firetvcaptiveportal.com、fireoscaptiveportal.com、kindle-time.amazon.com（TCP、ポート 80、傍受されないこと）：ネットワークの確認と、時刻取得のフォールバックです

UDP 123 が開いていても、ポート 80 は必須です。デバイスは検証済みのネットワークでのみ時刻を設定しますが、その確認自体がポート 80 へのリクエストだからです。送信ポート 80 がブロックされていると、UDP 123 の状況にかかわらず、時計は設定されません。

デバイスは、ネットワークに接続するたびに再試行し、その後は7日に1回だけ試行します。最初の試行に失敗したスクリーンは、長期間にわたって間違った日付のままになることがあります。ファイアウォールを修正したら、デバイスを再起動するか、ネットワークに再接続して、新たな試行を行わせてください。

注意点：

デバイスは固定のアドレスを使用し、ネットワーク側が配布する時刻サーバーを受け付けません。そのため、独自の時刻サーバーを指定しても効果はありません。
ポート 80 の通信は傍受されてはいけません。リクエストをそのままインターネットへ転送する透過型プロキシであれば問題ありません。ブロックページなどで自ら応答するプロキシや Web フィルターは、時計をそのプロキシ自身の時刻に設定してしまい、それが正しいのは、そのプロキシの時計が正しい場合だけです。古い応答を再送するキャッシュは、古い時刻を設定してしまうことがあります。
ログインページ（キャプティブポータル）のないネットワークを使用してください。ログインページのあるネットワークでは、デバイスは1回しか試行せず、結果も保存しないため、ポータルを通過するまで時計は当てになりません。多くのゲストネットワークが、まさにこの動作をしています。

スクリーンがペアリング済みなのにオフラインのままで、デバイスには明らかにインターネット接続がある場合は、まずここを確認してください。

帯域幅

必要な帯域幅は、コンテンツの大きさによって決まります。スクリーンはファイルを一度ダウンロードしたあとはローカルで再生するため、ダウンロード後の通信はごくわずかです。待機中は、60 秒ごとのハートビートで接続を保つだけです。WebSocket が使えない場合でも、スクリーンは一時間ごとにコンテンツを取得しにいきます。ライブ配信や、繰り返しデータを取得するアプリは、そのソースに応じて帯域幅を使い続けます。

短時間のネットワーク障害で再生が止まることはありません。ダウンロード済みのコンテンツはそのまま再生され続けます。

ネットワークが正しいか確かめる

デバイスでブラウザを開き、次のアドレスにアクセスしてください。

https://player.screenbird.app：ペアリングコードの表示されたペアリング画面が出れば正常です
https://screenbird.app：ダッシュボードのログインページが出れば正常です

どちらかが表示されない場合は、ファイアウォールのログで、上記のどのドメインがブロックされているかを確認してください。

データはどこに保存されますか

データベースは Supabase のパリ（リージョン eu-west-3）で稼働しています。
オフサイトのバックアップは Backblaze のアムステルダム（リージョン eu-central-003）にあります。
ダッシュボード、アプリ、ファイルは Cloudflare のネットワークから配信され、世界各地のエッジロケーションで動きます。

処理者の全一覧と保存期間は、screenbird.app のプライバシーポリシーに記載しています。

大規模な導入のサポート

社内ネットワークの内側に多数のスクリーンを展開する予定で、情報システム部門向けの資料が必要な場合は、support@screenbird.app までメールでご連絡ください。