Розробка авторизації через Phantom (Solana) під ключ

Користувачі кидають реєстрацію, коли вхід до особистого кабінету вимагає пароля та листа з підтвердженням. Ми розробляємо авторизацію через Phantom на Solana під ключ: підключення гаманця, сесії, політики доступу та регламенти підтримки. Скорочуємо шлях до входу до одного підтвердження та прибираємо збої на піковому навантаженні.
Часті запитання

Авторизація через Phantom на Solana: де ламається вхід

Авторизація через Phantom на Solana виглядає як три кроки: гаманець підписує рядок, сервер перевіряє підпис, користувач потрапляє до особистого кабінету.

На практиці вхід через криптогаманець ламається щонайменше в чотирьох місцях, і кожне дає свій клас відмов — від мовчазного «не пускає» до чужого профілю на екрані.

Перше — довіра до даних, що надійшли з боку користувача. Якщо підпис підтвердження перевіряє клієнт, а сервер отримує вже готовий вердикт, такий запит збирається вручну в консолі браузера.

Перевірка має жити на сервері, спиратися на публічний ключ і на одноразовий запит, який цей самий сервер видав і запам’ятав.

Друге — строк життя підписаного запиту. Довгий перетворює підпис на багаторазову перепустку, короткий дає гонку: користувач підтверджує вхід, а запит уже прострочено. Звідси втрата сесії рівно в момент входу й повторні натискання «підключити гаманець» без результату.

Третє — невідповідність мережі та розсинхронізація стану гаманця. Адреса, підписана в тестовому контурі, не повинна прийматися в робочому; зміна акаунта без переприв’язки відкриває чужий профіль.

Розбираємо, як закрити кожну точку — щоб збої входу до особистого кабінету перестали бути нормою, а сесія переживала оновлення сторінки та зміну пристрою.

Що змінюється після впровадження: швидкість входу та відмова від паролів

Парольний вхід — це ланцюжок: введення адреси пошти, очікування листа з кодом, введення пароля, другий фактор, повтор при одруківці. Після підключення авторизації через Phantom залишається одна дія — підтвердження в гаманці.

П’ять кроків згортаються в один, і людина потрапляє до особистого кабінету за секунди, а не за хвилини очікування листа.

Стійкість входу зростає не через «зручність», а тому, що зникають цілі класи відмов. Немає пароля — немає чого забути й немає чого скидати; немає листа з кодом — немає залежності від доставки пошти та спам-фільтрів.

Частка невдалих спроб входу падає в рази: залишаються тільки відмова користувача в гаманці та втрата доступу до самого гаманця.

Для сервісу це знімає навантаження з підтримки: звернення «не надходить лист», «скинув пароль, але не пускає», «ввів пошту з одруком» зникають із потоку — залишаються рідкісні випадки відновлення доступу до гаманця.

Водночас зменшується поверхня ризику: сервіс не зберігає й не перевіряє паролі, йому достатньо переконатися, що підпис відповідає заявленій адресі.

Ми залишаємо поштовий вхід резервним шляхом і вмикаємо новий поступово, щоб частка успішних входів не просідала на жодному етапі. Нижче — що саме робимо і в якому порядку.

Способи підключення гаманця: порівняння варіантів

Підключення гаманця й авторизація — не одне й те саме. Публічна адреса, яку віддає гаманець, нічого не доводить: її можна вписати вручну й побачити чужий баланс. Володіння ключем підтверджує тільки підпис, і від вибраного режиму залежить, що саме зможе перевірити сервер.

Другий фактор вибору — середовище, де відкрито продукт. У настільному браузері з’єднання з Phantom встановлюється через розширення й живе до відкликання дозволу, а в мобільному браузері розширення немає — вхід будується на поверненні з застосунку гаманця. Нижче варіанти, між якими реально обирають.

Спосіб входу Коли підходить Обмеження методу
Розширення в браузері Настільний веб, користувач ставить розширення Недоступне на мобільних; сесія розривається при відкликанні дозволу
Повернення з застосунку гаманця за посиланням Мобільний веб без розширення Потрібен обробник повернення й відновлення контексту сторінки
Набір адаптерів під кілька гаманців Не можна вимагати один конкретний гаманець Дорожче в підтримці: в адаптерів різний набір методів підпису
Підпис повідомлення з одноразовим кодом Повноцінна авторизація з прив’язкою до акаунта Потрібно зберігати й гасити коди, інакше підпис відтворюваний
Тільки публічна адреса без підпису Вітрини, перегляд балансу, аналітика Не підтверджує володіння ключем — як авторизація не годиться

Розділення режимів важливе й для відкатів: відкликання дозволу в розширенні розриває сесію, а вже виданий серверний код не можна використати повторно, якщо він гаситься після перевірки.

Тому строк життя коду й правило повторної видачі ми фіксуємо в конфігурації, а не залишаємо на розсуд клієнта.

Етапи впровадження: від розбору задачі до передачі

