ガイド文書
スマートフォンでできること
PC とつないでおけば、席を外していてもスマートフォンから次の操作ができます。
- 接続した PC のプロジェクトとセッションの一覧を見る
- アプリ内ターミナルを見て、入力する
- Switcher の会話を読んでメッセージを送る、承認リクエストに応える
- 新しいセッションを開く、過去のセッションを再開する、セッション名を変える・アーカイブする
- プロジェクトごとのツール・接続・モデルの設定を変える
- 複数の PC の使用量統計を見る
ツールのアカウントを新しく作ったり、そのアカウントでログインを始めたりする操作は、PC でしか行えません。
スマートフォンアプリを選ぶ
| アプリ | 状態 | 入手先 |
|---|---|---|
| ウェブアプリ(PWA) | 提供中 | https://app.switchboard.twentyoz.kr |
| Android アプリ | 提供中(APK) | ダウンロードページの Android タブ |
| iPhone アプリ | 準備中 | リリースまではウェブアプリをご利用ください |
ウェブアプリ
スマートフォンのブラウザーで https://app.switchboard.twentyoz.kr を開けば、インストールせずにすぐ使えます。ブラウザーのメニューから ホーム画面に追加 を選ぶと、アプリのようにホーム画面に置けます。
Android アプリ
- ダウンロードページで Android タブを選び、
Agent-Switchboard-Android-<버전>.apkをダウンロードします(<버전>はバージョン番号)。 - ダウンロードしたファイルを開いてインストールします。ブラウザーやファイルアプリがインストールの許可を求めてきたら、許可してください。
以前に署名の異なる APK をインストールしていた場合は、新しい APK を上書きインストールできません。その場合は既存のアプリを削除してから新しい APK をインストールし、PC との接続と Google ログインをやり直してください。
PC でスマートフォン連携をオンにする
スマートフォン連携は、最初はオフになっています。
- PC で 환경 설정 › 휴대폰(環境設定 › スマートフォン)を開きます。
- 휴대폰 연결 켜기(スマートフォン連携をオンにする)をオンにします。
オンにしても、PC は中継サーバーへの外向きの接続を張るだけで、ポートは開きません。PC が OS のセキュアストレージを使えない場合は、スマートフォン連携をオンにできません。
接続方法 1: QR コード
Google アカウントがなくても使える方法です。
- PC の 환경 설정 › 휴대폰 › 새 휴대폰 연결(環境設定 › スマートフォン › 新しいスマートフォンを接続)で、연결 QR 만들기(接続用 QR を作成)を押します。QR を作れるのは、中継サーバーに接続できてからです。
- スマートフォンアプリの PC 연결(PC 接続)で QR 코드 스캔(QR コードをスキャン)を押し、PC 画面の QR を読み取ります。カメラが使えないときは、PC で 주소 복사(アドレスをコピー)を押し、スマートフォンの 연결 링크 붙여넣기(接続リンクを貼り付け)を使います。
- スマートフォンに 6 桁の数字が表示されます。PC に表示される承認ウィンドウの数字と同じかを確かめてから、承認します。
QR は 5 分間有効で、使えるのは 1 回だけです。期限が切れた QR や使用済みの QR の場合は、新しく作り直してください。
接続方法 2: Google アカウント
PC とスマートフォンで同じ Google アカウントにログインすれば、QR なしで接続できます。
- PC で、左下のアカウントメニューかレールの 내 컴퓨터(マイコンピューター)から Google でログインします。状態は 環境設定 › スマートフォン の Google 계정 · PC 목록 동기화(Google アカウント・PC 一覧の同期)でも確認できます。
- スマートフォンアプリで、同じ Google アカウントにログインします。
- スマートフォンに、そのアカウントの PC 一覧が表示されます。電源が切れている PC も一覧に出ます。接続したい PC を押せば、QR なしで接続されます。
承認なしで受け入れるかを決める
환경 설정 › 휴대폰 › 대시보드·세션 접근 권한(環境設定 › スマートフォン › ダッシュボード・セッションへのアクセス権限)で設定します。
- 같은 계정 휴대폰·웹 자동 허용(同じアカウントのスマートフォン・ウェブを自動許可): オンにすると、同じ Google アカウントで認証した新しいスマートフォンが、数字の確認なしで接続されます。オフにすると、初めて接続するときに PC での承認が必要です。
- 같은 계정 다른 PC 자동 허용(同じアカウントの他の PC を自動許可): 同じアカウントのほかの PC がレールの マイコンピューター からこの PC を開くときに、承認ウィンドウを省くかどうかを決めます。接続した PC はこの PC のターミナルに入力できるので、自分で管理している PC だけを使う場合にオンにしてください。
自動許可をオンにしていても、次の場合は PC の承認ウィンドウで数字を確認する必要があります。
- この PC で接続を切った、またはログアウトさせたデバイスが、再び接続しようとするとき
- 1 時間以内に、3 台を超える異なるデバイスを自動登録しようとするとき
同じアカウントで新しいデバイスが接続すると、PC の通知とアクティビティ履歴でお知らせします。
接続を許可するのは PC 自身です
アカウントサーバーは PC の一覧を保管しているだけで、接続を許可する役割は持っていません。スマートフォンが送った Google ログインの証明は、PC が自分で検証します。そのため、たとえアカウントサーバーの一覧が改ざんされても、PC のターミナルの権限が渡ることはありません。
通知を受け取る
Android アプリでは、承認待ち・作業完了・エラーの通知を受け取れます。スマートフォンアプリで通知を登録したあと、PC の 환경 설정 › 휴대폰 › 연결한 휴대폰(環境設定 › スマートフォン › 接続したスマートフォン)で、デバイスごとに 작업 완료 알림(作業完了の通知)をオン・オフします。承認リクエスト・新しいデバイスの接続・エラーの通知は、この設定に関係なく送ります。
通知の内容は、スマートフォンが作ったデバイスごとのキーで PC が暗号化して送ります。中継サーバーと Apple・Google のプッシュサービスから見えるのは、プッシュトークンと暗号文だけです。スマートフォンが通知を復号できなかった場合は、「확인할 일이 있습니다」(確認が必要なことがあります)という決まった文言が表示されます。アプリを開いて接続中のデバイスには、通知を送りません。
中継サーバーから見えるもの
スマートフォンと PC の間でやり取りする内容はエンドツーエンドで暗号化しているため、中継サーバーは暗号文を受け渡すだけです。
サーバーから見えないもの
- ターミナルの入力と出力
- Switcher の会話の内容
- ペアリングのシークレットとセッションキー
- API キーと OAuth トークン
- メールアドレスと Google トークン(ログインの確認時に受け取りますが、保存しません)
サーバーが扱うもの
- 接続元 IP アドレス(不正利用の防止と接続記録のため)
- PC のルーム識別子(PC の公開鍵から作った値)、暗号化されたデータのサイズと時刻
- Google アカウントを使う場合: アカウント識別子、PC の公開鍵・名前・最終接続時刻、スマートフォンのデバイス id・名前・プラットフォーム、セッションハッシュ
- 使用量の同期をオンにした場合: 暗号化された月別の使用量データ
暗号化の仕組み
- QR に含まれる使い捨てのシークレットはアドレスの fragment 部分にあるため、サーバーには送られません。
- 接続のたびに、双方がセッションキーを新しく作ります。中継サーバーが途中に割り込むとキーが一致せず、接続できません。
- 中継サーバーは、メッセージを保存したり蓄積したりしません。
取り扱いの詳細はプライバシーポリシーをご覧ください。
接続したデバイスの管理
環境設定 › スマートフォン › 接続したスマートフォン では、デバイスごとに次の操作ができます。
- 이름 바꾸기(名前を変更): この PC の一覧上の名前だけが変わります。
- 연결 끊기(接続を切断): この PC との接続だけが切れます。再び接続するには、QR で接続し直すか、この PC の承認ウィンドウを通す必要があります。
- 로그아웃(ログアウト。Google アカウントで接続したデバイスのみ): そのスマートフォンがアカウントからログアウトし、同じアカウントのすべての PC との接続が切れます。
- 모두 끊기(すべて切断): この PC に接続しているスマートフォンを、すべて切断します。
데스크톱 신원을 새로 만들면(デスクトップの ID を新しく作ると)、接続したスマートフォンはすべて切断され、デスクトップのフィンガープリントも変わります。Google アカウントからもログアウトします。
複数の PC の使用量をまとめて見る
環境設定 › スマートフォン の 여러 PC 사용량 합쳐 보기(複数の PC の使用量をまとめて見る)をオンにすると、日付・ツール・モデル・プロジェクト別のトークン数を、同じアカウントのデバイス同士しか知らないキーで暗号化し、アカウントサーバーに保管します。会話の内容はアップロードしません。集計結果は、スマートフォンの統計と、PC の概要の 모든 PC(すべての PC)で確認できます。
保管した記録は、自分で削除するまで残ります。削除するには、서버에서 이 PC 기록 지우기(サーバーからこの PC の記録を削除)または 계정 사용량 기록 모두 지우기(アカウントの使用量記録をすべて削除)を押してください。
自社で運用する中継サーバー
最初は、公式の中継サーバーと公式のスマートフォンアプリのアドレスを使います。환경 설정 › 휴대폰 › 주소(環境設定 › スマートフォン › アドレス)で、自社で運用する中継サーバー(wss:// のアドレス)とスマートフォンアプリ(https:// のアドレス)に変えられます。欄を空にして保存すると、公式のアドレスに戻ります。スマートフォンアプリのアドレスには、信頼できるものだけを入力してください。そのアドレスのアプリが、この PC のターミナルに入力できるようになるためです。
うまく接続できない場合は、トラブルシューティングをご覧ください。