Авторизация через TON Connect: где рвётся вход в приложение
Вход через кошелёк выглядит как простой обмен: приложение формирует запрос, кошелёк возвращает адрес и подпись, сервер выдаёт сессию. Ломается это обычно не на криптографии, а на стыках — когда ответ TON Connect приходит не тем каналом, которого ждёт интерфейс.
Браузерное расширение отвечает внутри страницы, мобильный кошелёк — возвратом по ссылке, встроенный в кошелёк браузер — вообще без перехода. Необработанный ответ кошелька на любом из этих путей даёт один симптом: подпись уже поставлена, а пользователь видит ошибку авторизации и жмёт «подключить кошелёк» заново.
Потеря сессии — вторая тихая точка. Пока вкладка открыта, состояние подключения живёт в памяти, но после перезагрузки или возврата из фона на телефоне оно исчезает, тогда как на сервере ключ сессии ещё действителен. Повторное подключение кошелька к приложению в этот момент либо упирается в занятую сессию, либо плодит дубли привязок.
Отдельная зона — подпись запроса: срок жизни полезной нагрузки, привязка к домену, сверка адреса на сервере. Частичная проверка даёт ложные отказы при медленном подтверждении и приём подписи, выданной для другого приложения. Ниже разбираем, как эти точки закрываются схемой, а не заплатками в интерфейсе.
Что меняется после внедрения: скорость входа и доля успешных сессий
Аккуратно собранный вход через TON Connect убирает промежуточные шаги: не нужно придумывать пароль, ждать письмо и вводить код. Остаются два действия — подключить кошелёк и подписать сообщение. Время авторизации перестаёт зависеть от почтовых задержек и измеряется секундами, а не минутами.
Главная метрика здесь — доля успешных входов. Каждый лишний экран терял часть аудитории, и основной отвал приходился на подтверждение: пользователь закрывал кошелёк, возвращался не в ту вкладку или подпись не совпадала с ожидаемым адресом. Мы обрабатываем возврат в приложение и истёкший запрос явно — с понятным сообщением и повторной попыткой, а не с пустым экраном.
Меняется и сам класс отказов. Вместо набора «письмо не дошло», «код истёк», «пароль забыт» остаётся один предсказуемый сценарий — пользователь отклонил подпись. Это осознанное действие, а не сбой инфраструктуры, поэтому поддержка перестаёт разбирать однотипные обращения.
Стабильность сессий держится на серверной проверке подписи и сроках жизни маркера доступа: сессия продлевается без повторного подтверждения в кошельке, отзывается при отвязке адреса и корректно переживает смену аккаунта в кошельке. Вход становится предсказуемым: доля успешных попыток растёт, число обращений по доступам падает.
Способы подключения кошелька: сравнение режимов и ограничений
Режим подключения определяет не только то, как пользователь попадает в приложение, но и что придётся делать при каждой значимой операции: подписывать заново или переиспользовать постоянную сессию. От этого зависят доля дошедших до входа, объём логики на стороне интерфейса и число точек отказа между кошельком и серверной частью.
На практике выбор сводится к пяти сценариям — от расширения в браузере до гибридной схемы, где мобильный кошелёк страхует настольную версию. Ниже — сравнение по совместимости и ограничениям способа входа.
| Вариант | Когда подходит | Ограничения |
|---|---|---|
| Расширение в браузере | Настольный сценарий, аудитория с установленным кошельком | Не работает на смартфонах, требует установки и обновления расширения |
| Мобильный кошелёк по коду или ссылке | Основной трафик со смартфонов | Возврат в приложение зависит от платформы, часть пользователей теряется на переходе |
| Сторонний сервис-посредник | Нужен вход тем, у кого кошелька ещё нет | Появляется доверенная сторона, сужается контроль над ключами |
| Разовая проверка подписи | Подтверждение владения адресом, вход в личный кабинет | Постоянной сессии нет — при каждом действии подпись запрашивается снова |
| Гибридная схема | Массовый продукт с разными типами устройств | Логика отзыва сессии и обработка ошибок заметно сложнее |
Отдельно проектируем то, что обычно всплывает уже в проде: поведение при отзыве доступа, смене устройства и повторном подключении. Постоянная сессия должна завершаться предсказуемо, а разовая проверка подписи — не требовать лишних подтверждений там, где они не нужны.
Этапы внедрения: от схемы потоков до передачи регламентов
Начинаем с разбора сценариев: как пользователь входит с компьютера и с телефона, какие роли участвуют, какие данные должны оказаться в сессии. По итогам фиксируем схему авторизации — от запроса подключения кошелька до выдачи серверной сессии — и только после этого переходим к коду. Схему строим на TON Connect, потому что это стандарт подключения кошельков, а не самодельный обмен ключами.
- Разбор сценариев входа. Собираем реальные пути: браузер с расширением-кошельком, мобильное приложение, переход по QR-коду. Отдельно проговариваем поведение, когда пользователь закрыл окно подтверждения или подключился другим адресом.
- Схема авторизации. Описываем последовательность шагов: запрос на подключение, формирование полезной нагрузки, подпись на стороне кошелька, проверка на сервере, выпуск сессии и привязка адреса к учётной записи.
- Настройка интеграции. Заполняем манифест, задаём список поддерживаемых кошельков, сроки жизни подписи и сессии, правила обработки отказа и повторного подключения.
- Тестовый контур. Разворачиваем изолированную среду с тестовой сетью, чтобы прогонять входы, не задевая реальные кошельки и рабочие данные.
- Порядок проверок. Проходим набор случаев: успешный вход, отказ в подписи, повторное использование одной и той же подписи, истёкшая сессия, смена адреса. Каждый случай закрываем проверкой на сервере, а не только на стороне интерфейса.
- Передача решения. Отдаём регламенты, схемы потоков, описание доступов и журналирования, обучаем команду и сопровождаем первый период эксплуатации.
Что остаётся у команды: конфигурации, схемы и регламенты доступа
С рабочей кнопкой входа интеграция не заканчивается: важно, чтобы после приёмки у команды остались артефакты, по которым любой инженер поднимет окружение, разберёт обращение и добавит новый способ входа, не читая всю кодовую базу. Мы собираем их по ходу работ, а не «напишем потом», и передаём вместе с исходниками.
- Настроенные окружения — тестовый и рабочий контуры с описанием адресов узлов, переменных подключения, места хранения ключей и правил заполнения файла манифеста, по которому кошелёк узнаёт приложение.
- Схемы потоков авторизации — путь от нажатия кнопки в интерфейсе до выдачи сессии: формирование сообщения, проверка подписи на стороне сервиса, привязка адреса кошелька к учётной записи и обработка повторного входа.
- Матрица ролей — кто из сотрудников читает логи подключений, кто меняет список поддерживаемых кошельков и домены, кто отзывает активные сессии.
- Политики доступа — срок жизни подписанного сообщения и сессии, порядок ротации ключей, действия при компрометации кошелька или смене владельца.
- Документация по авторизации — требования к подписи, таблица кодов ошибок и того, что видит пользователь на каждом шаге, ограничения по домену.
- Набор проверок — тесты подписи и повторного использования сообщения, сценарии отказа от подписи и обрыва связи, проверка отзыва сессии.
- Регламент поддержки — какие данные собрать по обращению «не проходит вход», как отличить проблему кошелька от проблемы сервиса и за какое время даём ответ.
Каждый пункт заводим в тот же репозиторий, что и код, с отметкой ответственного, чтобы через полгода правки в логике входа не расходились с документацией.
Кейс: как вход через кошелёк перестал терять пользователей
До: вход терялся на середине пути
Проект — маркетплейс цифровых товаров с авторизацией через кошелёк. Изначально вход был собран на прямых вызовах провайдера: подпись проверялась на клиенте, состояние подключения жило в памяти вкладки, а при отказе от подтверждения пользователь возвращался на пустой экран и начинал заново.
Мы разобрали воронку по логам. Из тех, кто нажимал «Подключить кошелёк», до подтверждённой сессии доходило 63%. Каждый третий визит сопровождался повторной попыткой входа: люди закрывали окно кошелька при несовпадении сети, а приложение не сообщало, что именно пошло не так. Восстановление сессии после перезагрузки страницы требовало ручного повтора всей цепочки — в среднем четыре действия подряд.
После: одна цепочка с явными состояниями
TON Connect мы перестроили как единственную точку входа: проверка подписи ушла на сервер, состояние подключения хранится с привязкой к ключу сессии, а у каждого сбоя появился свой экран — «кошелёк не установлен», «сеть не совпадает», «подпись отклонена». Возврат из любого отказа ведёт к тому же шагу, а не к началу сценария.
Доля завершённых входов выросла с 63% до 91%, повторные попытки сократились почти втрое. Сессия восстанавливается автоматически после перезагрузки — одно действие пользователя вместо четырёх, без повторного подтверждения в кошельке. Обращения в поддержку по теме входа снизились до единичных за неделю, а сам кейс интеграции стал шаблоном для остальных сервисов заказчика.
Чем TON Connect отличается от собственной подписи сообщения?
Оба подхода решают одну задачу — доказать приложению, что пользователь владеет ключом. TON Connect — это готовое подключение кошелька: стандарт уже описывает обмен, подпись и жизненный цикл сессии. Своя проверка подписи означает, что весь этот обмен мы собираем сами, от формирования запроса до разбора ответа.
Разница проявляется не на старте, а на дистанции.
| Критерий | TON Connect | Своя проверка подписи |
|---|---|---|
| Совместимость кошельков | Единый стандарт — новый кошелёк подключается без доработок | Каждый кошелёк требует отдельной ветки разбора ответа |
| Поддержка решения | Изменения стандарта закрывает сообщество | Новые форматы ловим, тестируем и выкатываем сами |
| Контроль | Работаем в рамках стандарта | Полный контроль над сценарием и данными сессии |
| Риски | Отказ частично переносится на стандарт | Повтор запроса, бессрочная сессия, подмена адреса — на нашей стороне |
Самая дорогая часть самописной авторизации — не проверка подписи, а её окружение: одноразовый идентификатор запроса, привязка к домену, ограниченный срок жизни сессии и отзыв доступа. Пропущенный пункт превращается в класс уязвимостей, который воспроизводится без взлома ключей — достаточно переиграть сохранённый ответ.
Поэтому по умолчанию идём через TON Connect, а собственную проверку подписи берём только там, где нужен сценарий вне стандарта. В этом случае изоляция логики проверки и отдельный контур тестов на повтор и подмену — обязательная часть работы, а не опция.
Вопросы, которые задают перед началом интеграции кошелька
Перед началом интеграции TON Connect у команды накапливаются технические сомнения, и почти все — про поведение пользователя на границе сценария. Ниже ответы на те, что всплывают на каждом обсуждении: кошельки, подпись, сессия и второй способ входа.
Что делать с кошельками, которые не поддерживаются?
Перечень поддерживаемых кошельков фиксируем на старте и проверяем подключением. На входе показываем только прошедшие проверку, остальным отдаём понятный текст вместо зависшей кнопки — отказ выглядит предсказуемо, а не как «нажал и ничего».
Как закрывается повторное использование подписи?
Подпись привязана к одноразовому значению и короткому сроку жизни, сервер проверяет оба условия до выдачи сессии. Повторно отправленный запрос отклоняется — перехваченное сообщение не станет вторым входом.
Сколько живёт сессия и что происходит при обрыве связи?
Сессия продлевается по активности и закрывается по бездействию. При разрыве пользователь возвращается в тот же контекст, а не начинает вход заново — это важно для длинных форм и подтверждения переводов.
Можно ли добавить второй способ входа?
Да: вход через кошелёк — не единственный путь, рядом ставим привычный способ (почта или телефон), и оба ведут к одному профилю. Приоритет способов фиксируем на этапе проектирования, чтобы потом не переписывать экран.
Обсудим задачу: разберём сценарии и вернёмся с планом
Чтобы вернуться с оценкой интеграции, а не с общими формулировками, нам нужны входные данные по вашему продукту. Даже черновые ответы сокращают срок подготовки плана работ и снимают неопределённость на старте проекта. Чего-то может не быть — часть уточним вместе.
- Сценарии входа: какие роли есть в продукте и что каждая должна делать — только авторизоваться, подтвердить владение кошельком, подписать операцию или привязать адрес к уже существующему аккаунту.
- Текущая схема входа: что работает сейчас — почта, внешний провайдер, собственная сессия — и как вход через TON Connect должен с ней сосуществовать.
- Среды: где будет жить функция — тестовый контур, предварительный, основной домен — и нужны ли отдельные адреса под мобильные сборки.
- Кошельки: с какими приложениями пользователи приходят чаще и какие требуют отдельной проверки поведения при подключении и отказе от подписи.
- Ограничения: требования к хранению сессий, сроки жизни токенов, правила доступа внутри команды, внешние регуляторные условия.
- Ожидаемые показатели: какую долю пользователей нужно перевести на новый вход, целевое время подключения и по каким метрикам будете проверять результат после запуска.
- Материалы: доступ к репозиторию, схема текущей авторизации, описание обмена с бэкендом, тестовые аккаунты, примеры логов обращений.
Опишите задачу в свободной форме и приложите то, что есть. Мы разберём сценарии, отдельно проговорим риски с доступом к кошелькам и вернёмся с оценкой интеграции и планом работ по этапам — с точками, где вы сможете проверить промежуточный результат.