Порядок робіт майже не залежить від того, що дає вхід через Phantom — платіжний кабінет, доступ до токенів чи закритий розділ. Змінюються вхідні дані та спосіб зв’язку гаманця з акаунтом. Нижче — послідовність етапів і артефакт на виході кожного.

  1. Розбір сценаріїв входу. Які ролі входять, з яких пристроїв — розширення в браузері, мобільний гаманець, вхід за кодом, — і що бачить користувач без гаманця. На виході узгоджений перелік сценаріїв із пріоритетами.
  2. Схема авторизації. Як формується одноразове повідомлення, де зберігається, скільки живе, що вважається успішним входом. Отримуєте схему з точками відмов і рішенням, як гаманець пов’язується з акаунтом.
  3. Налаштування перевірки підпису. Серверна перевірка підпису й публічного ключа, захист від повторного використання повідомлення, прив’язка й відв’язка гаманця. Тут найчастіше спливають помилки, які потім дорого лагодити.
  4. Вбудовування в систему. Сесії, ролі й права, видача та оновлення токенів доступу, кілька гаманців на один акаунт, журнал входів.
  5. Перевірки. Негативні сценарії: підміна підпису, повтор одноразового повідомлення, прострочений строк, відкликаний доступ. Фіксуємо очікувану поведінку при кожній відмові та метрики успішних входів.
  6. Передача проєкту. Репозиторій і конфігурація, опис схеми, документація з підключення нового гаманця або мережі, інструкція для підтримки. Проводимо розбір із вашою командою.

До моменту передачі у вас робочий вхід, покритий перевірками, і документація, за якою команда розвиває його без нас. Опишіть задачу — повернемося з оцінкою та планом за цими етапами.

Склад постачання: схеми, політики доступу, регламенти

Після здачі у замовника залишається не лише робочий вхід через гаманець, а й повний набір артефактів, за якими систему можна розвивати й підтримувати без нас.

Нижче — те, що входить до постачання за замовчуванням; набір закриває шлях від першого входу користувача до дій чергової команди при збої.

  • Схема потоків даних — як запит на підпис іде в Phantom, що повертається на бекенд, де перевіряється справжність і як видається сесія; окремо позначено точки, де дані не повинні покидати контур.
  • Політики доступу — ролі, строк життя сесії, правила прив’язки гаманця до облікового запису й відкликання доступу при компрометації ключа.
  • Схема ротації секретів і ключів — хто, у якому порядку і за якою ознакою змінює значення, щоб зміна не валила активні сесії.
  • Регламент підтримки — типові звернення (не проходить підпис, не збігається адреса, минула сесія), кроки діагностики та межі, де підключаємося ми.
  • Інструкції для чергової команди — де дивитися журнали, які ознаки вказують на спробу підміни підпису, що робити в перші хвилини.
  • Конфігурація середовищ — тестовий і робочий контури розділені, значення винесені у змінні, секрети не лежать у репозиторії.
  • Чек-ліст приймання — сценарії входу, повтору підпису, завершення сесії та відмови, з очікуваною поведінкою системи за кожним.

Схеми й політики оформлені так, щоб новий інженер у команді розібрався за ними без листування з авторами. Регламент підтримки узгодимо з вашим процесом чергувань — опишіть задачу, і ми повернемося з оцінкою та планом.

Кейс: як повернули вхід до особистого кабінету та прибрали збої

Що було до робіт

Клієнт прийшов із робочою, але нестабільною авторизацією через Phantom: підпис повідомлення перевірявся на стороні клієнта, а на сервер ішла готова ознака «підписав».

Будь-яка розсинхронізація гаманця — зміна акаунта, перемикання мережі, повторний підпис — залишала у сховищі висячу сесію. Користувачі з двома гаманцями входили з другого-третього разу, а підтримка розбирала десятки звернень на тиждень про «не пускає до кабінету».

Частка успішних входів із першої спроби трималася близько 68%, і кожен збій закривався вручну: інженер знаходив запис, завершував сесію й просив зайти знову. Відновлення доступу займало від півгодини — при тому, що кабінет був точкою входу до платного продукту.

Що зробили і що змінилося

Перевірку підпису перенесли на сервер, одноразовий запит на підпис прив’язали до домену, мережі та строку життя в кілька хвилин — повторне використання стало неможливим.

Зміну акаунта й мережі в гаманці почали обробляти явно: стара сесія відкликається до створення нової, тому висячих станів більше не залишається.

Після здачі частка входів із першої спроби зросла з 68% до 97%, звернення до підтримки щодо входу впали в шість разів, а відновлення доступу скоротилося до секунд — сесію тепер завершують штатною кнопкою, без участі інженера. Окремим етапом додали журнал подій входу: за кожною відмовою видно, на якому кроці вона сталася.

Чим вхід через Phantom відрізняється від входу поштою та паролем?

При вході через Phantom пароля немає взагалі. Сервер віддає одноразове повідомлення з випадковим значенням і коротким строком життя, гаманець підписує його приватним ключем, а сервер перевіряє підпис за публічною адресою і тільки потім видає сесію. Перехоплений підпис повторно не застосувати: значення діє один раз і обмежений час.

