РусскийRUEnglishEN

Привязка десктоп-клиента к аккаунту

Короткое описание

Чтобы macOS-клиент Whisperer работал с вашими сессиями, подпиской и базой знаний, его нужно один раз привязать к аккаунту. Установка приложения сама по себе доступа не даёт — нужна авторизация устройства (device auth).

Привязка построена на безопасном потоке с одноразовым кодом: приложение инициирует вход, вы авторизуетесь в браузере, получаете одноразовый код, и браузер возвращает вас обратно в приложение. Код одноразовый и живёт 30 минут.

Когда использовать

  • Сразу после установки клиента и прохождения мастера разрешений.
  • При входе в аккаунт на новом или переустановленном компьютере.
  • Когда приложение перестало видеть аккаунт (вышли из всех устройств, сменили пароль и т. п.) и его нужно привязать заново.

Пошаговая инструкция

  1. Инициируйте вход в приложении. Откройте Whisperer на Mac и запустите вход/привязку. Приложение запросит у сервера одноразовый код (POST /v1/auth/desktop/code) и откроет в браузере веб-страницу привязки — /app/connect.
  2. Войдите в аккаунт в браузере. На странице /app/connect войдите под своими e-mail и паролем. Если аккаунта ещё нет — зарегистрируйтесь и подтвердите e-mail (см. Регистрация и вход). До подтверждения e-mail вход невозможен.
  3. Подтвердите привязку устройства. После входа веб-кабинет свяжет одноразовый код с вашим аккаунтом.
  4. Вернитесь в приложение. Браузер автоматически перенаправит вас обратно в Whisperer по схеме whisperer://auth?code=...&state=.... Если откроется системный запрос «Открыть в приложении Whisperer?» — подтвердите.
  5. Дождитесь обмена кода на токены. Приложение обменяет одноразовый код на токены доступа и сохранит их в защищённом хранилище (зашифрованно). После этого клиент привязан к аккаунту.
  6. Проверьте. Убедитесь, что в приложении отображается ваш аккаунт и тариф. Теперь можно начинать сессии.

Скриншоты

📸 [Скриншот: экран инициирования входа в macOS-клиенте]

📸 [Скриншот: веб-страница /app/connect с формой входа]

📸 [Скриншот: системный запрос macOS «Открыть в приложении Whisperer?» (схема whisperer://)]

Частые ошибки

  • Код истёк. Одноразовый код живёт 30 минут. Если вы провозились дольше или прервались, привязка не завершится. Решение: вернитесь в приложение и инициируйте вход заново — будет выдан новый код.
  • Браузер не вернул в приложение. Если редирект по схеме whisperer:// не сработал автоматически, убедитесь, что Whisperer установлен в папку «Программы», и повторите вход. При системном запросе на открытие приложения — подтвердите его.
  • Вход не проходит — e-mail не подтверждён. До подтверждения e-mail 6-значным кодом войти нельзя. Подтвердите почту и повторите.
  • Несколько вкладок /app/connect. Открытие нескольких страниц привязки одновременно сбивает поток. Закройте лишние и пройдите привязку заново из приложения.
  • Аккаунт заморожен или заблокирован. Если статус аккаунта frozen/banned, привязка не завершится — обратитесь в поддержку.

Лучшие практики

  • Проходите привязку сразу после установки, не откладывая, — так вы точно уложитесь в 30-минутный TTL кода.
  • Держите страницу /app/connect открытой только в одной вкладке.
  • Если меняли пароль или выходили со всех устройств, заново привяжите клиент — старые токены инвалидируются (token_version).
  • Не передавайте одноразовый код вручную и не делитесь ссылкой whisperer://auth?... — это секрет для вашего устройства.

Связанные статьи