Agent Switchboard
ダウンロード

言語

選んだ言語は Cookie に保存します。

テーマ
ガイド文書

スマートフォン連携

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

PC とつないでおけば、席を外していてもスマートフォンから次の操作ができます。

  • 接続した PC のプロジェクトとセッションの一覧を見る
  • アプリ内ターミナルを見て、入力する
  • Switcher の会話を読んでメッセージを送る、承認リクエストに応える
  • 新しいセッションを開く、過去のセッションを再開する、セッション名を変える・アーカイブする
  • プロジェクトごとのツール・接続・モデルの設定を変える
  • 複数の PC の使用量統計を見る

ツールのアカウントを新しく作ったり、そのアカウントでログインを始めたりする操作は、PC でしか行えません。

スマートフォンアプリを選ぶ

アプリ 状態 入手先
ウェブアプリ(PWA) 提供中 https://app.switchboard.twentyoz.kr
Android アプリ 提供中(APK) ダウンロードページの Android タブ
iPhone アプリ 準備中 リリースまではウェブアプリをご利用ください

ウェブアプリ

スマートフォンのブラウザーで https://app.switchboard.twentyoz.kr を開けば、インストールせずにすぐ使えます。ブラウザーのメニューから ホーム画面に追加 を選ぶと、アプリのようにホーム画面に置けます。

Android アプリ

  1. ダウンロードページで Android タブを選び、Agent-Switchboard-Android-<버전>.apk をダウンロードします(<버전> はバージョン番号)。
  2. ダウンロードしたファイルを開いてインストールします。ブラウザーやファイルアプリがインストールの許可を求めてきたら、許可してください。

以前に署名の異なる APK をインストールしていた場合は、新しい APK を上書きインストールできません。その場合は既存のアプリを削除してから新しい APK をインストールし、PC との接続と Google ログインをやり直してください。

PC でスマートフォン連携をオンにする

スマートフォン連携は、最初はオフになっています。

  1. PC で 환경 설정 › 휴대폰(環境設定 › スマートフォン)を開きます。
  2. 휴대폰 연결 켜기(スマートフォン連携をオンにする)をオンにします。

オンにしても、PC は中継サーバーへの外向きの接続を張るだけで、ポートは開きません。PC が OS のセキュアストレージを使えない場合は、スマートフォン連携をオンにできません。

接続方法 1: QR コード

Google アカウントがなくても使える方法です。

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

QR は 5 分間有効で、使えるのは 1 回だけです。期限が切れた QR や使用済みの QR の場合は、新しく作り直してください。

接続方法 2: Google アカウント

PC とスマートフォンで同じ Google アカウントにログインすれば、QR なしで接続できます。

  1. PC で、左下のアカウントメニューかレールの 내 컴퓨터(マイコンピューター)から Google でログインします。状態は 環境設定 › スマートフォン の Google 계정 · PC 목록 동기화(Google アカウント・PC 一覧の同期)でも確認できます。
  2. スマートフォンアプリで、同じ Google アカウントにログインします。
  3. スマートフォンに、そのアカウントの 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 のターミナルに入力できるようになるためです。

うまく接続できない場合は、トラブルシューティングをご覧ください。