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

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

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

Цифровая идентификацияСредний~2-3 дня
Часто задаваемые вопросы

Авторизация через 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