휴대폰 연결 — 가이드 — Agent Switchboard

휴대폰에서 할 수 있는 일

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가 운영체제 보안 저장소를 쓸 수 없으면 휴대폰 연결을 켤 수 없습니다.

연결 방법 1: QR 코드

Google 계정 없이 쓸 수 있는 방법입니다.

PC의 환경 설정 › 휴대폰 › 새 휴대폰 연결에서 연결 QR 만들기를 누릅니다. 중계 서버에 연결된 뒤에만 QR을 만들 수 있습니다.
휴대폰 앱의 PC 연결에서 QR 코드 스캔을 누르고 PC 화면의 QR을 찍습니다. 카메라를 쓸 수 없으면 PC에서 주소 복사를 누르고 휴대폰의 연결 링크 붙여넣기를 씁니다.
휴대폰에 6자리 숫자가 나옵니다. PC에 뜨는 승인 창의 숫자와 같은지 확인한 뒤 승인합니다.

QR은 5분 동안만 유효하고 한 번만 쓸 수 있습니다. 시간이 지나거나 이미 쓴 QR이면 새로 만드세요.

연결 방법 2: Google 계정

PC와 휴대폰이 같은 Google 계정에 로그인하면 QR 없이 연결할 수 있습니다.

PC에서 왼쪽 아래 계정 메뉴나 레일 내 컴퓨터에서 Google로 로그인합니다. 환경 설정 › 휴대폰의 Google 계정 · PC 목록 동기화에서도 상태를 확인할 수 있습니다.
휴대폰 앱에서 같은 Google 계정으로 로그인합니다.
휴대폰에 그 계정의 PC 목록이 나옵니다. 꺼져 있는 PC도 보입니다. 연결할 PC를 누르면 QR 없이 연결됩니다.

승인 없이 받을지 정하기

환경 설정 › 휴대폰 › 대시보드·세션 접근 권한에서 정합니다.

같은 계정 휴대폰·웹 자동 허용: 켜면 같은 Google 계정으로 인증한 새 휴대폰이 숫자 확인 없이 연결됩니다. 끄면 처음 연결할 때 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에 연결한 휴대폰을 모두 끊습니다.

데스크톱 신원을 새로 만들면 연결한 휴대폰이 모두 끊기고 데스크톱 지문이 바뀝니다. Google 계정에서도 로그아웃됩니다.

여러 PC 사용량 합쳐 보기

환경 설정 › 휴대폰의 여러 PC 사용량 합쳐 보기를 켜면 날짜·도구·모델·프로젝트별 토큰 수를 계정의 기기끼리만 아는 키로 암호화해 계정 서버에 보관합니다. 대화 내용은 올리지 않습니다. 휴대폰 통계와 PC 개요의 모든 PC에서 합쳐 봅니다.

보관한 기록은 지울 때까지 남습니다. 서버에서 이 PC 기록 지우기 또는 계정 사용량 기록 모두 지우기로 지웁니다.

직접 운영하는 중계 서버

처음에는 공식 중계 서버와 공식 휴대폰 앱 주소를 씁니다. 환경 설정 › 휴대폰 › 주소에서 직접 운영하는 중계 서버(wss:// 주소)와 휴대폰 앱(https:// 주소)으로 바꿀 수 있습니다. 비우고 저장하면 공식 주소로 돌아갑니다. 휴대폰 앱 주소에는 믿을 수 있는 곳만 넣으세요. 그 주소의 앱이 이 PC의 터미널에 입력할 수 있게 됩니다.

연결이 되지 않으면 문제 해결을 참고하세요.