가이드 문서
휴대폰에서 할 수 있는 일
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가 운영체제 보안 저장소를 쓸 수 없으면 휴대폰 연결을 켤 수 없습니다.
연결 방법 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가 주고받는 내용은 종단 간 암호화하므로, 중계 서버는 암호문을 전달만 합니다.
서버가 볼 수 없는 것
- 터미널 입력과 출력
- 스위처 대화 내용
- 페어링 비밀과 세션 키
- 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의 터미널에 입력할 수 있게 됩니다.
연결이 안 되면 문제 해결을 참고하세요.