Авторизація через Phantom на Solana: де ламається вхід
Авторизація через Phantom на Solana виглядає як три кроки: гаманець підписує рядок, сервер перевіряє підпис, користувач потрапляє до особистого кабінету.
На практиці вхід через криптогаманець ламається щонайменше в чотирьох місцях, і кожне дає свій клас відмов — від мовчазного «не пускає» до чужого профілю на екрані.
Перше — довіра до даних, що надійшли з боку користувача. Якщо підпис підтвердження перевіряє клієнт, а сервер отримує вже готовий вердикт, такий запит збирається вручну в консолі браузера.
Перевірка має жити на сервері, спиратися на публічний ключ і на одноразовий запит, який цей самий сервер видав і запам’ятав.
Друге — строк життя підписаного запиту. Довгий перетворює підпис на багаторазову перепустку, короткий дає гонку: користувач підтверджує вхід, а запит уже прострочено. Звідси втрата сесії рівно в момент входу й повторні натискання «підключити гаманець» без результату.
Третє — невідповідність мережі та розсинхронізація стану гаманця. Адреса, підписана в тестовому контурі, не повинна прийматися в робочому; зміна акаунта без переприв’язки відкриває чужий профіль.
Розбираємо, як закрити кожну точку — щоб збої входу до особистого кабінету перестали бути нормою, а сесія переживала оновлення сторінки та зміну пристрою.
Що змінюється після впровадження: швидкість входу та відмова від паролів
Парольний вхід — це ланцюжок: введення адреси пошти, очікування листа з кодом, введення пароля, другий фактор, повтор при одруківці. Після підключення авторизації через Phantom залишається одна дія — підтвердження в гаманці.
П’ять кроків згортаються в один, і людина потрапляє до особистого кабінету за секунди, а не за хвилини очікування листа.
Стійкість входу зростає не через «зручність», а тому, що зникають цілі класи відмов. Немає пароля — немає чого забути й немає чого скидати; немає листа з кодом — немає залежності від доставки пошти та спам-фільтрів.
Частка невдалих спроб входу падає в рази: залишаються тільки відмова користувача в гаманці та втрата доступу до самого гаманця.
Для сервісу це знімає навантаження з підтримки: звернення «не надходить лист», «скинув пароль, але не пускає», «ввів пошту з одруком» зникають із потоку — залишаються рідкісні випадки відновлення доступу до гаманця.
Водночас зменшується поверхня ризику: сервіс не зберігає й не перевіряє паролі, йому достатньо переконатися, що підпис відповідає заявленій адресі.
Ми залишаємо поштовий вхід резервним шляхом і вмикаємо новий поступово, щоб частка успішних входів не просідала на жодному етапі. Нижче — що саме робимо і в якому порядку.
Способи підключення гаманця: порівняння варіантів
Підключення гаманця й авторизація — не одне й те саме. Публічна адреса, яку віддає гаманець, нічого не доводить: її можна вписати вручну й побачити чужий баланс. Володіння ключем підтверджує тільки підпис, і від вибраного режиму залежить, що саме зможе перевірити сервер.
Другий фактор вибору — середовище, де відкрито продукт. У настільному браузері з’єднання з Phantom встановлюється через розширення й живе до відкликання дозволу, а в мобільному браузері розширення немає — вхід будується на поверненні з застосунку гаманця. Нижче варіанти, між якими реально обирають.
| Спосіб входу | Коли підходить | Обмеження методу |
|---|---|---|
| Розширення в браузері | Настільний веб, користувач ставить розширення | Недоступне на мобільних; сесія розривається при відкликанні дозволу |
| Повернення з застосунку гаманця за посиланням | Мобільний веб без розширення | Потрібен обробник повернення й відновлення контексту сторінки |
| Набір адаптерів під кілька гаманців | Не можна вимагати один конкретний гаманець | Дорожче в підтримці: в адаптерів різний набір методів підпису |
| Підпис повідомлення з одноразовим кодом | Повноцінна авторизація з прив’язкою до акаунта | Потрібно зберігати й гасити коди, інакше підпис відтворюваний |
| Тільки публічна адреса без підпису | Вітрини, перегляд балансу, аналітика | Не підтверджує володіння ключем — як авторизація не годиться |
Розділення режимів важливе й для відкатів: відкликання дозволу в розширенні розриває сесію, а вже виданий серверний код не можна використати повторно, якщо він гаситься після перевірки.
Тому строк життя коду й правило повторної видачі ми фіксуємо в конфігурації, а не залишаємо на розсуд клієнта.
Етапи впровадження: від розбору задачі до передачі
Порядок робіт майже не залежить від того, що дає вхід через Phantom — платіжний кабінет, доступ до токенів чи закритий розділ. Змінюються вхідні дані та спосіб зв’язку гаманця з акаунтом. Нижче — послідовність етапів і артефакт на виході кожного.
- Розбір сценаріїв входу. Які ролі входять, з яких пристроїв — розширення в браузері, мобільний гаманець, вхід за кодом, — і що бачить користувач без гаманця. На виході узгоджений перелік сценаріїв із пріоритетами.
- Схема авторизації. Як формується одноразове повідомлення, де зберігається, скільки живе, що вважається успішним входом. Отримуєте схему з точками відмов і рішенням, як гаманець пов’язується з акаунтом.
- Налаштування перевірки підпису. Серверна перевірка підпису й публічного ключа, захист від повторного використання повідомлення, прив’язка й відв’язка гаманця. Тут найчастіше спливають помилки, які потім дорого лагодити.
- Вбудовування в систему. Сесії, ролі й права, видача та оновлення токенів доступу, кілька гаманців на один акаунт, журнал входів.
- Перевірки. Негативні сценарії: підміна підпису, повтор одноразового повідомлення, прострочений строк, відкликаний доступ. Фіксуємо очікувану поведінку при кожній відмові та метрики успішних входів.
- Передача проєкту. Репозиторій і конфігурація, опис схеми, документація з підключення нового гаманця або мережі, інструкція для підтримки. Проводимо розбір із вашою командою.
До моменту передачі у вас робочий вхід, покритий перевірками, і документація, за якою команда розвиває його без нас. Опишіть задачу — повернемося з оцінкою та планом за цими етапами.
Склад постачання: схеми, політики доступу, регламенти
Після здачі у замовника залишається не лише робочий вхід через гаманець, а й повний набір артефактів, за якими систему можна розвивати й підтримувати без нас.
Нижче — те, що входить до постачання за замовчуванням; набір закриває шлях від першого входу користувача до дій чергової команди при збої.
- Схема потоків даних — як запит на підпис іде в Phantom, що повертається на бекенд, де перевіряється справжність і як видається сесія; окремо позначено точки, де дані не повинні покидати контур.
- Політики доступу — ролі, строк життя сесії, правила прив’язки гаманця до облікового запису й відкликання доступу при компрометації ключа.
- Схема ротації секретів і ключів — хто, у якому порядку і за якою ознакою змінює значення, щоб зміна не валила активні сесії.
- Регламент підтримки — типові звернення (не проходить підпис, не збігається адреса, минула сесія), кроки діагностики та межі, де підключаємося ми.
- Інструкції для чергової команди — де дивитися журнали, які ознаки вказують на спробу підміни підпису, що робити в перші хвилини.
- Конфігурація середовищ — тестовий і робочий контури розділені, значення винесені у змінні, секрети не лежать у репозиторії.
- Чек-ліст приймання — сценарії входу, повтору підпису, завершення сесії та відмови, з очікуваною поведінкою системи за кожним.
Схеми й політики оформлені так, щоб новий інженер у команді розібрався за ними без листування з авторами. Регламент підтримки узгодимо з вашим процесом чергувань — опишіть задачу, і ми повернемося з оцінкою та планом.
Кейс: як повернули вхід до особистого кабінету та прибрали збої
Що було до робіт
Клієнт прийшов із робочою, але нестабільною авторизацією через Phantom: підпис повідомлення перевірявся на стороні клієнта, а на сервер ішла готова ознака «підписав».
Будь-яка розсинхронізація гаманця — зміна акаунта, перемикання мережі, повторний підпис — залишала у сховищі висячу сесію. Користувачі з двома гаманцями входили з другого-третього разу, а підтримка розбирала десятки звернень на тиждень про «не пускає до кабінету».
Частка успішних входів із першої спроби трималася близько 68%, і кожен збій закривався вручну: інженер знаходив запис, завершував сесію й просив зайти знову. Відновлення доступу займало від півгодини — при тому, що кабінет був точкою входу до платного продукту.
Що зробили і що змінилося
Перевірку підпису перенесли на сервер, одноразовий запит на підпис прив’язали до домену, мережі та строку життя в кілька хвилин — повторне використання стало неможливим.
Зміну акаунта й мережі в гаманці почали обробляти явно: стара сесія відкликається до створення нової, тому висячих станів більше не залишається.
Після здачі частка входів із першої спроби зросла з 68% до 97%, звернення до підтримки щодо входу впали в шість разів, а відновлення доступу скоротилося до секунд — сесію тепер завершують штатною кнопкою, без участі інженера. Окремим етапом додали журнал подій входу: за кожною відмовою видно, на якому кроці вона сталася.
Чим вхід через Phantom відрізняється від входу поштою та паролем?
При вході через Phantom пароля немає взагалі. Сервер віддає одноразове повідомлення з випадковим значенням і коротким строком життя, гаманець підписує його приватним ключем, а сервер перевіряє підпис за публічною адресою і тільки потім видає сесію. Перехоплений підпис повторно не застосувати: значення діє один раз і обмежений час.
Ключі залишаються в користувача — приватний ключ і мнемонічна фраза не покидають його пристрій і не надходять до нас. Це змінює модель ризику.
При вході поштою та паролем ми зберігаємо хеш пароля, зобов’язані його захищати, обмежувати підбір і розсилати листи для скидання; у схемі з гаманцем зберігати нічого, і витік нашої бази не відкриває доступ до акаунтів.
Відновлення доступу теж переїжджає до користувача. Скинути його зі свого боку ми не можемо: у нас немає ні пароля, ні права підписати дію за клієнта — відновлення йде через мнемонічну фразу в самому гаманці.
Тому в проєкті з’являється прив’язка кількох адрес до одного акаунта й резервний спосіб входу як другий фактор — на випадок втрати пристрою.
У підтримці змінюється набір звернень: зникають «не надійшов лист» і «забув пароль», з’являються «перевстановив застосунок», «підписую з іншого пристрою», «втратив доступ до гаманця».
Такі сценарії закриваємо підказками в інтерфейсі заздалегідь — користувач має розуміти, що саме він підписує і яка адреса вважається основною.
Технічні сумніви: безпека, сесії, підтримка
Авторизація будується на підписі одноразового повідомлення: гаманець Phantom у мережі Solana підписує рядок з унікальним значенням і позначкою часу, сервер перевіряє підпис і видає сесійний токен.
Приватний ключ не покидає пристрій користувача й не потрапляє ні в логи, ні в базу — украсти з боку сервісу нічого. Перехоплений підпис повторно не застосувати: значення живе обмежений час і приймається один раз.
Строк життя токена доступу тримаємо коротким, оновлювального — помітно довшим: перший обмежує вікно компрометації, другий позбавляє від підпису на кожній дії.
При виході або зміні гаманця оновлення відкликається на сервері, тому викрадений токен перестає працювати одразу, а не доживає до кінця строку.
Міграція поточних користувачів іде без втрати прогресу: при першому вході акаунт пов’язується з наявним записом за підтвердженою ознакою, історія та ролі переносяться як є.
Один профіль можна прив’язати до кількох гаманців — додаткова адреса підтверджується окремим підписом, і власник заходить з будь-якого з них.
Що буде, якщо користувач втратить доступ до гаманця?
Заздалегідь прив’язаний другий гаманець або підтверджений резервний канал повертають доступ до того самого профілю — прогрес і ролі зберігаються.
Як сервер розуміє, що підпис видав власник, а не чужий сайт?
У повідомлення включаємо адресу гаманця, позначку часу й домен сервісу, перевірку робимо на сервері. Підпис, отриманий для іншого сайту або іншого запиту, не приймається.
Обговоримо задачу: що потрібно для старту робіт
Щоб повернутися з оцінкою та планом робіт, а не із загальними формулюваннями, нам потрібні вхідні дані щодо продукту й сценаріїв входу. Зазвичай це розмова на 20–30 хвилин із вашим продуктом і, якщо є можливість, з інженером, який веде серверну частину.
- Сценарій входу: тільки Phantom чи кілька гаманців мережі; чи потрібен вхід по email або телефону як рівноцінна альтернатива.
- Що вважається акаунтом: прив’язка гаманця до наявного профілю, окремий обліковий запис або кілька гаманців на одного користувача.
- Ролі й права: що доступно до входу, що відкривається після підтвердження володіння гаманцем і що потребує повторного підтвердження.
- Сесії: строк життя, чи потрібен автоматичний вихід, поведінка при зміні гаманця або перевстановленні розширення.
- Інфраструктура: де розміщена серверна частина, які бази й сховища вже є, чи є вимоги щодо хостингу й зберігання даних.
- Безпека та вимоги регуляторів: захист від повторного використання підпису, що потрапляє в логи, чи потрібна перевірка на підозрілу активність.
- Інтерфейс: макети екранів, текст повідомлення на підпис, місце кнопки входу в поточному інтерфейсі.
- Приймання: бажана дата старту проєкту, наявність тестового середовища, хто з вашого боку приймає результат.
Цього достатньо, щоб ми повернулися з оцінкою та планом робіт: етапи, залежності, зона відповідальності нашої команди й те, що потрібно буде з вашого боку. Опишіть задачу — повернемося з оцінкою та планом.







