데스크톱 클라이언트와 계정 페어링하기

개요

Whisperer macOS 클라이언트가 세션, 구독, 지식 베이스와 함께 작동하려면 한 번 계정과 페어링해야 합니다. 앱을 설치하는 것만으로는 접근 권한이 부여되지 않습니다 — 기기가 인가되어야 합니다(기기 인증).

페어링은 안전한 일회용 코드 흐름을 기반으로 합니다. 앱이 로그인을 시작하면, 브라우저에서 인증하고 일회용 코드를 받은 뒤 브라우저가 다시 앱으로 돌아갑니다. 코드는 일회용이며 30분 동안 유효합니다.

앱에서 로그인을 시작하세요. Mac에서 Whisperer를 열고 로그인/페어링을 시작합니다. 앱은 서버에 일회용 코드를 요청하고(POST /v1/auth/desktop/code) 브라우저에서 페어링 웹 페이지 — /app/connect — 를 엽니다.
브라우저에서 계정에 로그인하세요. /app/connect 페이지에서 이메일과 비밀번호로 로그인합니다. 아직 계정이 없다면 등록하고 이메일을 확인하세요(자세한 내용은 등록 및 로그인 참조). 이메일이 확인되기 전에는 로그인할 수 없습니다.
기기 페어링을 확인하세요. 로그인 후 웹 대시보드가 일회용 코드를 계정에 연결합니다.
앱으로 돌아가세요. 브라우저는 whisperer://auth?code=...&state=... 스킴을 통해 자동으로 Whisperer로 다시 리디렉션합니다. "Whisperer에서 열기?"라는 시스템 프롬프트가 나타나면 확인하세요.
코드-토큰 교환을 기다리세요. 앱은 일회용 코드를 액세스 토큰으로 교환하고 보안 저장소에 암호화하여 저장합니다. 이후 클라이언트가 계정과 페어링됩니다.
확인하세요. 앱에 계정과 요금제가 표시되는지 확인합니다. 이제 세션을 시작할 수 있습니다.

📸 [스크린샷: macOS 클라이언트의 로그인 시작 화면]

📸 [스크린샷: 로그인 양식이 있는 /app/connect 웹 페이지]

📸 [스크린샷: "Whisperer에서 열기?" macOS 시스템 프롬프트 (whisperer:// 스킴)]

코드 만료. 일회용 코드는 30분 동안 유효합니다. 시간이 더 걸렸거나 중간에 중단되면 페어링이 완료되지 않습니다. 해결: 앱으로 돌아가 다시 로그인을 시작하면 새 코드가 발급됩니다.
브라우저가 앱으로 돌아오지 않음. whisperer:// 스킴 리디렉션이 자동으로 작동하지 않은 경우, Whisperer가 "응용 프로그램" 폴더에 설치되어 있는지 확인하고 로그인을 다시 시도하세요. 앱을 열라는 시스템 프롬프트가 나타나면 확인하세요.
로그인 실패 — 이메일 미확인. 6자리 코드로 이메일을 확인하기 전에는 로그인할 수 없습니다. 이메일을 확인한 후 다시 시도하세요.
여러 개의 /app/connect 탭. 여러 페어링 페이지를 동시에 열면 흐름이 깨집니다. 여분의 탭을 닫고 앱에서 페어링을 다시 실행하세요.
계정 동결 또는 차단. 계정 상태가 frozen/banned이면 페어링이 완료되지 않습니다 — 고객 지원에 문의하세요.