TURN / SFU の鍵を作る

Cloudflare で鍵を発行し、engawa の設定画面に登録するまでの手順です。所要 10 分ほど。

この設定は必要ですか?

どちらも任意です。設定しなくても engawa は動きます。 ただ、次のような場合は効果があります。

TURN — 「つながらない人がいる」とき
通話は原則として端末どうしを直接つなぎます。社内ネットワークやVPNの制限が厳しいと、 この直接接続ができず一部の人だけ声が届かないことがあります。 TURN はその中継路です。※ 未設定でも、多くの環境ではつながります。
SFU — 「大人数で集まる」とき
直接接続は、人数が増えるほど一人ひとりの端末の負荷が上がります。 SFU を設定すると、会議室や人数の多い集まりが自動でこちらに切り替わり、 PC が重くなりにくくなります。 ※ 未設定でも通話はできますが、大人数には向きません。

どちらも Cloudflare のアカウントでご用意いただきます。 利用料は Cloudflare からお客様へ直接請求されます(最新の料金は Cloudflare の料金ページをご確認ください)。 音声・映像が当社のサーバーを通らないのは、どちらを設定しても変わりません。

0. Cloudflare アカウントを用意する

  1. dash.cloudflare.com でアカウントを作成します。 ドメインを Cloudflare に移す必要はありません。
  2. ログインし、左メニューから Realtime を開きます。

1. TURN の鍵を作る

  1. Realtime の中の TURN を開きます。
  2. 新しい TURN キーを作成します(Create / Create TURN key などのボタン)。
  3. 名前は分かるものであれば何でも構いません(例: engawa)。
  4. 作成すると Turn Token ID と API Token(Token Secret)が表示されます。

    Token Secret はこの画面でしか表示されません。 閉じる前にコピーしてください。失くした場合は作り直しになります。

2. SFU の鍵を作る

  1. 同じ Realtime の中の SFU を開きます。
  2. 新しいアプリケーションを作成します(Create / Create application などのボタン)。
  3. 名前は分かるものであれば何でも構いません(例: engawa)。
  4. 作成すると App ID と App Secret(App Token)が表示されます。

    こちらも App Secret は作成時にしか表示されません。

※ Cloudflare の画面構成は変わることがあります。項目名が見つからない場合は、 上記の「Token ID / Token Secret」「App ID / App Secret」に相当するものをお探しください。

3. engawa に登録する

  1. engawa の管理画面にログインし、設定 を開きます。
  2. 持ち込みの鍵 のセクションに、控えた値を貼り付けます。
Cloudflare での名前 engawa の入力欄
Turn Token IDCloudflare TURN → Token ID
TURN の API TokenCloudflare TURN → Token Secret
SFU の App IDCloudflare Realtime SFU → App ID
SFU の App SecretCloudflare Realtime SFU → App Token

保存すると予約されます。設定はすぐには反映されません。 反映にはオフィスの再起動が必要で、再起動は会話を切ってしまうため、 オフィスが無人になったタイミングで自動的に適用します。 急ぎの場合はお問い合わせください。

4. 効いているか確かめる

  • TURN: これまでつながらなかった方と通話できるようになります。
  • SFU: 会議室や人数の多い集まりで、PC の負荷が下がります。

うまくいかない場合は、反映待ち(無人になっていない)か、鍵の貼り間違いがほとんどです。 設定画面で「設定済み」と表示されていれば、登録そのものは完了しています。

鍵の取り扱いについて

  • お預かりした鍵は暗号化して保管し、画面に再表示しません。
  • 鍵がブラウザに渡ることはありません。通話のたびに発行される短期の利用券だけが渡ります。
  • 設定画面からいつでも削除できます。削除したい場合は、各セクションの「鍵を削除する」にチェックして保存してください。
  • 鍵を変更したいときは、新しい値を入力して保存すれば置き換わります(空欄のままなら、今の鍵がそのまま残ります)。