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

Что делает ваше приложение

Вход через Veriqa: приложение отправляет браузер на страницу входа редиректом OpenID Connect, пользователь подтверждает в канале, Veriqa возвращает браузер с кодом, и приложение меняет его на токены.
Ничего, кроме обычного OpenID Connect:
Дальше — стандартный обмен кода на токены. Никакого клиентского SDK, виджета или JS-компонента Veriqa не требует: страницу входа с QR-кодом рисует сервер.

Что происходит у пользователя

  1. на экране появляется QR-код — это всё, что нужно для входа;
  2. пользователь открывает камеру телефона, сканирует код и переходит по ссылке;
  3. открывается привычное приложение — MAX, Telegram, WhatsApp или другой мессенджер (или письмо, если выбран канал Email);
  4. пользователь подтверждает вход кнопкой — без пароля и без кода из SMS;
  5. Veriqa выпускает токены, вход завершён.
Вход на компьютере через MAX: в окне входа QR-код, камера телефона его сканирует, пользователь нажимает «Подтвердить» в чате MAX, бот отвечает «Вход подтверждён».

Те же шаги при входе через MAX.

Первый вход и все последующие выглядят для пользователя одинаково. Разница только на вашей стороне: если sub встречается впервые, вы заводите учётную запись, если нет — узнаёте существующую.

Что приезжает в claims

sub — стабильный идентификатор субъекта, по нему вы узнаёте вернувшегося пользователя. При scope=profile добавляются человекочитаемое имя и связанные с ним поля; состав зависит от канала.
Адрес почты приходит не от каждого канала. Telegram адреса не отдаёт и не отдаст — учётная запись создаётся без него. Если адрес обязателен, используйте канал Email или спросите адрес отдельным шагом после первого входа. Как с этим справляются готовые CMS — в разделе Veriqa в CMS.

Если у пользователя нет мессенджера на этом устройстве

Так и задумано: подтверждение происходит на другом устройстве, на телефоне. Мессенджер не обязан быть установлен там, откуда пользователь входит — именно этим сценарий отличается от встроенных кнопок входа мессенджеров, где приложение и мессенджер должны быть на одной машине. Вход на том же устройстве тоже поддерживается, но это запасной путь.
Вход на телефоне: пользователь нажимает «Войти через MAX», подтверждает вход в чате MAX, бот отвечает «Вход подтверждён».

Вход на том же устройстве: кнопка канала на телефоне, затем одно касание в MAX.

Посмотреть вживую. Войдите своим мессенджером в Helio — онлайн-пример сайта поддержки — или в Nova Stream, стриминговый сервис на телевизоре. Ставить ничего не нужно.

Дальше

Привязка канала

Тем же действием получить живой канал для уведомлений.

Полный поток OIDC

Что происходит между authorize и token.