Авторизація через 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 має з нею співіснувати.
- Середовища: де буде жити функція — тестовий контур, попередній, основний домен — і чи потрібні окремі адреси під мобільні збірки.
- Гаманці: з якими застосунками користувачі приходять частіше та які потребують окремої перевірки поведінки при підключенні й відмові від підпису.
- Обмеження: вимоги до зберігання сесій, терміни життя токенів, правила доступу всередині команди, зовнішні регуляторні умови.
- Очікувані показники: яку частку користувачів потрібно перевести на новий вхід, цільовий час підключення та за якими метриками будете перевіряти результат після запуску.
- Матеріали: доступ до репозиторію, схема поточної авторизації, опис обміну з бекендом, тестові акаунти, приклади логів звернень.
Опишіть задачу у вільній формі та додайте те, що є. Ми розберемо сценарії, окремо проговоримо ризики з доступом до гаманців і повернемося з оцінкою інтеграції та планом робіт за етапами — з точками, де ви зможете перевірити проміжний результат.







