スマートフォン連携 — ガイド

スマートフォンでできること

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 でポートを開くことはありません。PC が OS のセキュアストレージを使えない場合、スマートフォン連携はオンにできません。

接続方法 1: QR コード

Google アカウントなしで使える方法です。

PC の 환경 설정 › 휴대폰 › 새 휴대폰 연결（環境設定 › スマートフォン › 新しいスマートフォンを接続）で 연결 QR 만들기（接続用 QR を作成）を押します。QR は中継サーバーに接続された後でのみ作成できます。
スマートフォンアプリの PC 연결（PC 接続）で QR 코드 스캔（QR コードをスキャン）を押し、PC 画面の QR を読み取ります。カメラが使えない場合は、PC で 주소 복사（アドレスをコピー）を押し、スマートフォンの 연결 링크 붙여넣기（接続リンクを貼り付け）を使います。
スマートフォンに 6 桁の数字が表示されます。PC に表示される承認ウィンドウの数字と一致することを確認してから承認します。

QR の有効期間は 5 分間で、1 回しか使えません。期限が切れた場合や使用済みの 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 のターミナルに入力できるようになります。

接続できない場合は、トラブルシューティングを参照してください。