Ключі залишаються в користувача — приватний ключ і мнемонічна фраза не покидають його пристрій і не надходять до нас. Це змінює модель ризику.

При вході поштою та паролем ми зберігаємо хеш пароля, зобов’язані його захищати, обмежувати підбір і розсилати листи для скидання; у схемі з гаманцем зберігати нічого, і витік нашої бази не відкриває доступ до акаунтів.

Відновлення доступу теж переїжджає до користувача. Скинути його зі свого боку ми не можемо: у нас немає ні пароля, ні права підписати дію за клієнта — відновлення йде через мнемонічну фразу в самому гаманці.

Тому в проєкті з’являється прив’язка кількох адрес до одного акаунта й резервний спосіб входу як другий фактор — на випадок втрати пристрою.

У підтримці змінюється набір звернень: зникають «не надійшов лист» і «забув пароль», з’являються «перевстановив застосунок», «підписую з іншого пристрою», «втратив доступ до гаманця».

Такі сценарії закриваємо підказками в інтерфейсі заздалегідь — користувач має розуміти, що саме він підписує і яка адреса вважається основною.

Технічні сумніви: безпека, сесії, підтримка

Авторизація будується на підписі одноразового повідомлення: гаманець Phantom у мережі Solana підписує рядок з унікальним значенням і позначкою часу, сервер перевіряє підпис і видає сесійний токен.

Приватний ключ не покидає пристрій користувача й не потрапляє ні в логи, ні в базу — украсти з боку сервісу нічого. Перехоплений підпис повторно не застосувати: значення живе обмежений час і приймається один раз.

Строк життя токена доступу тримаємо коротким, оновлювального — помітно довшим: перший обмежує вікно компрометації, другий позбавляє від підпису на кожній дії.

При виході або зміні гаманця оновлення відкликається на сервері, тому викрадений токен перестає працювати одразу, а не доживає до кінця строку.

Міграція поточних користувачів іде без втрати прогресу: при першому вході акаунт пов’язується з наявним записом за підтвердженою ознакою, історія та ролі переносяться як є.

Один профіль можна прив’язати до кількох гаманців — додаткова адреса підтверджується окремим підписом, і власник заходить з будь-якого з них.

Що буде, якщо користувач втратить доступ до гаманця?

Заздалегідь прив’язаний другий гаманець або підтверджений резервний канал повертають доступ до того самого профілю — прогрес і ролі зберігаються.

Як сервер розуміє, що підпис видав власник, а не чужий сайт?

У повідомлення включаємо адресу гаманця, позначку часу й домен сервісу, перевірку робимо на сервері. Підпис, отриманий для іншого сайту або іншого запиту, не приймається.

Обговоримо задачу: що потрібно для старту робіт

Щоб повернутися з оцінкою та планом робіт, а не із загальними формулюваннями, нам потрібні вхідні дані щодо продукту й сценаріїв входу. Зазвичай це розмова на 20–30 хвилин із вашим продуктом і, якщо є можливість, з інженером, який веде серверну частину.

  • Сценарій входу: тільки Phantom чи кілька гаманців мережі; чи потрібен вхід по email або телефону як рівноцінна альтернатива.
  • Що вважається акаунтом: прив’язка гаманця до наявного профілю, окремий обліковий запис або кілька гаманців на одного користувача.
  • Ролі й права: що доступно до входу, що відкривається після підтвердження володіння гаманцем і що потребує повторного підтвердження.
  • Сесії: строк життя, чи потрібен автоматичний вихід, поведінка при зміні гаманця або перевстановленні розширення.
  • Інфраструктура: де розміщена серверна частина, які бази й сховища вже є, чи є вимоги щодо хостингу й зберігання даних.
  • Безпека та вимоги регуляторів: захист від повторного використання підпису, що потрапляє в логи, чи потрібна перевірка на підозрілу активність.
  • Інтерфейс: макети екранів, текст повідомлення на підпис, місце кнопки входу в поточному інтерфейсі.
  • Приймання: бажана дата старту проєкту, наявність тестового середовища, хто з вашого боку приймає результат.

Цього достатньо, щоб ми повернулися з оцінкою та планом робіт: етапи, залежності, зона відповідальності нашої команди й те, що потрібно буде з вашого боку. Опишіть задачу — повернемося з оцінкою та планом.

Напрямки блокчейн-розробки

Останні роботи

  • Розробка сайту компанії B2B ADVANCE
    Розробка сайту компанії B2B ADVANCE
    1574
  • Розробка веб-додатків для компанії FEEDME
    Розробка веб-додатків для компанії FEEDME
    1427
  • Розробка веб-сайту для компанії БЕЛФІНГРУП
    Розробка веб-сайту для компанії БЕЛФІНГРУП
    1105
  • Розробка інтернет магазину для компанії FURNORO
    Розробка інтернет магазину для компанії FURNORO
    1421
  • Розробка логотипу компанії B2B Advance
    Розробка логотипу компанії B2B Advance
    858
  • Розробка веб-додатків для компанії Enviok
    Розробка веб-додатків для компанії Enviok
    1181